런타임에 양식 영역 액세스

아티클
08/10/2011

적용 대상
이 항목의 정보는 다음 프로젝트 형식 및 Microsoft Office 버전에만 적용됩니다. 자세한 내용은 Office 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오. 프로젝트 형식 응용 프로그램 수준 프로젝트 Microsoft Office 버전 Outlook 2007 Outlook 2010

이 항목의 정보는 다음 프로젝트 형식 및 Microsoft Office 버전에만 적용됩니다. 자세한 내용은 Office 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오.

프로젝트 형식

응용 프로그램 수준 프로젝트

Microsoft Office 버전

Outlook 2007
Outlook 2010

Globals 클래스를 사용하면 Outlook 프로젝트 내의 어느 위치에서나 양식 영역에 액세스할 수 있습니다. Globals 클래스에 대한 자세한 내용은 Office 프로젝트의 개체에 전역 액세스를 참조하십시오.

적용 대상: 이 항목의 정보는 Outlook 2007 및 Outlook 2010의 응용 프로그램 수준 프로젝트에 적용됩니다. 자세한 내용은 Office 응용 프로그램 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하십시오.

특정 Outlook 검사기 창에 나타나는 양식 영역 액세스

특정 Outlook 검사기에 나타나는 모든 양식 영역에 액세스하려면 Globals 클래스의 FormRegions 속성을 호출하고 검사기를 나타내는 Inspector 개체를 전달합니다.

다음 예제에서는 현재 포커스가 있는 검사기에 나타나는 양식 영역의 컬렉션을 가져옵니다. 그런 다음 formRegion1이라는 컬렉션의 양식 영역에 액세스하고 텍스트 상자에 나타나는 텍스트를 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";
}

특정 Outlook 탐색기 창에 나타나는 양식 영역 액세스

특정 Outlook 탐색기에 나타나는 모든 양식 영역에 액세스하려면 Globals 클래스의 FormRegions 속성을 호출하고 탐색기를 나타내는 Explorer 개체를 전달합니다.

다음 예제에서는 현재 포커스가 있는 탐색기에 나타나는 양식 영역의 컬렉션을 가져옵니다. 그런 다음 formRegion1이라는 컬렉션의 양식 영역에 액세스하고 텍스트 상자에 나타나는 텍스트를 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";
}

모든 양식 영역 액세스

모든 탐색기 및 검사기에 나타나는 모든 양식 영역에 액세스하려면 Globals 클래스의 FormRegions 속성을 호출합니다.

다음 예제에서는 모든 탐색기 및 검사기에 나타나는 양식 영역의 컬렉션을 가져옵니다. 그런 다음 formRegion1이라는 양식 영역에 액세스하고 텍스트 상자에 나타나는 텍스트를 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";
        }
    }

}

양식 영역의 컨트롤 액세스

Globals 클래스를 사용하여 양식 영역의 컨트롤에 액세스하려면 양식 영역 코드 파일 외부의 코드에서 해당 컨트롤에 액세스할 수 있도록 해야 합니다.

양식 영역 디자이너에서 디자인된 양식 영역

C#의 경우 액세스할 각 컨트롤의 한정자를 변경합니다. 이렇게 하려면 양식 영역 디자이너의 각 컨트롤을 선택하고 속성 창에서 Modifiers 속성을 Internal 또는 public으로 변경합니다. 예를 들어 textBox1의 Modifier 속성을 Internal로 변경하면 Globals.FormRegions.FormRegion1.textBox1을 입력하여 textBox1에 액세스할 수 있습니다.

Visual Basic의 경우에는 한정자를 변경할 필요가 없습니다.

가져온 양식 영역

Outlook에서 디자인된 양식 영역을 가져오는 경우 양식 영역에 있는 각 컨트롤의 액세스 한정자가 private로 설정됩니다. 양식 영역 디자이너에서는 가져온 양식 영역을 수정할 수 없으므로 속성 창에서 컨트롤의 한정자를 변경할 수 없습니다.

양식 영역 코드 파일 외부에서 컨트롤에 액세스할 수 있도록 하려면 양식 영역 코드 파일에서 해당 컨트롤을 반환하는 속성을 만듭니다.

C#에서 속성을 만드는 방법에 대한 자세한 내용은 방법: 읽기/쓰기 속성 선언 및 사용(C# 프로그래밍 가이드)을 참조하십시오.

Visual Basic에서 속성을 만드는 방법에 대한 자세한 내용은 How to: Add Fields and Properties to a Class를 참조하십시오.

참고 항목

다음을 통해 공유