책갈피 컨트롤

아티클
08/10/2011

Microsoft.Office.Tools.Word.Bookmark 컨트롤은 고유한 이름을 가지며 이벤트를 노출하고 데이터에 바인딩될 수 있는 책갈피입니다. 책갈피를 자리 표시자로 사용하면 Microsoft Office Word 문서에서 항목이나 위치를 표시할 수 있습니다. Microsoft.Office.Tools.Word.Bookmark 컨트롤은 Microsoft.Office.Interop.Word.Bookmark 개체와 Microsoft.Office.Interop.Word.Range 개체의 조합입니다.

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

문서 수준 프로젝트에서는 디자인 타임이나 런타임에 문서에 Microsoft.Office.Tools.Word.Bookmark 컨트롤을 추가할 수 있습니다. 응용 프로그램 수준 프로젝트에서는 런타임에 열려 있는 문서에 Microsoft.Office.Tools.Word.Bookmark 컨트롤을 추가할 수 있습니다. 자세한 내용은 방법: Word 문서에 책갈피 컨트롤 추가를 참조하십시오.

컨트롤에 데이터 바인딩

Microsoft.Office.Tools.Word.Bookmark 컨트롤은 단순 데이터 바인딩을 지원합니다. 책갈피는 DataBindings 속성을 사용하여 데이터 소스에 바인딩해야 합니다. 책갈피의 기본 데이터 바인딩 속성은 Text 속성입니다.

바인딩된 데이터 집합의 데이터가 업데이트되면 Microsoft.Office.Tools.Word.Bookmark 컨트롤이 변경 내용을 반영합니다.

문서 수준 프로젝트에서는 데이터 소스 창을 사용하여 책갈피에 데이터를 바인딩할 수도 있습니다. 자세한 내용은 방법: 개체의 데이터로 문서 채우기를 참조하십시오.

서식 지정

Microsoft.Office.Interop.Word.Bookmark에 적용할 수 있는 형식은 Microsoft.Office.Tools.Word.Bookmark 컨트롤에도 적용할 수 있습니다. 여기에는 글꼴, 들여쓰기, 간격, 번호 매기기 및 스타일이 포함됩니다.

책갈피에 텍스트 할당

Microsoft.Office.Interop.Word.Bookmark 개체와 Microsoft.Office.Tools.Word.Bookmark 컨트롤 사이의 또 다른 차이점은 책갈피에 텍스트를 할당할 때의 동작 방식에 있습니다. 길이가 0인 Microsoft.Office.Interop.Word.Bookmark에 텍스트를 할당하면 텍스트가 책갈피 오른쪽에 추가되고 책갈피의 길이는 0으로 유지됩니다. 그러나 길이가 0인 Microsoft.Office.Tools.Word.Bookmark에 텍스트를 할당하면 텍스트가 책갈피에 삽입되고 이 텍스트의 총 문자 수만큼 책갈피의 길이가 늘어납니다.

Microsoft.Office.Tools.Word.Bookmark 컨트롤에는 Bookmark.Text 속성도 포함되어 있습니다. 이는 Microsoft.Office.Tools.Word.Bookmark 컨트롤의 Range 속성 또는 Microsoft.Office.Interop.Word.Bookmark 개체의 Range 속성에서 사용할 수 있는 Range.Text 속성과 다릅니다.

Text 속성	설명
Bookmark.Text	이 속성은 책갈피 내의 텍스트를 표시하고 책갈피를 문서에 유지하는 데 사용됩니다. 책갈피에 텍스트를 할당하면 책갈피 범위가 확장되고 책갈피가 삭제되지 않습니다. 예를 들어, Bookmark1.Text = "Hello world"는 책갈피에 텍스트를 삽입하고 책갈피를 그대로 유지합니다.
Range.Text	이 속성은 책갈피 위치에 텍스트를 표시하고 책갈피를 자동으로 삭제하는 데 사용됩니다. 예를 들어, Bookmark1.Range.Text = "Hello world"는 책갈피에 텍스트를 삽입하고 책갈피를 삭제합니다.

Bookmark.Text

이 속성은 책갈피 내의 텍스트를 표시하고 책갈피를 문서에 유지하는 데 사용됩니다. 책갈피에 텍스트를 할당하면 책갈피 범위가 확장되고 책갈피가 삭제되지 않습니다.

예를 들어, Bookmark1.Text = "Hello world"는 책갈피에 텍스트를 삽입하고 책갈피를 그대로 유지합니다.

Range.Text

이 속성은 책갈피 위치에 텍스트를 표시하고 책갈피를 자동으로 삭제하는 데 사용됩니다. 예를 들어, Bookmark1.Range.Text = "Hello world"는 책갈피에 텍스트를 삽입하고 책갈피를 삭제합니다.

디자인 타임에 컨트롤 이름 바꾸기

문서 수준 프로젝트에서는 Microsoft.Office.Tools.Word.Bookmark 컨트롤을 도구 상자에서 문서에 끌어 놓으면 컨트롤의 이름이 자동으로 생성됩니다. 속성 창에서 컨트롤의 이름을 변경할 수 있습니다.

컨트롤 겹침

Bookmark 컨트롤은 서로 겹칠 수 있습니다. 즉, 여러 책갈피에서 동일한 텍스트를 공유할 수 있습니다. 겹친 책갈피 중 하나에 새 텍스트를 할당하면 이 책갈피에는 새 텍스트만 포함되고 이 책갈피는 이제 겹치지 않게 됩니다. 다른 책갈피에는 이전에 겹치던 책갈피와 공유하지 않은 텍스트만 포함됩니다.

다음 표에서는 "This is sample text."라는 문장이 두 개의 겹치는 책갈피 사이에 공유되는 방식을 보여 줍니다.

책갈피	Text
겹치는 책갈피	[this is {sample] text.}
Bookmark1	This is sample
Bookmark2	sample text.

Bookmark1에 "This is replacement."라는 새 텍스트를 할당하면 이 책갈피가 이제 겹치지 않게 되고 Bookmark2에는 Bookmark1의 일부로 포함되지 않았던 텍스트만 남게 됩니다.

책갈피	Text
두 개의 개별 책갈피	[this is replacement]{ text.}
Bookmark1	This is replacement
Bookmark2	text.

한 책갈피가 다른 책갈피 내에 완전히 포함되어 있는 상태에서 외부 책갈피의 텍스트를 변경해도 내부 책갈피가 삭제되지 않습니다. 그러나 내부 책갈피는 빈 책갈피가 되며 외부 책갈피의 끝으로 이동됩니다. 다음 표에서는 "This is sample text."라는 문장이 다른 책갈피 내에 포함된 책갈피에 의해 공유되는 방식을 보여 줍니다.

책갈피	Text
겹치는 책갈피	[this is {sample} text.]
Bookmark1	This is sample text.
Bookmark2	sample

Bookmark1에 "This is replacement."라는 새 텍스트를 할당하면 이 책갈피가 이제 겹치지 않게 되고 Bookmark2는 빈 책갈피가 되며 Bookmark1의 끝에 위치하게 됩니다.

책갈피	Text
두 개의 개별 책갈피	[this is replacement.]{}
Bookmark1	This is replacement.
Bookmark2	<empty>

이벤트

Microsoft.Office.Tools.Word.Bookmark 컨트롤에 사용할 수 있는 이벤트는 다음과 같습니다.

참고 항목

다음을 통해 공유