Çalışma zamanında form bölgesine erişme

Makale
09/27/2022
Okumak için 3 dakika

Şunlar için geçerlidir:Visual Studio Mac için Visual Studio Visual Studio Code

Şunlara uygulanır
Bu konunun içerdiği bilgiler, yalnızca Microsoft Office'in aşağıdaki proje türleri ve sürümleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulama ve proje türüne göre kullanılabilen özellikler. Project türü - VSTO Eklenti projeleri Microsoft Office sürümü - Outlook 2010

Globals Outlook projenizin herhangi bir yerinden form bölgelerine erişmek için sınıfını kullanın. Sınıfı hakkında Globals daha fazla bilgi için bkz. Office projelerindeki nesnelere genel erişim.

Şunlar için geçerlidir: Bu konudaki bilgiler Outlook için VSTO Eklenti projeleri için geçerlidir. Daha fazla bilgi için bkz. Office uygulama ve proje türüne göre kullanılabilen özellikler.

Belirli bir Outlook Denetçisi penceresinde görünen form bölgelerine erişme

Belirli bir Outlook Denetçisinde görünen tüm form bölgelerine erişmek için sınıfının özelliğini Globals çağırın FormRegions ve Inspector'ı temsil eden bir Inspector nesne geçirin.

Aşağıdaki örnek, şu anda odaklanmış olan Denetçi'de görünen form bölgelerinin koleksiyonunu alır. Bu örnek daha sonra adlı formRegion1 koleksiyondaki bir form bölgesine erişir ve metin kutusunda görünen metni olarak Hello Worldayarlar.

private void Access_Form_Regions_ByInspector()
{
    WindowFormRegionCollection formRegions = 
        Globals.FormRegions
            [Globals.ThisAddIn.Application.ActiveInspector()];
    formRegions.FormRegion1.textBox1.Text = "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

Belirli bir Outlook Gezgini penceresinde görünen form bölgelerine erişme

Belirli bir Outlook Gezgini'nde görünen tüm form bölgelerine erişmek için sınıfının özelliğini Globals çağırın FormRegions ve Explorer'ı temsil eden bir Explorer nesne geçirin.

Aşağıdaki örnek, şu anda odakta olan Gezgin'de görünen form bölgelerinin koleksiyonunu alır. Bu örnek daha sonra adlı formRegion1 koleksiyondaki bir form bölgesine erişir ve metin kutusunda görünen metni olarak Hello Worldayarlar.

private void Access_Form_Regions_ByExplorer()
{
    WindowFormRegionCollection formRegions =
        Globals.FormRegions
            [Globals.ThisAddIn.Application.ActiveExplorer()];
    formRegions.FormRegion1.textBox1.Text = "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

Tüm form bölgelerine erişme

Tüm Explorer'larda ve tüm Denetçilerde görünen tüm form bölgelerine erişmek için sınıfının özelliğini çağırın FormRegionsGlobals .

Aşağıdaki örnek, tüm Explorer'larda ve tüm Denetçilerde görünen form bölgelerinin koleksiyonunu alır. Bu örnek daha sonra adlı formRegion1 bir form bölgesine erişir ve metin kutusunda görüntülenen metni olarak Hello Worldayarlar.

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";
        }
    }

}

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

Form bölgesindeki erişim denetimleri

sınıfını Globals kullanarak form bölgesindeki denetimlere erişmek için, denetimleri form bölgesi kod dosyasının dışındaki kodlar için erişilebilir hale getirmeniz gerekir.

Form bölgesi tasarımcısında tasarlanan form bölgeleri

C# için, erişmek istediğiniz her denetimin değiştiricisini değiştirin. Bunu yapmak için, form bölgesi tasarımcısındaki her denetimi seçin ve Özellikler penceresinde Değiştiriciler özelliğini İç veya genel olarak değiştirin. Örneğin, Değiştirici özelliğini textBox1İç olarak değiştirirseniz, yazarak Globals.FormRegions.FormRegion1.textBox1erişebilirsiniztextBox1.

Visual Basic için değiştiriciyi değiştirmeniz gerekmez.

İçeri aktarılan form bölgeleri

Outlook olarak tasarlanmış bir form bölgesini içeri aktardığınızda, form bölgesindeki her denetimin erişim değiştiricisi özel hale gelir. İçeri aktarılan form bölgesini değiştirmek için form bölgesi tasarımcısını kullanamadığınız için , Özellikler penceresinde denetimin değiştiricisini değiştirmenin bir yolu yoktur.

Form bölgesi kod dosyasının dışından bir denetime erişimi etkinleştirmek için, bu denetimi döndürmek için form bölgesi kod dosyasında bir özellik oluşturun.

C# dilinde özellik oluşturma hakkında daha fazla bilgi için bkz . Nasıl yapılır: Okuma yazma özelliklerini bildirme ve kullanma (C# programlama kılavuzu).

Visual Basic özellikleri oluşturma hakkında daha fazla bilgi için bkz. Nasıl yapılır: Özellik oluşturma (Visual Basic).