방법: 책갈피 텍스트 업데이트

아티클
08/10/2011

Microsoft Office Word 문서의 자리 표시자 책갈피에 텍스트를 삽입하여 나중에 이 텍스트를 검색하거나 책갈피의 텍스트를 바꿀 수 있습니다. 문서 수준 사용자 지정을 개발할 때 데이터에 바인딩된 Microsoft.Office.Tools.Word.Bookmark 컨트롤의 텍스트를 업데이트할 수도 있습니다. 자세한 내용은 Office 솔루션의 컨트롤에 데이터 바인딩를 참조하십시오.

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

책갈피 개체는 다음 두 종류 중 하나입니다.

Microsoft.Office.Tools.Word.Bookmark 호스트 컨트롤

Microsoft.Office.Tools.Word.Bookmark 컨트롤은 데이터 바인딩을 사용하고 이벤트를 노출하여 네이티브 Microsoft.Office.Interop.Word.Bookmark 개체를 확장합니다. 호스트 컨트롤에 대한 자세한 내용은 호스트 항목 및 호스트 컨트롤 개요를 참조하십시오.
네이티브 Microsoft.Office.Interop.Word.Bookmark 개체

Microsoft.Office.Interop.Word.Bookmark 개체에는 이벤트나 데이터 바인딩 기능이 없습니다.

책갈피에 텍스트를 할당할 때 Microsoft.Office.Interop.Word.Bookmark 및 Microsoft.Office.Tools.Word.Bookmark의 동작이 서로 다릅니다. 자세한 내용은 책갈피 컨트롤을 참조하십시오.

호스트 컨트롤 사용

Bookmark 컨트롤을 사용하여 책갈피 내용을 업데이트하려면

책갈피의 이름으로 bookmark 인수를 사용하고 Text 속성에 할당할 문자열로 newText 인수를 사용하는 프로시저를 만듭니다.

참고

Microsoft.Office.Tools.Word.Bookmark 컨트롤의 Bookmark.Text 또는 Bookmark.FormattedText 속성에 텍스트를 할당해도 책갈피가 삭제되지 않습니다.
```
Shared Sub BookMarkReplace( _
    ByRef bookmark As Microsoft.Office.Tools.Word.Bookmark, _
    ByVal newText As String)
```
```
static void BookMarkReplace(
    ref Microsoft.Office.Tools.Word.Bookmark bookmark, 
    string newText)
{
```
newText 문자열을 Microsoft.Office.Tools.Word.Bookmark의 Text 속성에 할당합니다.
```
    bookmark.Text = newText
End Sub
```
```
    bookmark.Text = newText;
}
```

Word 개체 사용

Word 책갈피 개체를 사용하여 책갈피 내용을 업데이트하려면

Microsoft.Office.Interop.Word.Bookmark의 이름으로 bookmark 인수를 사용하고 책갈피의 Range.Text 속성에 할당할 문자열로 newText 인수를 사용하는 프로시저를 만듭니다.

참고

네이티브 Word Microsoft.Office.Interop.Word.Bookmark 개체에 텍스트를 할당하면 책갈피가 삭제됩니다.
```
Friend Sub BookMarkReplaceNative( _
    ByVal bookmark As Word.Bookmark, _
    ByVal newText As String)
```
```
internal void BookMarkReplaceNative(
    Word.Bookmark bookmark, 
    string newText)
{
```

newText 문자열을 책갈피의 Range.Text 속성에 할당합니다. 그러면 책갈피가 자동으로 삭제됩니다. 그런 다음 책갈피를 Bookmarks 컬렉션에 다시 추가합니다.

다음 코드 예제는 문서 수준 사용자 지정에 사용할 수 있습니다.

    Dim rng As Word.Range = bookmark.Range
    Dim bookmarkName As String = bookmark.Name

    bookmark.Range.Text = newText

    Me.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
End Sub

    object rng = bookmark.Range;
    string bookmarkName = bookmark.Name;

    bookmark.Range.Text = newText;

    this.Bookmarks.Add(bookmarkName, ref rng); 
}

다음 코드 예제는 응용 프로그램 수준 추가 기능에 사용할 수 있습니다. 이 예제에서는 활성 문서를 사용합니다.

    Dim rng As Object = bookmark.Range
    Dim bookmarkName As String = bookmark.Name

    bookmark.Range.Text = newText
    Me.Application.ActiveDocument.Bookmarks.Add(Name:=bookmarkName, Range:=rng)
End Sub

    object rng = bookmark.Range;
    string bookmarkName = bookmark.Name;

    bookmark.Range.Text = newText;

    Word.Document document = this.Application.ActiveDocument;
    document.Bookmarks.Add(bookmarkName, ref rng);
}

참고 항목

다음을 통해 공유