연습: CheckBox 컨트롤을 사용하여 문서 서식 변경

업데이트: 2007년 11월

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

이 연습에서는 Microsoft Office Word용 문서 수준 사용자 지정에서 Windows Forms 컨트롤을 사용하여 텍스트 서식을 변경하는 방법을 보여 줍니다.

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

• 디자인 타임에 문서 수준 프로젝트의 문서에 텍스트 및 컨트롤 추가

• 옵션을 선택할 때 텍스트 서식 지정

결과를 전체 샘플로 보려면 Word 컨트롤 샘플을 참조하십시오.

참고:
다음 지침처럼 컴퓨터에서 Visual Studio 사용자 인터페이스 요소 일부에 대한 이름이나 위치를 다르게 표시할 수 있습니다. 이러한 요소는 사용하는 Visual Studio 버전 및 설정에 따라 결정됩니다. 자세한 내용은 Visual Studio 설정을 참조하십시오.

사전 요구 사항

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

• Visual Studio Tools for Office(Visual Studio 2008 Professional 및 Visual Studio Team System의 선택적 구성 요소)

• Microsoft Office Word 2003 또는 Microsoft Office Word 2007

Visual Studio Tools for Office는 기본적으로 나열된 Visual Studio 버전과 함께 설치됩니다. 설치 여부를 확인하려면 Visual Studio Tools for Office 설치를 참조하십시오.

프로젝트 만들기

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

새 프로젝트를 만들려면

• 이름이 My Word Formatting인 Word 문서 프로젝트를 만듭니다. 마법사에서 새 문서 만들기를 선택합니다.

  자세한 내용은 방법: Visual Studio Tools for Office 프로젝트 만들기를 참조하십시오.

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

Word 문서에 텍스트 및 컨트롤 추가

이 연습에서는 Word 문서의 Bookmark 컨트롤에 확인란 세 개와 텍스트를 추가합니다. 확인란은 사용자에게 텍스트 서식을 지정하기 위한 옵션을 제공합니다.

확인란 세 개를 추가하려면

1. Visual Studio 디자이너에 문서가 열려 있는지 확인합니다.

2. 도구 상자의 공용 컨트롤 탭에서 첫 번째 CheckBox 컨트롤을 문서로 끌어 놓습니다.

3. 속성 창에서 다음과 같이 속성을 변경합니다.

   속성	값
   이름	applyBoldFont
   텍스트	굵게

4. Enter 키를 눌러 삽입 지점을 첫 번째 확인란 아래로 옮깁니다.

5. 문서의 ApplyBoldFont 확인란 아래에 두 번째 확인란을 추가하고 다음 속성을 변경합니다.

   속성	값
   이름	applyItalicFont
   텍스트	기울임꼴

6. Enter 키를 눌러 삽입 지점을 두 번째 확인란 아래로 옮깁니다.

7. 문서의 ApplyItalicFont 확인란 아래에 세 번째 확인란을 추가하고 다음 속성을 변경합니다.

   속성	값
   이름	applyUnderlineFont
   텍스트	밑줄

텍스트 및 Bookmark 컨트롤을 추가하려면

1. 삽입 지점을 확인란 컨트롤 아래로 옮기고 다음 텍스트를 입력합니다.

   이 텍스트의 서식을 변경하려면 확인란을 클릭하십시오.

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

   Bookmark 컨트롤 추가 대화 상자가 나타납니다.

3. 문서에 추가한 텍스트를 선택하고 확인을 클릭합니다.

   Bookmark1이라는 Bookmark 컨트롤이 문서에서 선택한 텍스트에 추가됩니다.

4. 속성 창에서 (Name) 속성 값을 fontText로 변경합니다.

이제 확인란을 선택하거나 해제할 때 텍스트 서식을 지정하는 코드를 작성합니다.

확인란을 선택 또는 해제할 때 텍스트 서식 지정

사용자가 서식 옵션을 선택하면 문서에 있는 텍스트의 서식이 변경됩니다.

