연습: Outlook 양식 영역 디자인

아티클
06/19/2023

사용자 지정 양식 영역은 표준 또는 사용자 지정 Microsoft Office Outlook 양식을 확장합니다. 이 연습에서는 연락처 항목의 검사기 창에 새 페이지로 표시되는 사용자 지정 양식 영역을 디자인합니다. 이 양식 영역은 Windows Live 로컬 검색 웹 사이트에 주소 정보를 전송하여 연락처에 대해 나열된 각 주소의 지도를 표시합니다. 양식 영역에 대한 자세한 내용은 Outlook 양식 영역 만들기를 참조하세요.

적용 대상: 이 항목의 정보는 Outlook의 VSTO 추가 기능 프로젝트에 적용됩니다. 자세한 내용은 Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.

이 연습에서는 다음 작업을 수행합니다.

새 Outlook VSTO 추가 기능 프로젝트 만들기
VSTO 추가 기능 프로젝트에 양식 영역 추가
양식 영역의 레이아웃 디자인
양식 영역의 동작 사용자 지정
Outlook 양식 영역 테스트

참고 항목

일부 Visual Studio 사용자 인터페이스 요소의 경우 다음 지침에 설명된 것과 다른 이름 또는 위치가 시스템에 표시될 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 Visual Studio IDE 개인 설정을 참조하세요.

필수 조건

이 연습을 완료하려면 다음과 같은 구성 요소가 필요합니다.

Microsoft Office 개발자 도구를 포함하는 Visual Studio 버전입니다. 자세한 내용은 Office 솔루션을 개발하기 위한 컴퓨터 구성을 참조하세요.
Outlook 2010 이상

link to video 이 항목의 비디오 버전은 비디오 방법: Outlook 양식 영역 디자인을 참조 하세요.

새 Outlook VSTO 추가 기능 프로젝트 만들기

먼저 기본 VSTO 추가 기능 프로젝트를 만듭니다.

새 Outlook VSTO 추가 기능 프로젝트를 만들려면

Visual Studio에서 이름이 MapItAddIn인 Outlook VSTO 추가 기능 프로젝트를 만듭니다.
새 프로젝트 대화 상자에서 솔루션용 디렉터리 만들기를 선택합니다.
임의 디렉터리에 프로젝트를 저장합니다.

자세한 내용은 방법: Visual Studio에서 Office 프로젝트 만들기를 참조하세요.

Outlook VSTO 추가 기능 프로젝트에 양식 영역 추가

Outlook VSTO 추가 기능 솔루션에는 하나 이상의 Outlook 양식 영역 항목이 포함될 수 있습니다. 새 Outlook 양식 영역 마법사를 사용하여 프로젝트에 양식 영역 항목을 추가합니다.

Outlook VSTO 추가 기능 프로젝트에 양식 영역을 추가하려면

솔루션 탐색기에서 MapItAddIn 프로젝트를 선택합니다.
프로젝트 메뉴에서 새 항목 추가를 클릭합니다.
새 항목 추가 대화 상자에서 Outlook 양식 영역을 선택하고 파일 이름을 MapIt로 지정한 다음, 추가를 클릭합니다.

NewOutlook 양식 영역 마법사가 시작됩니다.
양식 영역을 만드는 방법 선택 페이지에서 새 양식 영역 디자인을 클릭한 후 다음을 클릭합니다.
만들 양식 영역 형식 선택 페이지에서 별도를 클릭한 후 다음을 클릭합니다.

별도 양식 영역은 Outlook 양식에 새 페이지를 추가합니다. 양식 영역 형식에 대한 자세한 내용은 Outlook 양식 영역 만들기를 참조하세요.
설명 텍스트 제공 및 디스플레이 기본 설정 선택 페이지의 이름 상자에 매핑을 입력합니다.

이 이름은 연락처 항목이 열려 있을 때 검사기 창의 리본 메뉴에 나타납니다.
작성 모드의 검사기 및 읽기 모드의 검사기를 선택한 다음, 다음을 클릭합니다.
이 양식 영역을 표시할 메시지 클래스 지정 페이지에서 메일 메시지를 선택 취소하고 연락처를 선택한 다음, 마침을 클릭합니다.

