Document.Controls 속성

아티클
05/08/2013

문서에 포함된 관리되는 컨트롤의 컬렉션을 가져옵니다.

네임스페이스: Microsoft.Office.Tools.Word
어셈블리: Microsoft.Office.Tools.Word.v4.0.Utilities(Microsoft.Office.Tools.Word.v4.0.Utilities.dll)
Microsoft.Office.Tools.Word(Microsoft.Office.Tools.Word.dll)

구문

‘선언
ReadOnly Property Controls As ControlCollection

ControlCollection Controls { get; }

속성 값

형식: Microsoft.Office.Tools.Word.ControlCollection
문서의 관리되는 컨트롤을 모두 포함하는 ControlCollection입니다.

설명

Office 솔루션의 문서에는 Windows Forms 컨트롤과 호스트 컨트롤을 포함할 수 있습니다.자세한 내용은 Office 문서의 컨트롤을 참조하십시오.

런타임에 문서에서 컨트롤을 관리하려면 Controls 속성에서 반환되는 ControlCollection 개체의 메서드와 속성을 사용합니다.자세한 내용은 런타임에 Office 문서에 컨트롤 추가을 참조하십시오.

예제

다음 코드 예제에서는 첫 번째 단락에 텍스트를 추가하고 해당 단락을 포함하는 Bookmark 컨트롤을 만듭니다.그런 다음 문서에 있는 전체 컨트롤 수를 보여 주는 메시지 상자를 표시합니다.이 예제는 응용 프로그램 수준 추가 기능을 위한 것입니다.

Private Sub DocumentControls()
    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphAfter()
    vstoDoc.Paragraphs(1).Range.Text = "This is some sample text."
    vstoDoc.Controls.AddBookmark(vstoDoc.Paragraphs(1).Range, "Bookmark1")
    System.Windows.Forms.MessageBox.Show("Total number of controls: " & _
                                         vstoDoc.Controls.Count.ToString())
End Sub

private void DocumentControls()
{
    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphAfter();
    vstoDoc.Paragraphs[1].Range.Text = "This is some sample text.";
    vstoDoc.Controls.AddBookmark(vstoDoc.Paragraphs[1].Range, "Bookmark1");
    System.Windows.Forms.MessageBox.Show("Total number of controls: " +
        vstoDoc.Controls.Count.ToString());
}