Document.Controls الخاصية

مقالة
09/21/2010

يحصل تشغيل المجموعة من مدارة عناصر التحكم الموجودة في مستند.

مساحة الاسم: Microsoft.Office.Tools.Word
التجميع: Microsoft.Office.Tools.Word (في Microsoft.Office.Tools.Word.dll)

بناء الجملة

'إقرار
ReadOnly Property Controls As ControlCollection
    Get

ControlCollection Controls { get; }

قيمة الخاصية

النوع: Microsoft.Office.Tools.Word.ControlCollection
ControlCollectionالتي تحتوي تشغيل الجميع عناصر التحكم التي تتم إدارتها تشغيل مستند.

ملاحظات

يمكن أن يحتوي مستند في الحلول المكتب على Windows Forms عناصر التحكم والمضيف عناصر التحكم. لمزيد من المعلومات، راجع عناصر التحكم الموجودة في مستندات Office.

إلى إدارة عناصر التحكم الموجودة في مستند أثناء وقت التشغيل، استخدم وظائف وخصائص ControlCollectionكائن تم إرجاعه بواسطة Controlsخاصية. لمزيد من المعلومات، راجع إضافة عناصر إلى مستندات Office في وقت التشغيل.

أمثلة

إضافة نص إلى الفقرة الأولى مثال التعليمة البرمجية التالية وقم بإنشاء عنصر Bookmarkعنصر التحكم الذي يشمل فقرة. تعليمات برمجية ثم يظهر صندوق رسالة يعرض العدد الإجمالي ل cتشغيلtrols تشغيل مستند. Th هو المثال هو للوظيفة الإضافية المستوى تطبيق.

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.

الثقة الكاملة للمتصل الفوري. يتعذر استخدام هذا العضو بواسطة التعليمات البرمجية الموثوق بها جزئيًا. لمزيد من المعلومات، راجع باستخدام مكتبات من تعليمات برمجية موثوق بها جزئي.