MapIt.cs 또는 MapIt.vb 파일이 프로젝트에 추가됩니다.

양식 영역의 레이아웃 디자인

양식 영역 디자이너를 사용하여 시각적으로 양식 영역을 개발합니다. 관리되는 컨트롤을 양식 영역 디자이너 화면으로 끌 수 있습니다. 디자이너 및 속성 창을 사용하여 컨트롤 레이아웃 및 모양을 조정합니다.

양식 영역의 레이아웃을 디자인하려면

솔루션 탐색기에서 MapItAddIn 프로젝트를 확장한 다음, MapIt.cs 또는 MapIt.vb를 두 번 클릭하여 양식 영역 디자이너를 엽니다.
디자이너를 마우스 오른쪽 단추로 클릭한 다음, 속성을 클릭합니다.
속성 창에서 크기를 664, 469로 설정합니다.

이렇게 하면 양식 영역이 지도를 표시할 수 있을 만큼 커집니다.
보기 메뉴에서 도구 상자를 클릭합니다.
도구 상자의 공용 컨트롤 탭에서 WebBrowser를 양식 영역에 추가합니다.

연락처에 대해 나열된 각 주소의 맵이 WebBrowser에 표시됩니다.

양식 영역의 동작 사용자 지정

양식 영역 이벤트 처리기에 코드를 추가하여 런타임에 양식 영역이 동작하는 방식을 사용자 지정합니다. 이 양식 영역에 대해 코드에서 Outlook 항목의 속성을 검사하고 Map It 양식 영역을 표시할지 여부를 확인합니다. 양식 영역을 표시하는 경우 코드에서 Windows Live 로컬 검색으로 이동하고 Outlook 연락처 항목에 나열된 각 주소의 지도를 로드합니다.

양식 영역의 동작을 사용자 지정하려면

솔루션 탐색기에서 MapIt.cs 또는 MapIt.vb를 클릭한 다음, 코드 보기를 클릭합니다.

코드 편집기에 MapIt.cs 또는 MapIt.vb가 열립니다.
양식 영역 팩터리 코드 영역을 확장합니다.

MapItFactory라는 양식 영역 팩터리 클래스가 노출됩니다.

다음 코드를 MapItFactory_FormRegionInitializing 이벤트 처리기에 추가합니다. 이 이벤트 처리기는 사용자가 연락처 항목을 열 때 호출됩니다. 다음 코드는 연락처 항목에 주소가 포함되어 있는지 여부를 확인합니다. 연락처 항목에 주소가 포함되어 있지 않으면 이 코드에서 FormRegionInitializingEventArgs 클래스의 Cancel 속성을 true로 설정하며 양식 영역이 표시되지 않습니다. 그렇지 않은 경우 VSTO 추가 기능에서 FormRegionShowing 이벤트가 발생하고 양식 영역이 표시됩니다.

private void MapItFactory_FormRegionInitializing(object sender,
    Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs e)
{
    Outlook.ContactItem myItem = (Outlook.ContactItem)e.OutlookItem;

    if (myItem != null)
    {
        if ((myItem.BusinessAddress != null &&
                myItem.BusinessAddress.Trim().Length > 0) ||
            (myItem.HomeAddress != null && 
                myItem.HomeAddress.Trim().Length > 0) ||
            (myItem.OtherAddress != null && 
                myItem.OtherAddress.Trim().Length > 0))
        {
            return;
        }
    }

    e.Cancel = true;
}

Private Sub MapItFactory_FormRegionInitializing(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Outlook.FormRegionInitializingEventArgs) Handles Me.FormRegionInitializing

    Dim myItem As Outlook.ContactItem = CType(e.OutlookItem, Outlook.ContactItem)

    If Not (myItem Is Nothing) Then
        If Not (myItem.BusinessAddress Is Nothing) AndAlso myItem.BusinessAddress.Trim().Length > 0 Or (Not (myItem.HomeAddress Is Nothing) AndAlso myItem.HomeAddress.Trim().Length > 0) Or (Not (myItem.OtherAddress Is Nothing) AndAlso myItem.OtherAddress.Trim().Length > 0) Then
            Return
        End If
    End If

    e.Cancel = True

