다음을 통해 공유


Word 문서에 Bookmark 컨트롤 추가

문서 수준 프로젝트에서 디자인 타임 또는 런타임에 프로젝트의 문서에 Bookmark 컨트롤을 추가할 수 있습니다. VSTO 추가 기능 프로젝트에서는 런타임에 열려 있는 임의 문서에 Bookmark 컨트롤을 추가할 수 있습니다.

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

이 항목에서는 다음 작업에 대해 설명합니다.

디자인 타임에 Bookmark 컨트롤 추가

디자인 타임에 문서 수준 프로젝트의 문서에 Bookmark 컨트롤을 추가하는 여러 가지 방법이 있습니다.

  • Visual Studio 도구 상자에서.

    Bookmark 도구 상자 에서 문서로 컨트롤을 끌어올 수 있습니다. 이미 도구 상자 를 사용하여 Windows Forms 컨트롤을 문서에 추가 중인 경우 이 방법을 선택하는 것이 좋습니다.

  • Word 내에서.

    네이티브 책갈피를 추가하는 것과 동일한 방식으로 Bookmark 컨트롤을 문서에 추가할 수 있습니다. 이런 방식으로 추가하는 경우 컨트롤을 만들 때 이름을 지정할 수 있다는 이점이 있습니다.

  • 데이터 소스 창에서.

    Bookmark 데이터 소스 창에서 컨트롤을 문서로 끌어올 수 있습니다. 이 기능은 동시에 컨트롤을 데이터에 바인딩하려는 경우에 유용합니다. 데이터 소스 창에서 Windows Form 컨트롤을 추가하는 것과 동일한 방법으로 호스트 컨트롤을 추가할 수 있습니다. 자세한 내용은 데이터 바인딩 및 Windows Forms를 참조하세요.

    참고 항목

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

도구 상자에서 문서에 책갈피 컨트롤을 추가하려면

  1. 도구 상자 를 열고 Word 컨트롤 탭을 클릭합니다.

  2. Bookmark 컨트롤을 문서로 끌어옵니다.

    책갈피 추가 대화 상자가 나타납니다.

  3. 책갈피에 포함하려는 텍스트 또는 기타 항목을 선택합니다.

  4. 확인을 클릭합니다.

    기본 책갈피 이름을 유지하지 않으려면 속성 창에서 이름을 변경할 수 있습니다.

Word에서 문서에 책갈피 컨트롤을 추가하려면

  1. Visual Studio 디자이너에 호스트된 문서에서 책갈피를 추가하려는 위치에 커서를 놓거나 책갈피로 묶으려는 텍스트를 선택합니다.

  2. 리본 메뉴의 삽입 탭에 있는 링크 그룹에서 책갈피 단추를 클릭합니다.

  3. 책갈피 대화 상자에서 새 책갈피의 이름을 입력하고 추가를 클릭합니다.

런타임 시 문서 수준 프로젝트에 Bookmark 컨트롤 추가

프로젝트에서 Bookmark 클래스의 Controls 속성 메서드를 사용하여 프로그래밍 방식으로 런타임에 문서에 ThisDocument 컨트롤을 추가할 수 있습니다. 다음과 같은 방법으로 Bookmark 컨트롤을 추가하는 데 사용할 수 있는 두 개의 메서드 오버로드가 있습니다.

  • 지정된 범위에 Bookmark 를 추가합니다.

  • 문서의 네이티브 책갈피(즉, Bookmark )를 기반으로 하는 Bookmark를 추가합니다.

    동적으로 생성된 Bookmark 컨트롤은 문서를 닫을 때 문서에 유지되지 않습니다. 그러나 네이티브 Bookmark 는 문서에 남아 있습니다. 다음에 문서를 열 때 네이티브 책갈피를 기반으로 하는 Bookmark 를 다시 만들 수 있습니다. 자세한 내용은 런타임 시 Office 문서에 컨트롤 추가를 참조하세요.

프로그래밍 방식으로 문서에 책갈피 컨트롤을 추가하려면

  1. 프로젝트의 ThisDocument_Startup 이벤트 처리기에서 다음 코드를 삽입하여 문서의 첫 번째 단락에 Bookmark 컨트롤을 추가합니다.

    Microsoft.Office.Tools.Word.Bookmark firstParagraph;
    firstParagraph = this.Controls.AddBookmark(this.Paragraphs[1].Range,
        "FirstParagraph");
    

    참고 항목

    기존 Bookmark 에서 Bookmark컨트롤을 만들려는 경우 AddBookmark 메서드를 사용하고 기존 Bookmark를 전달합니다.

런타임 시 VSTO 추가 기능 프로젝트에 Bookmark 컨트롤 추가

VSTO 추가 기능을 사용하여 프로그래밍 방식으로 런타임에 열려 있는 문서에 Bookmark 컨트롤을 추가할 수 있습니다. 이렇게 하려면 열려 있는 문서를 기반으로 하는 Document 호스트 항목을 생성한 다음 이 호스트 항목의 Controls 속성 메서드를 사용합니다. 다음과 같은 방법으로 Bookmark 컨트롤을 추가하는 데 사용할 수 있는 두 개의 메서드 오버로드가 있습니다.

지정된 범위에 책갈피 컨트롤을 추가하려면

  1. AddBookmark 메서드를 사용하고 Range 를 추가하려는 Bookmark를 전달합니다.

    다음 코드 예제에서는 활성 문서의 시작 부분에 새 Bookmark 를 추가합니다. 이 예제를 사용하려면 Word VSTO 추가 기능 프로젝트의 ThisAddIn_Startup 이벤트 처리기에서 코드를 실행합니다.

    Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
    
    Bookmark firstParagraph = extendedDocument.Controls.AddBookmark(
        extendedDocument.Paragraphs[1].Range, "FirstParagraph");
    

네이티브 책갈피 컨트롤을 기반으로 하는 책갈피 컨트롤을 추가하려면

  1. AddBookmark 메서드를 사용하고 새 Bookmark 의 기초로 사용할 기존 Bookmark를 전달합니다.

    다음 코드 예제에서는 활성 문서의 첫 번째 Bookmark 를 기반으로 하는 새 Bookmark 를 만듭니다. 이 예제를 사용하려면 Word VSTO 추가 기능 프로젝트의 ThisAddIn_Startup 이벤트 처리기에서 코드를 실행합니다.

    if (this.Application.ActiveDocument.Bookmarks.Count > 0)
    {
        object index = 1;
        Word.Bookmark firstBookmark = this.Application.ActiveDocument.Bookmarks.get_Item(ref index);
    
    
         Document extendedDocument = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    
        Bookmark vstoBookmark = extendedDocument.Controls.AddBookmark(
                firstBookmark, "VSTOBookmark");
    }