연습: 작업 창에서 문서로 텍스트 삽입

아티클
08/10/2011

이 연습에서는 Microsoft Office Word 문서에서 작업 창을 만드는 방법을 보여 줍니다. 작업 창에는 입력 내용을 수집한 다음 해당 텍스트를 문서에 보내는 두 개의 컨트롤이 들어 있습니다.

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

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

작업 창 컨트롤에서 Windows Forms 컨트롤을 사용하여 인터페이스 디자인
응용 프로그램이 열릴 때 작업 창 표시

참고

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

사전 요구 사항

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

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

Word 2007 또는 Word 2010

프로젝트 만들기

첫 번째 단계에서는 Word 문서 프로젝트를 만듭니다.

새 프로젝트를 만들려면

My Basic Actions Pane이라는 이름으로 Word 문서 프로젝트를 만듭니다. 마법사에서 새 문서 만들기를 선택합니다. 자세한 내용은 방법: Visual Studio에서 Office 프로젝트 만들기를 참조하십시오.

Visual Studio의 디자이너에 새 Word 문서가 열리고 My Basic Actions Pane 프로젝트가 솔루션 탐색기에 추가됩니다.

문서에 텍스트 및 책갈피 추가

작업 창에서는 텍스트를 문서의 책갈피에 보냅니다. 문서를 디자인하려면 텍스트를 일부 입력하여 기본 형식을 만듭니다.

문서에 텍스트를 추가하려면

Word 문서에 다음 텍스트를 입력합니다.

2008년 3월 21일

Name

Address

이것은 Word의 기본 작업 창 예제입니다.

Visual Studio의 도구 상자에서 끌어 오거나 Word의 책갈피 대화 상자를 사용하는 방법으로 Bookmark 컨트롤을 문서에 추가할 수 있습니다.

문서에 Bookmark 컨트롤을 추가하려면

도구 상자의 Word 컨트롤 탭에서 Bookmark 컨트롤을 문서로 끌어 놓습니다.

Bookmark 컨트롤 추가 대화 상자가 나타납니다.
단락 기호를 선택하지 않은 상태에서 이름이라는 단어를 선택하고 확인을 클릭합니다.

참고

단락 기호는 책갈피 외부에 있어야 합니다. 문서에 단락 기호가 표시되지 않으면 도구 메뉴를 클릭하고 Microsoft Office Word 도구를 가리킨 다음 옵션을 클릭합니다. 보기 탭을 클릭하고 옵션 대화 상자의 서식 기호 섹션에서 단락 기호 확인란을 선택합니다.
속성 창에서 Bookmark1의 Name 속성을 showName으로 변경합니다.
단락 기호를 선택하지 않은 상태에서 주소를 선택합니다.
리본 메뉴의 삽입 탭에 있는 연결 그룹에서 책갈피를 클릭합니다.
책갈피 대화 상자에서 책갈피 이름 상자에 showAddress를 입력하고 추가를 클릭합니다.

작업 창에 컨트롤 추가

작업 창 인터페이스를 디자인하려면 작업 창 컨트롤을 프로젝트에 추가한 다음 Windows Forms 컨트롤을 작업 창 컨트롤에 추가합니다.

작업 창 컨트롤을 추가하려면

솔루션 탐색기에서 My Basic Actions Pane 프로젝트를 선택합니다.
프로젝트 메뉴에서 새 항목 추가를 클릭합니다.
새 항목 추가 대화 상자에서 작업 창 컨트롤을 클릭하고 컨트롤의 이름을 InsertTextControl로 지정한 다음 추가를 클릭합니다.

작업 창 컨트롤에 Windows Form 컨트롤을 추가하려면

디자이너에 작업 창 컨트롤이 표시되지 않으면 InsertTextControl을 두 번 클릭합니다.
도구 상자의 공용 컨트롤 탭에서 Label 컨트롤을 작업 창 컨트롤로 끌어 놓습니다.
Label 컨트롤의 Text 속성을 Name으로 변경합니다.
Textbox 컨트롤을 작업 창 컨트롤에 추가하고 다음 속성을 변경합니다.

속성

값

Name

getName

Size