End Sub

다음 코드를 FormRegionShowing 이벤트 처리기에 추가합니다. 이 코드는 다음 작업을 수행합니다.

연락처 항목의 각 주소를 연결하고 URL 문자열을 만듭니다.

WebBrowser 개체의 Navigate 메서드를 호출하고 URL 문자열을 매개 변수로 전달합니다.

로컬 검색 웹 사이트가 Map It 양식 영역에 나타나고 각 주소를 스크래치 패드에 표시합니다.

private void MapIt_FormRegionShowing(object sender, EventArgs e)
{
    string tempLoc = "";
    string defaultAddress = "";
    string scratchPadAddress = "";

    Outlook.ContactItem myItem = (Outlook.ContactItem)this.OutlookItem;

    if (myItem != null)
    {
        if (myItem.HomeAddress != null && 
                myItem.HomeAddress.Trim().Length > 0)
        {
            tempLoc = myItem.HomeAddressStreet.Trim() + " " + 
                myItem.HomeAddressCity + " " + myItem.HomeAddressState + 
                    " " + myItem.HomeAddressPostalCode;
            if (myItem.HomeAddress == myItem.MailingAddress)
            {
                defaultAddress = tempLoc + "_Home";
            }
            else
            {
                scratchPadAddress += "adr." + tempLoc + "_Home~";
            }
        }
        if (myItem.BusinessAddress != null && 
                myItem.BusinessAddress.Trim().Length > 0)
        {
            tempLoc = myItem.BusinessAddressStreet.Trim() + 
                " " + myItem.BusinessAddressCity + " " + 
                    myItem.BusinessAddressState + " " + 
                        myItem.BusinessAddressPostalCode;
            if (myItem.BusinessAddress == myItem.MailingAddress)
            {
                defaultAddress = tempLoc + "_Business";
            }
            else
            {
                scratchPadAddress += "adr." + tempLoc + "_Business~";
            }
        }
        if (myItem.OtherAddress != null && myItem.OtherAddress.Trim().Length > 0)
        {
            tempLoc = myItem.OtherAddressStreet.Trim() + " " + 
                myItem.OtherAddressCity + " " + myItem.OtherAddressState + 
                    " " + myItem.OtherAddressPostalCode;
            if (myItem.OtherAddress == myItem.MailingAddress)
            {
                defaultAddress = tempLoc + "_Other";
            }
            else
            {
                scratchPadAddress += "adr." + tempLoc + "_Other~";
            }
        }
    }

    webBrowser1.Navigate("http://local.live.com/default.aspx?style=r&where1=" 
        + defaultAddress + "&sp=" + scratchPadAddress);

}

