연습: NamedRange 컨트롤의 이벤트 프로그래밍

아티클
08/10/2011

이 연습에서는 Visual Studio의 Office 개발 도구를 사용하여 Microsoft Office Excel 워크시트에 NamedRange 컨트롤을 추가하고 이 컨트롤의 이벤트를 대상으로 프로그래밍하는 방법을 설명합니다.

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

이 연습을 통해 다음과 같은 작업 방법을 배웁니다.

워크시트에 NamedRange 컨트롤 추가
NamedRange 컨트롤의 이벤트에 대한 프로그래밍
프로젝트 테스트

참고

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

사전 요구 사항

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

Microsoft Office 개발자 도구를 포함하는 Visual Studio 2010 버전입니다. 자세한 내용은 [Office 솔루션을 개발할 수 있도록 컴퓨터 구성](bb398242\(v=vs.100\).md)을 참조하십시오.

Excel 2007 또는 Excel 2010

프로젝트 만들기

이 단계에서는 Visual Studio를 사용하여 Excel 통합 문서 프로젝트를 만듭니다.

새 프로젝트를 만들려면

My Named Range Events라는 이름의 Excel 통합 문서 프로젝트를 만듭니다. 새 문서 만들기가 선택되어 있는지 확인합니다. 자세한 내용은 방법: Visual Studio에서 Office 프로젝트 만들기를 참조하십시오.

새로운 Excel 통합 문서가 디자이너에서 열리고 솔루션 탐색기에 My Named Range Events 프로젝트가 추가됩니다.

워크시트에 텍스트 및 명명된 범위 추가

호스트 컨트롤은 확장 Office 개체이므로 네이티브 개체를 추가하는 것과 동일한 방식으로 문서에 추가할 수 있습니다. 예를 들어 삽입 메뉴를 열고 이름을 가리킨 다음 정의를 선택하여 Excel NamedRange 컨트롤을 워크시트에 추가할 수 있습니다. 또한 NamedRange 컨트롤을 도구 상자에서 워크시트로 끌어 놓는 방식으로 추가할 수 있습니다.

이 단계에서는 도구 상자를 사용하여 워크시트에 두 개의 NamedRange 컨트롤을 추가한 다음 텍스트를 워크시트에 추가합니다.

워크시트에 범위를 추가하려면

Visual Studio 디자이너에 My Named Range Events.xls 통합 문서가 열려 있고 Sheet1이 표시되어 있는지 확인합니다.
도구 상자의 Excel 컨트롤 탭에서 NamedRange 컨트롤을 Sheet1의 A1 셀에 끌어 놓습니다.

그러면 NamedRange 컨트롤 추가 대화 상자가 표시됩니다.
편집할 수 있는 텍스트 상자에 $A$1이 표시되고 A1 셀이 선택되어 있는지 확인합니다. A1 셀이 선택되어 있지 않으면 이 셀을 클릭하여 선택합니다.
확인을 클릭합니다.

이제 A1 셀은 namedRange1이라는 이름을 가진 범위가 됩니다. 범위 추가로 인해 워크시트에 드러나는 변화는 없지만 A1 셀을 선택하면 워크시트 왼쪽 위의 이름 상자에 범위 이름인 namedRange1이 표시됩니다.
B3 셀에 또 하나의 NamedRange 컨트롤을 추가합니다.
편집할 수 있는 텍스트 상자에 $B$3이 표시되고 B3 셀이 선택되어 있는지 확인합니다. B3 셀이 선택되어 있지 않으면 이 셀을 클릭하여 선택합니다.
확인을 클릭합니다.

이제 B3 셀은 namedRange2이라는 이름을 가진 범위가 됩니다.

워크시트에 텍스트를 추가하려면

A1 셀에 다음 텍스트를 입력합니다.

NamedRange 컨트롤에 대한 예제입니다.
namedRange2 왼쪽에 있는 A3 셀에 다음 텍스트를 입력합니다.

이벤트:

다음 단원에서는 namedRange1의 BeforeDoubleClick, Change 및 SelectionChange 이벤트에 대한 응답으로 namedRange2에 텍스트를 삽입하고 namedRange2 컨트롤의 속성을 변경하는 코드를 작성합니다.

BeforeDoubleClick 이벤트에 응답하는 코드 추가

BeforeDoubleClick 이벤트를 기반으로 NamedRange2에 텍스트를 삽입하려면

솔루션 탐색기에서 Sheet1.vb 또는 Sheet1.cs를 마우스 오른쪽 단추로 클릭하고 코드 보기를 선택합니다.

다음과 같은 결과가 되도록 namedRange1_BeforeDoubleClick 이벤트 처리기에 코드를 추가합니다.