확인란을 선택한 경우 서식을 변경하려면

1. 솔루션 탐색기에서 마우스 오른쪽 단추로 ThisDocument를 클릭한 다음 바로 가기 메뉴에서 코드 보기를 클릭합니다.

2. C#의 경우 ThisDocument 클래스에 다음 상수를 추가합니다.

   const int WordTrue = -1;
   const int WordFalse = 0;
   

3. applyBoldFont 확인란의 Click 이벤트 처리기에 다음 코드를 추가합니다.

   Private Sub applyBoldFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyBoldFont.Click
   
       Me.fontText.Bold = Me.applyBoldFont.Checked
   End Sub
   

   private void applyBoldFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyBoldFont.Checked == true)
       {
           this.fontText.Bold = WordTrue;
       }
       else
       {
           this.fontText.Bold = WordFalse;
       }
   }
   

4. applyItalicFont 확인란의 Click 이벤트 처리기에 다음 코드를 추가합니다.

   Private Sub applyItalicFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyItalicFont.Click
   
       Me.fontText.Italic = Me.applyItalicFont.Checked
   End Sub
   

   private void applyItalicFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyItalicFont.Checked == true)
       {
           this.fontText.Italic = WordTrue;
       }
       else
       {
           this.fontText.Italic = WordFalse;
       }
   }
   

5. applyUnderlineFont 확인란의 Click 이벤트 처리기에 다음 코드를 추가합니다.

   Private Sub applyUnderlineFont_Click(ByVal sender As Object, ByVal e As System.EventArgs) _
       Handles applyUnderlineFont.Click
   
       If Me.applyUnderlineFont.Checked Then
           Me.fontText.Underline = Word.WdUnderline.wdUnderlineSingle
       Else
           Me.fontText.Underline = Word.WdUnderline.wdUnderlineNone
       End If
   End Sub
   

   private void applyUnderlineFont_Click(object sender, System.EventArgs e)
   {
       if (this.applyUnderlineFont.Checked == true)
       {
           this.fontText.Underline = Word.WdUnderline.wdUnderlineSingle;
       }
       else
       {
           this.fontText.Underline = Word.WdUnderline.wdUnderlineNone;
       }
   }
   

6. C#의 경우 Startup 이벤트에 텍스트 상자에 대한 이벤트 처리기를 추가해야 합니다. 이벤트 처리기를 만드는 방법에 대한 자세한 내용은 방법: Visual Studio Tools for Office에서 이벤트 처리기 만들기를 참조하십시오.

   this.applyBoldFont.Click += new EventHandler(applyBoldFont_Click);
   this.applyItalicFont.Click += new EventHandler(applyItalicFont_Click);
   this.applyUnderlineFont.Click += new EventHandler(applyUnderlineFont_Click);
   

응용 프로그램 테스트

이제 문서를 테스트하여 확인란을 선택하거나 해제할 때 텍스트의 서식이 올바르게 지정되는지 확인할 수 있습니다.

문서를 테스트하려면

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

2. 확인란을 선택하거나 해제합니다.

3. 텍스트의 서식이 올바르게 지정되는지 확인합니다.

다음 단계

이 연습은 Word 문서에서 확인란을 사용하고 텍스트 서식을 프로그래밍 방식으로 변경하는 기본적인 방법을 보여 줍니다. 이후에 수행할 수 있는 작업은 다음과 같습니다.

• 단추를 사용하여 텍스트 상자를 채웁니다. 자세한 내용은 연습: 문서에서 단추를 사용하여 텍스트 상자에 텍스트 표시를 참조하십시오.

• 라디오 단추를 사용하여 차트 스타일을 선택합니다. 자세한 내용은 연습: 문서에서 라디오 단추를 사용하여 차트 업데이트를 참조하십시오.

참고 항목

개념

Word를 사용한 연습

NamedRange 컨트롤

Office 문서에서 Windows Forms 컨트롤에 대한 제한 사항

기타 리소스

Office 개발 샘플 및 연습