Document.Controls 속성 (2007 시스템)

아티클
08/22/2008

업데이트: 2008년 7월

문서에 포함된 모든 Windows Forms 컨트롤 및 호스트 컨트롤의 컬렉션을 가져옵니다.

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

구문

<BrowsableAttribute(False)> _
Public Overridable ReadOnly Property Controls As ControlCollection

Dim instance As Document
Dim value As ControlCollection

value = instance.Controls

[BrowsableAttribute(false)]
public virtual ControlCollection Controls { get; }

속성 값

형식: Microsoft.Office.Tools.Word.ControlCollection

문서에 포함된 모든 Windows Forms 컨트롤 및 호스트 컨트롤이 들어 있는 ControlCollection입니다.

설명

Visual Studio Tools for Office에서 Windows Forms 컨트롤 및 호스트 컨트롤을 표시할 수 있는 문서 수준 사용자 지정의 일부인 문서입니다. 자세한 내용은 Office 문서의 컨트롤을 참조하십시오.

문서에 여러 컨트롤을 추가할 경우 각 컨트롤은 문서에 대한 ControlCollection의 멤버가 됩니다.

ControlCollection 클래스에서 사용할 수 있는 메서드를 사용하여 컨트롤을 ControlCollection에 추가하거나 제거할 수 있습니다. 자세한 내용은 런타임에 Office 문서에 컨트롤 추가를 참조하십시오.

예제

다음 코드 예제에서는 첫 번째 단락에 텍스트를 추가하고 해당 단락을 포함하는 Bookmark 컨트롤을 만듭니다. 그런 다음 문서에 있는 전체 컨트롤 수를 보여 주는 메시지 상자를 표시합니다.

이 버전은 문서 수준 사용자 지정을 위한 것입니다.

Private Sub DocumentControls()
    Me.Paragraphs(1).Range.InsertParagraphAfter()
    Me.Paragraphs(1).Range.Text = "This is some sample text."
    Me.Controls.AddBookmark(Me.Paragraphs(1).Range, "Bookmark1")
    MessageBox.Show("Total number of controls: " & Me.Controls.Count.ToString())
End Sub

private void DocumentControls()
{
    this.Paragraphs[1].Range.InsertParagraphAfter();
    this.Paragraphs[1].Range.Text = "This is some sample text.";
    this.Controls.AddBookmark(this.Paragraphs[1].Range, "Bookmark1");
    MessageBox.Show("Total number of controls: " +
        this.Controls.Count.ToString());
}

이 버전은 응용 프로그램 수준 추가 기능을 위한 것입니다.

Private Sub DocumentControls()
    Dim vstoDoc As Document = Me.Application.ActiveDocument.GetVstoObject()
    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 = this.Application.ActiveDocument.GetVstoObject();
    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());
}