Accesso a un'area del modulo in fase di esecuzione

Si applica a
Le informazioni contenute in questo argomento si applicano solo ai tipi di progetto e versioni seguenti di Microsoft Office.Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office. Tipo di progetto Progetti a livello di applicazione Versione Microsoft Office Outlook 2010

Utilizzare la classe Globals per accedere alle aree del form da qualsiasi punto del progetto Outlook.Per ulteriori informazioni sulla classe Globals, vedere Accesso globale a oggetti nei progetti di Office.

Si applica a: le informazioni fornite in questo argomento sono valide per i progetti a livello di applicazione per Outlook 2013 e Outlook 2010. Per ulteriori informazioni, vedere Funzionalità disponibili in base ai tipi di progetto e applicazioni di Office.

Accesso alle aree del modulo visualizzate in una specifica finestra di controllo Outlook

Per accedere a tutte le aree del modulo visualizzate in uno specifico controllo Outlook, chiamare la proprietà FormRegions della classe Globals e passare un oggetto Inspector che rappresenta il controllo.

Nell'esempio riportato di seguito viene recuperata la raccolta di aree del modulo visualizzate nel controllo che ha attualmente lo stato attivo.Viene quindi effettuato l'accesso a un'area del modulo della raccolta denominata formRegion1 e il testo visualizzato in una casella di testo viene impostato su Hello World.

    Private Sub Access_Form_Regions_ByInspector()
        Dim formRegions As WindowFormRegionCollection = Globals.FormRegions _
            (Globals.ThisAddIn.Application.ActiveInspector())
        formRegions.FormRegion1.textBox1.Text = "Hello World"
    End Sub

private void Access_Form_Regions_ByInspector()
{
    WindowFormRegionCollection formRegions = 
        Globals.FormRegions
            [Globals.ThisAddIn.Application.ActiveInspector()];
    formRegions.FormRegion1.textBox1.Text = "Hello World";
}

Accesso alle aree del modulo visualizzate in una specifica finestra di esplorazione Outlook

Per accedere a tutte le aree del modulo visualizzate in una specifica finestra di esplorazione Outlook, chiamare la proprietà FormRegions della classe Globals e passare un oggetto Explorer che rappresenta la finestra di esplorazione.

Nell'esempio riportato di seguito viene recuperata la raccolta di aree del modulo visualizzate nella finestra di esplorazione che ha attualmente lo stato attivo.Viene quindi effettuato l'accesso a un'area del modulo della raccolta denominata formRegion1 e il testo visualizzato in una casella di testo viene impostato su Hello World.

Private Sub Access_Form_Regions_ByExplorer()
    Dim formRegions As WindowFormRegionCollection = Globals.FormRegions _
        (Globals.ThisAddIn.Application.ActiveExplorer())
    formRegions.FormRegion1.textBox1.Text = "Hello World"
End Sub

private void Access_Form_Regions_ByExplorer()
{
    WindowFormRegionCollection formRegions =
        Globals.FormRegions
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    formRegions.FormRegion1.textBox1.Text = "Hello World";
}

Accesso a tutte le aree del modulo

Per accedere a tutte le aree del modulo visualizzate in tutte le finestre di esplorazione e in tutti i controlli, chiamare la proprietà FormRegions della classe Globals.

Nell'esempio riportato di seguito viene recuperata la raccolta di aree del modulo visualizzate in tutte le finestre di esplorazione e in tutti i controlli.Viene quindi effettuato l'accesso a un'area del modulo denominata formRegion1 e il testo visualizzato in una casella di testo viene impostato su Hello World.

Friend Sub Access_All_Form_Regions()
    Dim formRegion As Microsoft.Office.Tools.Outlook.IFormRegion
    For Each formRegion In Globals.FormRegions
        If TypeOf formRegion Is FormRegion1 Then
            Dim formRegion1 As FormRegion1 = _
                CType(formRegion, FormRegion1)
            formRegion1.textBox1.Text = "Hello World"
        End If
    Next formRegion
End Sub

internal void Access_All_Form_Regions()
{
    foreach (Microsoft.Office.Tools.Outlook.IFormRegion formRegion 
        in Globals.FormRegions)
    {
        if (formRegion is FormRegion1)
        {
            FormRegion1 formRegion1 = (FormRegion1)formRegion;
            formRegion1.textBox1.Text = "Hello World";
        }
    }

}

Accesso ai controlli presenti in un'area del modulo

Per accedere ai controlli presenti in un'area del modulo utilizzando la classe Globals, è necessario rendere tali controlli accessibili al codice dall'esterno del file di codice dell'area del modulo.

Aree del modulo progettate nella finestra di progettazione dell'area del modulo

Per C# cambiare il modificatore di ogni controllo a cui si desidera accedere.Per eseguire questa operazione, selezionare ogni controllo nella finestra di progettazione dell'area del modulo e impostare la proprietà Modificatori su interna o pubblica nella finestra Proprietà.Ad esempio, se si imposta la proprietà Modificatore di textBox1 su interna, è possibile accedere a textBox1 digitando Globals.FormRegions.FormRegion1.textBox1.

Per Visual Basic non è necessario cambiare il modificatore.

Aree del modulo importate

Quando si importa un'area del modulo progettata in Outlook, il modificatore di accesso di ogni controllo presente nell'area del modulo diventa privato.Poiché non è possibile utilizzare la finestra di progettazione dell'area del modulo per modificare un'area del modulo importata, non esiste alcun modo per cambiare il modificatore di un controllo nella finestra Proprietà.

Per consentire l'accesso a un controllo dall'esterno del file di codice dell'area del modulo, creare una proprietà in tale file di codice per la restituzione del controllo.

Per ulteriori informazioni su come creare proprietà in C#, vedere Procedura: dichiarare e utilizzare proprietà Read/Write (Guida per programmatori C#).

Per ulteriori informazioni su come creare proprietà in Visual Basic, vedere How to: Add Fields and Properties to a Class.

Vedere anche

Attività

Procedura dettagliata: progettazione di un'area del modulo di Outlook

Procedura: aggiungere un'area del modulo a un progetto di componente aggiuntivo per Outlook

Procedura dettagliata: importazione di un'area di modulo progettata in Outlook

Procedura: impedire la visualizzazione di un'area del modulo in Outlook

Concetti

Linee guida per la creazione delle aree di modulo di Outlook

Azioni personalizzate nelle aree di modulo di Outlook

Associazione di un'area del modulo a una classe messaggio di Outlook

Accesso alla barra multifunzione in fase di esecuzione

Altre risorse

Creazione di aree di modulo di Outlook