책갈피 컨트롤
Bookmark 컨트롤은 고유한 이름이 있고 이벤트를 노출하며 데이터에 바인딩될 수 있는 책갈피입니다. 책갈피는 Microsoft Office Word 문서에서 항목 또는 위치를 표시하는 자리 표시자로 사용할 수 있습니다. Bookmark 컨트롤은 Bookmark 개체 및 Range 개체의 조합입니다.
적용 대상: 이 항목의 정보는 Word의 문서 수준 프로젝트 및 VSTO 추가 기능 프로젝트에 적용됩니다. 자세한 내용은 Office 애플리케이션 및 프로젝트 형식에 따라 사용 가능한 기능을 참조하세요.
문서 수준 프로젝트에서는 디자인 타임 또는 런타임에 Bookmark 컨트롤을 문서에 추가할 수 있습니다. VSTO 추가 기능 프로젝트에서는 런타임에 열려 있는 임의 문서에 Bookmark 컨트롤을 추가할 수 있습니다. 자세한 내용은 방법: Word 문서에 Bookmark 컨트롤 추가를 참조하세요.
컨트롤에 데이터 바인딩
Bookmark 컨트롤은 단순 데이터 바인딩을 지원합니다. 책갈피는 DataBindings 속성을 사용하여 데이터 원본에 바인딩해야 합니다. 책갈피의 기본 데이터 바인딩 속성은 Text 속성입니다.
바인딩된 데이터 세트의 데이터가 업데이트되면 Bookmark 컨트롤이 변경 내용을 보여 줍니다.
문서 수준 프로젝트에서 데이터 원본 창을 사용하여 데이터를 책갈피에 바인딩할 수 있습니다. 자세한 내용은 방법: 개체의 데이터로 문서 채우기를 참조하세요.
서식
Bookmark 에 적용할 수 있는 서식은 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 컨트롤의 Bookmark.Range 속성에서 사용할 수 있는 Range.Text 속성 또는 Microsoft.Office.Interop.Word.Bookmark 개체의 Bookmark.Range 속성과 다릅니다.
| Text 속성 | 설명 |
|---|---|
| Bookmark.Text | 이 속성을 사용하여 텍스트를 책갈피 안에 표시하고 문서에 책갈피를 남겨 둡니다. 텍스트를 책갈피에 할당하면 책갈피 범위를 확장하고 책갈피를 삭제하지 않습니다. 예를 들어 Bookmark1.Text = "Hello world" 는 텍스트를 책갈피에 삽입하고 책갈피를 그대로 둡니다. |
| Range.Text | 이 속성을 사용하여 책갈피 위치에 텍스트를 표시하고 책갈피를 자동으로 삭제합니다. 예를 들어 Bookmark1.Range.Text = "Hello world" 는 책갈피에 텍스트를 삽입하고 책갈피를 삭제합니다. |
디자인 타임에 컨트롤 이름 바꾸기
문서 수준 프로젝트에서 Bookmark 컨트롤을 도구 상자 에서 문서로 끌어 놓으면 Visual Studio가 자동으로 컨트롤의 이름을 생성합니다. 속성 창에서 컨트롤의 이름을 변경할 수 있습니다.
컨트롤 겹침
Bookmark 컨트롤은 서로 겹칠 수 있습니다. 둘 이상의 책갈피에서 동일한 텍스트를 공유할 수 있습니다. 겹치는 책갈피 중 하나에 새 텍스트를 할당하면 새 텍스트만 포함하고 책갈피는 더 이상 겹치지 않게 됩니다. 이제 다른 책갈피는 원래 겹치는 책갈피 간에 공유하지 않은 텍스트만 포함합니다.
다음 표에서는 두 개의 겹치는 책갈피에서 "This is sample text."라는 문장을 공유하는 방법을 보여 줍니다.
| 책갈피 | Text |
|---|---|
| 겹치는 책갈피 | [this is {sample] text.} |
| 책갈피1 | This is sample |
| 책갈피2 | sample text. |
새 텍스트인 "This is replacement."를 Bookmark1에 할당하면 책갈피가 겹치지 않으며 Bookmark2는 원래 Bookmark1의 일부가 아닌 텍스트만 유지합니다.
| 책갈피 | Text |
|---|---|
| 별도의 두 책갈피 | [this is replacement]{ text.} |
| 책갈피1 | This is replacement |
| 책갈피2 | 텍스트. |
다른 책갈피가 포함된 책갈피의 텍스트를 변경하면 내부 책갈피가 삭제되지 않습니다. 그러나 내부 책갈피는 빈 책갈피가 되어 외부 책갈피 끝으로 이동합니다.
다음 표에서는 "This is sample text."라는 문장이 다른 책갈피에 포함된 책갈피에서 어떻게 공유되는지 보여 줍니다.
| 책갈피 | Text |
|---|---|
| 겹치는 책갈피 | [this is {sample} text.] |
| 책갈피1 | This is sample text. |
| 책갈피2 | sample |
새 텍스트인 "This is replacement."를 Bookmark1에 할당하면 책갈피가 더 이상 겹치지 않고 Bookmark2는 Bookmark1 끝에 있는 빈 책갈피가 됩니다.
| 책갈피 | Text |
|---|---|
| 별도의 두 책갈피 | [this is replacement.]{} |
| 책갈피1 | This is replacement. |
| 책갈피2 | <empty> |
이벤트
Bookmark 컨트롤에 대해 다음 이벤트를 사용할 수 있습니다.