Private Sub NamedRange1_BeforeDoubleClick( _
    ByVal Target As Microsoft.Office.Interop.Excel.Range, ByRef Cancel As Boolean) _
    Handles NamedRange1.BeforeDoubleClick

    With Me.NamedRange2
        .Value2 = "The BeforeDoubleClick event occurred."
        .Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Red)
        .Font.Italic = True
    End With
End Sub

private void namedRange1_BeforeDoubleClick(
    Microsoft.Office.Interop.Excel.Range Target, ref bool Cancel)
{
    this.namedRange2.Value2 = "The BeforeDoubleClick event occurred.";
    this.namedRange2.Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Red);
    this.namedRange2.Font.Italic = true;
}

C#의 경우 아래 Startup 이벤트에서와 같이 명명된 범위에 대한 이벤트 처리기를 추가해야 합니다. 이벤트 처리기를 만드는 방법에 대한 자세한 내용은 방법: Office 프로젝트에서 이벤트 처리기 만들기를 참조하십시오.

this.namedRange1.BeforeDoubleClick += new Microsoft.Office.Interop.Excel.
    DocEvents_BeforeDoubleClickEventHandler(namedRange1_BeforeDoubleClick);   

this.namedRange1.Change += new Microsoft.Office.Interop.Excel.
    DocEvents_ChangeEventHandler(namedRange1_Change);

this.namedRange1.SelectionChange +=new Microsoft.Office.Interop.Excel.
    DocEvents_SelectionChangeEventHandler(namedRange1_SelectionChange);

Change 이벤트에 응답하는 코드 추가

Change 이벤트를 기반으로 namedRange2에 텍스트를 삽입하려면

다음과 같은 결과가 되도록 NamedRange1_Change 이벤트 처리기에 코드를 추가합니다.

Private Sub NamedRange1_Change(ByVal Target As Microsoft.Office.Interop.Excel.Range) _
    Handles NamedRange1.Change

    With Me.NamedRange2
        .Value2 = "The Change event occurred."
        .Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue)
        .Font.Italic = False
    End With
End Sub

private void namedRange1_Change(Microsoft.Office.Interop.Excel.Range Target)
{
    this.namedRange2.Value2 = "The Change event occurred.";
    this.namedRange2.Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Blue);
    this.namedRange2.Font.Italic = false;
}

참고

Excel 범위에 있는 셀을 두 번 클릭하면 편집 모드로 전환되므로, 선택이 범위 밖으로 이동될 때에는 텍스트를 변경하지 않았더라도 Change 이벤트가 발생합니다.

SelectionChange 이벤트에 응답하는 코드 추가

SelectionChange 이벤트를 기반으로 namedRange2에 텍스트를 삽입하려면

다음과 같은 결과가 되도록 NamedRange1_SelectionChange 이벤트 처리기에 코드를 추가합니다.

Private Sub NamedRange1_SelectionChange(ByVal Target As Microsoft.Office.Interop.Excel.Range) _
    Handles NamedRange1.SelectionChange

    With Me.NamedRange2
        .Value2 = "The SelectionChange event occurred."
        .AddComment("SelectionChange always occurs before BeforeDoubleClick.")
        .Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Black)
    End With
End Sub

private void namedRange1_SelectionChange(Microsoft.Office.Interop.Excel.Range Target)
{
    this.namedRange2.Value2 = "The SelectionChange event occurred.";
    this.namedRange2.AddComment("SelectionChange always occurs before BeforeDoubleClick.");
    this.namedRange2.Font.Color = System.Drawing.ColorTranslator.ToOle(System.Drawing.Color.Black);
}

참고

Excel 범위에 있는 셀을 두 번 클릭하면 선택이 범위 안으로 이동하므로, BeforeDoubleClick 이벤트가 발생하기 전에 SelectionChange 이벤트가 발생합니다.

응용 프로그램 테스트

이제 통합 문서를 테스트하여 NamedRange 컨트롤의 이벤트가 발생하면 그 이벤트에 대해 설명하는 텍스트가 다른 명명된 범위에 삽입되는지 확인할 수 있습니다.

문서를 테스트하려면

F5 키를 눌러 프로젝트를 실행합니다.
namedRange1에 커서를 놓은 다음 SelectionChange 이벤트에 관한 텍스트가 삽입되는지와 워크시트에 주석이 삽입되는지를 확인합니다.
namedRange1 내부를 두 번 클릭한 다음 BeforeDoubleClick 이벤트에 관한 빨간색 기울임꼴 텍스트가 namedRange2에 삽입되는지 확인합니다.
다음에는 namedRange1 외부를 클릭합니다. 텍스트를 변경하지 않았더라도 편집 모드를 마칠 때 change 이벤트가 발생하는 것을 알 수 있습니다.
namedRange1 내에서 텍스트를 변경합니다.
namedRange1 외부를 클릭한 다음 Change 이벤트에 관한 파란색 텍스트가 namedRange2에 삽입되는지 확인합니다.