130, 20
두 번째 Label 컨트롤을 작업 창 컨트롤에 추가하고 Text 속성을 Address로 변경합니다.
두 번째 Textbox 컨트롤을 작업 창 컨트롤에 추가하고 다음 속성을 변경합니다.

속성

값

Name

getAddress

Accepts Return

True

Multiline

True

Size

130, 40
Button 컨트롤을 작업 창 컨트롤에 추가하고 다음 속성을 변경합니다.

속성

값

Name

addText

Text

Insert

속성	값
Name	getName
Size	130, 20

속성	값
Name	getAddress
Accepts Return	True
Multiline	True
Size	130, 40

속성	값
Name	addText
Text	Insert

문서에 텍스트를 삽입하는 코드 추가

작업 창에서 텍스트 상자의 텍스트를 문서에 있는 적절한 Bookmark 컨트롤에 삽입하는 코드를 작성합니다. Globals 클래스를 사용하여 작업 창의 컨트롤에서 문서의 컨트롤에 액세스할 수 있습니다. 자세한 내용은 Office 프로젝트의 개체에 전역 액세스를 참조하십시오.

작업 창의 텍스트를 문서의 책갈피에 삽입하려면

addText 단추의 Click 이벤트 처리기에 다음 코드를 추가합니다.

Private Sub addText_Click(ByVal sender As System.Object, ByVal e As System.EventArgs) _
    Handles addText.Click

    If Me.getName.Text <> String.Empty Then
        Globals.ThisDocument.showName.Text = Me.getName.Text
    End If

    If Me.getAddress.Text <> String.Empty Then
        Globals.ThisDocument.showAddress.Text = Me.getAddress.Text
    End If

    Me.getName.Text = String.Empty
    Me.getAddress.Text = String.Empty
End Sub

private void addText_Click(object sender, System.EventArgs e)
{
    if (this.getName.Text != String.Empty) 
    {
        Globals.ThisDocument.showName.Text = this.getName.Text;
    }

    if (this.getAddress.Text != String.Empty)
    {
        Globals.ThisDocument.showAddress.Text = this.getAddress.Text;
    }

    this.getName.Text = String.Empty;
    this.getAddress.Text = String.Empty;
}

C#의 경우 단추 클릭에 대해 이벤트 처리기를 추가해야 합니다. 이 코드를 InsertTextControl 생성자에서 IntializeComponent에 대한 호출 밑에 배치할 수 있습니다. 이벤트 처리기를 만드는 방법에 대한 자세한 내용은 방법: Office 프로젝트에서 이벤트 처리기 만들기를 참조하십시오.
```
public InsertTextControl()
{
    InitializeComponent();
    this.addText.Click += new EventHandler(addText_Click);
}
```

작업 창을 표시하는 코드 추가

작업 창을 표시하려면 만든 컨트롤을 컨트롤 컬렉션에 추가합니다.

작업 창을 표시하려면

ThisDocument 클래스에서 작업 창 컨트롤의 새 인스턴스를 만듭니다.

Dim insertText As New InsertTextControl

private InsertTextControl insertText = new InsertTextControl();

ThisDocument의 Startup 이벤트 처리기에 다음 코드를 추가합니다.

Me.ActionsPane.Controls.Add(insertText)

this.ActionsPane.Controls.Add(insertText);

응용 프로그램 테스트

문서를 열 때 작업 창이 열리고 단추를 클릭하면 텍스트 상자에 입력된 텍스트가 책갈피에 삽입되는지 확인하기 위해 문서를 테스트합니다.

문서를 테스트하려면

F5 키를 눌러 프로젝트를 실행합니다.
작업 창이 표시되는지 확인합니다.
작업 창의 텍스트 상자에 이름과 주소를 입력하고 Insert를 클릭합니다.

다음 단계

이후에 수행할 수 있는 작업은 다음과 같습니다.

Excel에서 작업 창을 만듭니다. 자세한 내용은 방법: Excel 통합 문서에 작업 창 추가를 참조하십시오.
작업 창의 컨트롤에 데이터를 바인딩합니다. 자세한 내용은 연습: Word 작업 창의 컨트롤에 데이터 바인딩을 참조하십시오.
작업 창에서 컨트롤을 표시하거나 숨깁니다. 자세한 내용은 연습: 사용자 컨텍스트에 따라 작업 창 변경을 참조하십시오.

참고 항목