Document.Controls 屬性
取得文件中包含的 Managed 控制項集合。
命名空間: 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 ,包含文件全部的 Managed 控制項。
備註
Office 方案中的文件可以包含 Windows Form 控制項和主控制項。如需詳細資訊,請參閱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());
}
.NET Framework 安全性
- 完全信任立即呼叫者。這個成員無法供部分信任的程式碼使用。如需詳細資訊,請參閱從部分受信任程式碼使用程式庫。
請參閱
參考
Microsoft.Office.Tools.Word 命名空間