Private Sub MapIt_FormRegionShowing(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles MyBase.FormRegionShowing
    Dim tempLoc As String = ""
    Dim defaultAddress As String = ""
    Dim scratchPadAddress As String = ""

    Dim myItem As Outlook.ContactItem = _
        CType(Me.OutlookItem, Outlook.ContactItem)

    If Not (myItem Is Nothing) Then
        If Not (myItem.HomeAddress Is Nothing) And _
            myItem.HomeAddress.Trim().Length > 0 Then
            tempLoc = myItem.HomeAddressStreet.Trim() + " " _
                + myItem.HomeAddressCity + " " + myItem.HomeAddressState + _
                    " " + myItem.HomeAddressPostalCode
            If myItem.HomeAddress = myItem.MailingAddress Then
                defaultAddress = tempLoc + "_Home"
            Else
                scratchPadAddress += "adr." + tempLoc + "_Home~"
            End If
        End If
        If Not (myItem.BusinessAddress Is Nothing) And _
            myItem.BusinessAddress.Trim().Length > 0 Then
            tempLoc = myItem.BusinessAddressStreet.Trim() + " " _
                + myItem.BusinessAddressCity + " " + _
                    myItem.BusinessAddressState + " " + _
                        myItem.BusinessAddressPostalCode
            If myItem.BusinessAddress = myItem.MailingAddress Then
                defaultAddress = tempLoc + "_Business"
            Else
                scratchPadAddress += "adr." + tempLoc + "_Business~"
            End If
        End If
        If Not (myItem.OtherAddress Is Nothing) And _
            myItem.OtherAddress.Trim().Length > 0 Then
            tempLoc = myItem.OtherAddressStreet.Trim() + " " + _
                myItem.OtherAddressCity + " " + myItem.OtherAddressState + _
                    " " + myItem.OtherAddressPostalCode
            If myItem.OtherAddress = myItem.MailingAddress Then
                defaultAddress = tempLoc + "_Other"
            Else
                scratchPadAddress += "adr." + tempLoc + "_Other~"
            End If
        End If
    End If

    WebBrowser1.Navigate(("http://local.live.com/default.aspx?style=r&where1=" _
        + defaultAddress + "&sp=" + scratchPadAddress))

End Sub

Outlook 양식 영역 테스트

프로젝트를 실행하면 Visual Studio에서 Outlook을 엽니다. 연락처 항목을 열어 Map It 양식 영역을 표시합니다. Map It 양식 영역은 주소가 포함된 연락처 항목의 양식에 페이지로 표시됩니다.

Map It 양식 영역을 테스트하려면

F5 키를 눌러 프로젝트를 실행합니다.

Outlook이 열립니다.
Outlook의 홈 탭에서 새 항목을 클릭한 다음, 연락처를 클릭합니다.
연락처 양식에서 Ann Beebe를 연락처 이름으로 입력하고 다음 세 개의 주소를 지정합니다.

주소 형식 주소

비즈니스 4567 Main St. Buffalo, NY

홈 1234 North St. Buffalo, NY

기타 3456 Main St. Seattle, WA
연락처 항목을 저장하고 닫습니다.
Ann Beebe 연락처 항목을 다시 엽니다.

Outlook에서는 연락처 주소록을 열거나 사람 검색에 Ann Beebe를 입력하여 찾기 그룹에서 이 작업을 수행할 수 있습니다.
항목 리본 메뉴의 표시 그룹에서 매핑을 클릭하여 매핑 양식 영역을 엽니다.

Map It 양식 영역이 나타나고 로컬 검색 웹 사이트를 표시합니다. 비즈니스, 홈 및 기타 주소가 스크래치 패드에 나타납니다. 스크래치 패드에서 매핑할 주소를 선택합니다.

주소 형식	주소
비즈니스	4567 Main St. Buffalo, NY
홈	1234 North St. Buffalo, NY
기타	3456 Main St. Seattle, WA

다음 단계

다음 항목에서 Outlook 애플리케이션의 UI를 사용자 지정하는 방법에 대해 자세히 알아볼 수 있습니다.

Outlook 항목의 리본 메뉴를 사용자 지정하는 방법을 알아보려면 Outlook의 리본 메뉴 사용자 지정을 참조하세요.

다음을 통해 공유

연습: Outlook 양식 영역 디자인

필수 조건

새 Outlook VSTO 추가 기능 프로젝트 만들기

새 Outlook VSTO 추가 기능 프로젝트를 만들려면

Outlook VSTO 추가 기능 프로젝트에 양식 영역 추가

Outlook VSTO 추가 기능 프로젝트에 양식 영역을 추가하려면

양식 영역의 레이아웃 디자인

양식 영역의 레이아웃을 디자인하려면

양식 영역의 동작 사용자 지정

양식 영역의 동작을 사용자 지정하려면

Outlook 양식 영역 테스트

Map It 양식 영역을 테스트하려면

다음 단계

추가 리소스

다음을 통해 공유

연습: Outlook 양식 영역 디자인

필수 조건

새 Outlook VSTO 추가 기능 프로젝트 만들기

새 Outlook VSTO 추가 기능 프로젝트를 만들려면

Outlook VSTO 추가 기능 프로젝트에 양식 영역 추가

Outlook VSTO 추가 기능 프로젝트에 양식 영역을 추가하려면

양식 영역의 레이아웃 디자인

양식 영역의 레이아웃을 디자인하려면

양식 영역의 동작 사용자 지정

양식 영역의 동작을 사용자 지정하려면

Outlook 양식 영역 테스트

Map It 양식 영역을 테스트하려면

다음 단계

관련 콘텐츠

추가 리소스