ContentControl الواجهة

مقالة
09/21/2010

يمثل محتوى عنصر تحكم مستند.

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

بناء الجملة

'إقرار
<GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")> _
Public Interface ContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("ee82979b-2814-48b1-95dd-4bfcc636a7ec")]
public interface ContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

ملاحظات

ContentControlالكائن هو عنصر تحكم mutable التي يمكن أن يمثل أي نوع من أنواع ثمانية عناصر تحكم المحتوى التي يمكن استخدامها في Microsoft المكتب الكلمة. على سبيل المثال، إذا قمت بإنشاء ContentControlذو الأداء الوظيفي للنص العادي بشكل مبدئي عنصر تحكم، يمكنك تغييره في وقت التشغيل حيث أنه يتصرف مثل صندوق تحرير وسرد. الأخرى محتوى لا يمكن استخدام عناصر التحكم بهذه الطريقة. ل مثال، RichTextContentControlيمكن فقط تمثل عنصر تحكم نص منسق. للحصول على مزيد من المعلومات حول محتوى عناصر التحكم، راجع عناصر تحكم المحتوى.

إلى إنشاء ContentControl، استخدم واحد AddContentControlالأساليب. لا يمكنك إضافة ContentControlإلى مستند في وقت التصميم.

عندما تقوم بإنشاء ContentControl، يجب تحديد نوع عنصر التحكم الذي تريده إلى إنشاء، أو فيمكنك إنشاء عنصر التحكم الجديد تشغيل موجودة محتويات عنصر تحكم. بعد قيامك بإنشاء ContentControl، يمكنك تغيير نوع عنصر تحكم المحتويات الذي يمثله بواسطة استخدام Typeخاصية.

بعض ContentControlالأعضاء سوف يقوم بطرح استثناء إذا استخدمت مع عنصر التحكم هو تعيينها إلى نوع من التحكم الذي هو غير معد للاستخدام في العضو. تشغيل سبيل المثال، DateCalendarTypeخاصية سوف يقوم بطرح استثناء عند محاولة إلى استخدامها تشغيل ContentControlالتي لا تمثل منتقي التاريخ.

ملاحظة

يتم تطبيق هذه الواجهة بواسطة Visual Studio Tools لوقت تشغيل Office. ولم يتم تصميمها لتطبيقها في التعليمة البرمجية الخاصة بك. لمزيد من المعلومات، راجع أدوات Visual Studio نظرة عامة وقت تشغيل Office.

الاستخدام

توضح هذه الوثائق الإصدار الخاص بهذا النوع المستخدم في مشاريع Office والذي يستهدف .NET Framework 4. وفي المشاريع التي تستهدف .NET Framework 3.5، قد يكون لدى هذا النوع أعضاء مختلفون وقد لا تعمل نماذج التعليمات البرمجية الخاصة بهذا النوع. للحصول على وثائق حول هذا النوع في المشاريع التي تستهدف .NET Framework 3.5، اطلع على جزء المرجع التالي في وثائق Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.