مشاركة عبر

عناصر تحكم المحتوى

  • مقالة

ينطبق على

تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع.

نوع المشروع

  • مشروعات على مستوى المستند

  • مشروعات على مستوى التطبيق

إصدار Microsoft Office

  • Word 2007

  • Word 2010

عناصر تحكم المحتوى توفر طريقة لك لتصميم المستندات والقوالب التي تحتوي على هذه الميزات:

  • واجهة مستخدم (UI) التي بها إدخال مُتحكَم فيه مثل النموذج.

  • قيود تمنع المستخدمين من تحرير المقاطع المحمية من المستند أو القالب. للحصول على مزيد من المعلومات, راجع حماية أجزاء من المستندات عن طريق "استخدام عناصر تحكم المحتوى" .

  • ربط البيانات لمصدر البيانات. لمزيد من المعلومات، راجع ربط البيانات إلى "عناصر تحكم المحتوى" .

ارتباط إلى فيديو للعرض توضيحي فيديو ذات صلة، راجع ربط بيانات إلى الكلمة 2007 المحتوى عناصر التحكم استخدام ‏‫Visual Studio أدوات لنظام المكتب (3.0).

نظرة عامة حول عناصر تحكم المحتوي

توفر عناصر تحكم المحتوي واجهة مستخدم محسنة لكلٍ من إدخال و طباعة المستخدم. عندما تقوم بإضافة تعريف عنصر تحكم المحتوى إلى مستند، فإن عنصر التحكم يتم تعرّيفه بواسطة الحد و العنوان و النص المؤقت الذي يمكن أن يوفر إرشادات للمستخدم. الحد و العنوان لعناصر التحكم لا تظهر في الإصدارات المطبوعة للمستند.

على سبيل المثال، إذا كنت ترغب في أن يقوم المستخدم بإدخال تاريخ في مقطع من المستند الخاص بك يمكنك إضافة عنصر تحكم المحتوى "مُنتَقِي التاريخ" إلى المستند. عندما يقوم المستخدمون بالنقر فوق عنصر التحكم ،واجهة مستخدم منتقي التاريخ القياسية تظهر. يمكنك أيضاً تعيين خصائص عنصر التحكم لتعيين التقويم الإقليمي المعروض وتحديد تنسيق التاريخ. بعد أن يختار المستخدم تاريخا, يتم إخفاء واجهة المستخدم الخاصة بعنصر التحكم، و تظهر البيانات فقط إذا قام المستخدم بطباعة المستند.

عناصر تحكم المحتوي أيضاً تقوم بمساعدتك لتقوم بما يلي:

  • منع المستخدمين من تحرير أو حذف أجزاء من المستند. وهذا مفيد إذا كان لديك معلومات في مستند أو قالب يجب أن يتمكن المستخدمون من قراءتها ولكن ليس تحريرها, أو إذا كنت ترغب في أن يقوم المستخدمون بالتحرير في عناصر تحكم المحتوي ولكن عدم حذفها.

  • ربط الأجزاء من المستند أو القالب إلى البيانات. يمكنك ربط عناصر تحكم المحتوى إلى حقول قاعدة البيانات و الكائنات المدارة في .NET Framework ، و عناصر XML التي تم تخزينها في المستند و مصادر البيانات الأخرى.

في المشاريع علي مستوي المستند, يمكنك إضافة عناصر تحكم المحتوى إلى المستند في وقت التشغيل أو في وقت التصميم. في المشاريع على مستوى التطبيق، يمكنك إضافة عناصر تحكم محتويات إلى أي مستند مفتوح في وقت التشغيل. لمزيد من المعلومات، راجع كيفية القيام بما يلي: إضافة عناصر تحكم محتويات إلى مستندات Word.

ملاحظة

يمكنك استخدام عناصر تحكم المحتوى فقط في المستندات التي يتم حفظها في تنسيق XML مفتوح. لا يمكنك استخدام عناصر تحكم المحتوى في المستندات التي يتم حفظها في التنسيق (.doc) لمستند Word 97-2003.

أنواع عناصر تحكم المحتوى

هناك تسعة أنواع مختلفة من عناصر تحكم المحتوى التي يمكنك إضافة على مستندات. معظم المحتويات عناصر التحكم تحتوي على نوع المقابلة في Microsoft.Office.Tools.Wordمساحة الاسم. يمكنك أيضا استخدام عام ContentControl، الذي يمكن أن يمثل أي من المحتويات المتوفرة عناصر التحكم. للحصول على الإرشادات التفصيلية التي توضح كيفية استخدام كل من عناصر تحكم المحتوى المتوفرة, راجع الإرشادات التفصيلية: إنشاء قالب باستخدام عناصر تحكم محتوى.

معرض الكتل البرمجية الإنشائية

معرض الكتل البرمجية الإنشائية يسمح للمستخدمين بالتحديد من القائمة كتل إنشاء المستند للإدراج في مستند. مستند الكتل البرمجية الإنشائية هو جزء من المحتوى الذي تم إنشاؤه ليمكن استخدامه عدة مرات مثل صفحة غلاف شائعة أو جدول منسق أو عنوان. لمزيد من المعلومات، راجع النوع BuildingBlockGalleryContentControl. للحصول على مزيد من المعلومات حول الكتل البرمجية الإنشائية, راجع الجديد للمطورين في Word 2007.

خانة الاختيار

علامة صندوق يوفر واجهة مستخدم الذي يمثل الولاية ثنائي: أو إلغاء تحديدها. Th هو نوع عنصر تحكم المحتويات هو متوفرة فقط في الكلمة 2010.

بعكس غير ذلك أنواع عناصر تحكم المحتوى، Visual Studio Tools لوقت تشغيل Officeلا يوفر نوع معين الذي يمثل أحد خانة الاختيار محتويات عنصر التحكم. بمعنى آخر، فهناك لا CheckBoxContentControlنوع. ومع ذلك، يمكنك إنشاء علامة ما زال صندوق محتوى عنصر التحكم بواسطة إضافة عام ContentControlإلى مستند برمجياً. للحصول على مزيد من المعلومات، راجع التحقق من عناصر تحكم المحتوى صندوق في مشاريع 2010 الكلمة.

مربع التحرير والسرد

يعرض مربع التحرير والسرد قائمة العناصر التي يمكن للمستخدمين تحديدها. بعكس القائمة المنسدلة، مربع التحرير والسرد يمكّن المستخدمين من إضافة العناصر الخاصة بهم. لمزيد من المعلومات، راجع النوع ComboBoxContentControl.

منتقي التاريخ

يوفر منتقي التاريخ UI تقويم لتحديد تاريخ. يظهر التقويم عندما يقوم المستخدم بالنقر فوق سهم القائمة المنسدلة في عنصر التحكم. يمكنك استخدام تقويمات إقليمية و تنسيقات تاريخ مختلفة. لمزيد من المعلومات، راجع النوع DatePickerContentControl.

القائمة المنسدلة

تعرض القائمة المنسدلة قائمة من العناصر التي يمكن للمستخدمين تحديدها. بعكس مربع التحرير والسرد، لا تسمح القائمة المنسدلة للمستخدمين بإضافة عناصر أو تحريرها. لمزيد من المعلومات، راجع النوع DropDownListContentControl.

المجموعة

مجموعة عناصر التحكم تقوم بتعريف منطقة محمية من المستند لا يمكن للمستخدمين تحريرها أو حذفها. يمكن أن تحتوي مجموعة عنصر التحكم على أية عناصر مستند مثل النص، و الجداول ، و الرسومات وعناصر تحكم المحتوى الأخرى. لمزيد من المعلومات، راجع النوع GroupContentControl.

الصورة

عنصر تحكم الصورة يعرض صورة. يمكنك تحديد الصورة في وقت التصميم أو في وقت التشغيل، أو يمكن للمستخدمين النقر فوق عنصر التحكم هذا لتحديد صورة لإدراجها في المستند. لمزيد من المعلومات، راجع النوع PictureContentControl.

نص منسق (Rich Text)

عنصر تحكم النص المنسق يتضمن نصا أو عناصر أخرى مثل الجداول، أو الصور أو عناصر تحكم المحتوى الأخري. لمزيد من المعلومات، راجع النوع RichTextContentControl.

نص عادي

عنصر تحكم النص العادي يحتوي على نص. عنصر تحكم النص العادى لا يمكن أن يتضمن عناصر أخرى مثل الجداول، أو الصور أو عناصر تحكم المحتوى الأخري. بالإضافة إلى ذلك، النص بأكمله في النص العادي له نفس التنسيق. على سبيل المثال، إذا قمت بإمالة كلمة واحدة من الجملة الموجودة في عنصر تحكم النص العادي،كل النص الموجود داخل عنصر التحكم سيمال. لمزيد من المعلومات، راجع النوع PlainTextContentControl.

المحتوى العام عنصر تحكم

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

يمكنك إنشاء كائنات ContentControl فقط في وقت التشغيل وليس في وقت التصميم. لمزيد من المعلومات، راجع كيفية القيام بما يلي: إضافة عناصر تحكم محتويات إلى مستندات Word.

الميزات الشائعة لعناصر تحكم المحتوي

معظم عناصر تحكم المحتوى تشترك في مجموعة من الأعضاء التي يمكنك استخدامها لتنفيذ المهام الشائعة. يصف الجدول التالي بعض المهام التي يمكنك تنفيذها باستخدام هؤلاء الأعضاء.

لهذه المهمة:

قم بعمل:

الحصول علي أو تعيين النص الذي يتم عرضه في عنصر التحكم.

استخدم الخاصية Text.

ملاحظةملاحظة
أنواع PictureContentControl و ContentControl ليس لهم هذه الخاصية.

الحصول على أو تعيين النص المؤقت الذي يتم عرضه في عنصر التحكم إلى أن يقوم المستخدم بتحرير عنصر التحكم, عنصر التحكم يُملؤ بالبيانات من مصدر البيانات أو يتم حذف محتويات عنصر التحكم.

استخدم الخاصية PlaceholderText.

ملاحظةملاحظة
نوع PictureContentControl لا يحتوي علي هذه الخاصية.

الحصول علي أو تعيين العنوان المعروض في حد عنصر تحكم المحتوى عند قيام المستخدم بالنقر فوقه.

استخدم الخاصية Title.

إزالة عنصر التحكم من المستند تلقائياً بعدما يقوم المستخدم بعمليات التحرير. (النص الموجود في عنصر التحكم يبقى في المستند.)

استخدم الخاصية Temporary.

تشغيل التعليمة البرمجية عند نقر المستخدم فوق عنصر تحكم المحتوى أو عند انتقال المؤشر إلى عنصر تحكم المحتوى برمجياً.

معالجة حدث Entering لعنصر التحكم.

تشغيل تعليمة برمجية عند نقر المستخدم خارج عنصر تحكم المحتوى أو عند انتقال المؤشر خارج عنصر تحكم المحتوى برمجياً.

معالجة حدث Exiting لعنصر التحكم.

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

معالجة حدث Added لعنصر التحكم.

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

معالجة حدث Deleting لعنصر التحكم.

حماية أجزاء من المستند باستخدام عناصر تحكم المحتوى

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

إذا كانت المساحة التي ترغب في حمايتها داخل عنصر تحكم المحتوي, يمكنك استخدام خصائص عنصر تحكم المحتوى لمنع المستخدمين من تحرير أو حذف عنصر التحكم:

  • خاصية LockContents تمنع المستخدمين من تحرير المحتويات.

  • خاصية LockContentControl تمنع المستخدمين من حذف عنصر التحكم.

إذا لم تكن المساحة التي تريد حمايتها داخل عنصر تحكم المحتوي أو تريد حماية مساحة تحتوي علي عنصر تحكم المحتوي و أنواع أخري من المحتوى، يمكنك وضع المنطقة بأكملها في GroupContentControl. بعكس عناصر تحكم المحتوى الأخرى ، GroupContentControl لا توفر واجهة مستخدم مرئية للمستخدم. الغرض الوحيد منها هو تعريف المنطقة التي لا يمكن للمستخدمين تحريرها.

ملاحظة

إذا قمت بإنشاء GroupContentControl التي تحتوي على عناصر تحكم المحتوي المضمنة, لا يتم حماية عناصر تحكم المحتوي المضمنة تلقائياً. يجب عليك استخدام خاصية LockContents لكل عنصر تحكم مضمن لمنع المستخدمين من تحرير المحتويات الخاصة بهم.

للحصول على مزيد من المعلومات حول كيفية استخدام عناصر تحكم المحتوى لحماية أجزاء من المستندات, راجع كيفية القيام بما يلي: حماية أجزاء من المستند باستخدام عناصر تحكم المحتوى.

ربط البيانات بعناصر تحكم المحتوى

يمكنك عرض البيانات في المستندات بواسطة ربط عنصر تحكم المحتوى بمصدر البيانات. عند تحديث مصدر البيانات، يقوم عنصر تحكم المحتوى بإظهار التغييرات. يمكنك أيضاً حفظ التغييرات لمصدر البيانات.

عناصر تحكم المحتوى توفر خيارات ربط البيانات التالية:

  • يمكنك ربط عناصر تحكم المحتوى لقاعدة بيانات الحقول أو الكائنات التي تمت إدارتها باستخدام نفس نموذج ربط البيانات مثل Windows Forms.

  • يمكنك ربط عناصر تحكم المحتوي بالعناصر في أجزاء XML (تسمى أيضاً أجزاء XML مخصصة ) المضمنة في المستند.

للحصول على نظرة عامة حول ربط عناصر التحكم المضيف في حلول Office بالبيانات، راجع ربط بيانات إلى عناصر تحكم في حلول Office.

استخدام Windows Form Forms لربط البيانات

معظم عناصر تحكم المحتوي تدعم نموذج ربط البيانات البسيطة الذي يستخدمه Windows Forms. ربط البيانات البسيط يعني أن عنصر التحكم يرتبط بعنصر بيانات مفرد مثل قيمة في عمود من جدول البيانات. لمزيد من المعلومات، راجع ربط البيانات "و" نماذج Windows.

في مشاريع علي مستوي المستند يمكنك ربط البيانات إلى عناصر تحكم المحتوى باستخدام النافذة مصادر البيانات في Visual Studio. لمزيد من المعلومات حول كيفية إضافة عناصر تحكم محتوى مرتبطة ببيانات إلى المستندات راجع كيفية القيام بما يلي: نشر المستندات بالبيانات من قاعدة بيانات و كيفية القيام بما يلي: نشر مستندات مع بيانات من كائنات.

يسرد الجدول التالي عناصر تحكم المحتوى الذي يمكنك ربطه بكل نوع بيانات في النافذة مصادر البيانات .

نوع البيانات

عنصر تحكم المحتوى الافتراضي

عناصر تحكم محتوى أخرى يمكن ربطها بنوع البيانات هذا

Boolean

Byte

Char

Double

Enum

Guid

Int16

Int32

Int64

SByte

Single

String

TimeSpan

UInt16

UInt32

UInt64

PlainTextContentControl

BuildingBlockGalleryContentControl

ComboBoxContentControl

DatePickerContentControl

RichTextContentControl

DateTime

DatePickerContentControl

BuildingBlockGalleryContentControl

ComboBoxContentControl

PlainTextContentControl

RichTextContentControl

Image

مصفوفة Byte

PictureContentControl

لا يوجد

في مشاريع علي مستوي المستند وعلى مستوى التطبيق يمكنك ربط عنصر تحكم المحتوى إلى مصدر بيانات برمجياً باستخدام الأسلوب Add() من الخاصية DataBindings لعنصر التحكم. إذا قمت بذلك، مرر السلسلة نص للمعلمة propertyName من الأسلوب Add(). الخاصية Textهي خاصية ربط البيانات الافتراضية لعناصر تحكم المحتوى.

عناصر تحكم المحتوى أيضاً تدعم ربط البيانات ثنائي الاتجاه، حيث التغييرات في عنصر التحكم يتم تحديثها إلى مصدر البيانات. لمزيد من المعلومات، راجع كيفية القيام بما يلي: تحديث مصدر بيانات ببيانات من عنصر تحكم مضيف.

ملاحظة

عناصر تحكم المحتوى لا تعتمد عناصر معقدة لربط. البيانات في حالة ربط DropDownListContentControl أو ComboBoxContentControl إلى مصدر بيانات باستخدام نموذج بيانات Windows Forms، سوف يظهر للمستخدمين قيمة واحدة فقط عند النقر فوق عنصر التحكم. إذا كنت ترغب في ربط عناصر التحكم هذه إلى مجموعة من قيم البيانات التي يمكن للمستخدمين الاختيار من بينها، يمكنك ربط عناصر التحكم هذه في جزء XML مخصص.

ربط عناصر تحكم المحتوي إلى أجزاء XML مخصصة

يمكنك ربط بعض عناصر تحكم المحتوى إلى عناصر في أجزاء XML المخصصة المضمنة في المستند. لمزيد من المعلومات حول أجزاء XML المخصصة، راجع نظرة عامة على أجزاء XML.

لربط عنصر تحكم محتوى إلى عنصر في جزء XML مخصص، استخدم الخاصية XMLMapping من عنصر التحكم. يوضح مثال التعليمة البرمجية التالي كيفية ربط PlainTextContentControl إلى عنصر Price ضمن العقدة Product في جزء XML المخصص الذي تمت إضافته بالفعل إلى المستند.

plainTextContentControl1.XMLMapping.SetMapping("/Product/Price")

plainTextContentControl1.XMLMapping.SetMapping("/Product/Price", String.Empty, null);

للحصول على الإرشادات التفصيلية التي توضح كيفية ربط عناصر المحتوي إلى أجزاء XML المخصصة بمزيد من التفاصيل, راجع الإرشادات التفصيلية: ربط عناصر تحكم المحتوي إلى أجزاء XML مخصصة.

عند ربطك عنصر تحكم محتوى إلى جزء XML مخصص، ربط البيانات ثنائي الاتجاه ممكّن تلقائياً. إذا قام مستخدم بتحرير نص في عنصر التحكم, يتم تلقائياً تحديث عناصر XML المقابلة. وبشكل مماثل، إذا تم تغيير قيم العناصر في أجزاء XML المخصصة، فإن عناصر تحكم المحتوي المنضمة إلى عناصر XML ستعرض البيانات الجديدة.

يمكنك ربط الأنواع التالية من عناصر تحكم المحتوى إلى أجزاء XML المخصصة:

أحداث ربط البيانات لعناصر تحكم المحتوى

كل عناصر تحكم المحتوي توفر مجموعة من الأحداث التي يمكنك معالجتها لتنفيذ مهام ذات الصلة بالبيانات مثل التحقق من أن النص في عنصر التحكم يحقق معايير معينة قبل تحديث مصدر البيانات. يسرد الجدول التالي أحداث عنصر تحكم المحتوى التي تتعلق بربط. البيانات

المهمة

الحدث

تشغيل التعليمة البرمجية قبل أن يقوم Word تلقائياً بتحديث النص في عنصر تحكم المحتوى المنضم إلى جزء XML مخصص.

ContentUpdating

تشغيل التعليمة البرمجية قبل أن يقوم Word تلقائياً بتحديث البيانات في جزء XML مخصص يرتبط بعنصر تحكم المحتوى (أي بعد تغيير النص في عنصر تحكم المحتوى).

StoreUpdating

تشغيل التعليمة البرمجية الخاصة بك للتحقق من صحة المحتويات في عنصر التحكم استناداً إلى معايير مخصصة.

Validating

تشغيل التعليمة البرمجية بعد أن تم بنجاح التحقق من صحة محتويات عنصر تحكم المحتوي.

Validated

قيود عنصر تحكم المحتوي

عند استخدامك عناصر تحكم المحتوى في مشاريع Office الخاصة بك كن على علم بالحدود التالية.

اختلافات السلوك بين وقت التصميم و وقت التشغيل

العديد من القيود التي يفرضها Microsoft Office Word على عناصر تحكم المحتوى في وقت التشغيل لا يتم فرضها في وقت التصميم. عند تصميمك واجهة المستخدم من حل علي مستوي المستند في Visual Studio ، تأكد من تعديل عناصر تحكم المحتوى فقط بالطرق التي يتم دعمها في وقت التشغيل.

إذا قمت بتعديل عنصر تحكم محتوى في وقت التصميم بطريقة لا يعتمد عليها عنصر التحكم في وقت التشغيل، فإن مصمم Visual Studio لن ينبهك للتغييرات الغير المعتمدة. ومع ذلك، عند التصحيح أو تشغيل المشروع أو إذا قمت بحفظ ثم إعادة فتح المشروع, سوف يعرض Word رسالة خطأ و يطلب إذن لإصلاح المستند. عندما تقوم بإصلاح المستند يزيل Word كافة المحتويات والتنسيقات الغير المعتمدة من عنصر التحكم.

على سبيل المثال، Word لا يمنعك من إضافة جدول لـ PlainTextContentControl في وقت التصميم. ومع ذلك، فلأن كائنات PlainTextContentControl لا يمكن أن تحتوي على جداول في وقت التشغيل، سوف يعرض Word رسالة خطأ عند فتح المستند.

لاحظ أيضاً أن العديد من الخصائص التي تعرّف سلوك عناصر تحكم المحتوى ليس لها أي تأثير في وقت التصميم. على سبيل المثال، إذا قمت بتعيين خاصية LockContents من عنصر تحكم المحتوى إلى True في وقت التصميم، مازال يمكنك تحرير النص في عنصر التحكم في المصمم Visual Studio. هذه الخاصية فقط تمنع المستخدمين من تحرير عنصر التحكم في وقت التشغيل.

قيود الحدث

عناصر تحكم المحتوى لا توفر أي حدث يتم رفعه عندما يقوم المستخدم بتغيير النص أو العناصر الأخرى في عنصر التحكم. على سبيل المثال،لا يتم رفع حدث عندما يحدد المستخدم عنصراً آخر في DropDownListContentControl أو ComboBoxContentControl.

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

تحقق من عناصر تحكم المحتوى صندوق في الكلمة مشاريع 2010

Visual Studio Tools لوقت تشغيل Officeلا يوفر CheckBoxContentControlالنوع. لإنشاء فحص عنصر تحكم المحتوى في مشروع الكلمة 2010، استخدم AddContentControlالأسلوب لإنشاء ContentControlالكائن، وتمرير WdContentControltype.wdContentControlCheckBoxالقيمة إلى الأسلوب لتعيين فحص صندوق عنصر تحكم المحتوى. يوضح مثال التعليمات البرمجية التالي كيفية القيام بذلك.

Me.Paragraphs(1).Range.InsertParagraphBefore()
Me.Paragraphs(1).Range.Select()
Dim checkBoxControl1 As Microsoft.Office.Tools.Word.ContentControl =
    Me.Controls.AddContentControl("checkBoxControl1", Word.WdContentControlType.wdContentControlCheckBox)

' The following line of code compiles in projects that target the .NET Framework 4, but it does not compile 
' in projects that target the .NET Framework 3.5.
checkBoxControl1.Checked = True

' In projects that target the .NET Framework 3.5, use the following code.
checkBoxControl1.InnerObject.Checked = True

this.Paragraphs[1].Range.InsertParagraphBefore();
this.Paragraphs[1].Range.Select();
Microsoft.Office.Tools.Word.ContentControl checkBoxControl1 = 
    this.Controls.AddContentControl("checkBoxControl1", Word.WdContentControlType.wdContentControlCheckBox);

// The following line of code compiles in projects that target the .NET Framework 4, but it does not compile 
// in projects that target the .NET Framework 3.5.
checkBoxControl1.Checked = true;

// In projects that target the .NET Framework 3.5, use the following code.
checkBoxControl1.InnerObject.Checked = true;

ملاحظة

Checkedخاصية لعناصر تحكم المحتوى خانة اختيار يمكن أن تستخدم مباشرة فقط في مشاريع من هذا الهدف .NET Framework 4. في مشاريع التي تستهدف 3.5 إطار عمل.NET، يجب استخدام InnerObjectالخصائص للوصول إلى Checkedخاصية الأساسية Microsoft.Office.Interop.Word.ContentControlالكائن. لمزيد من المعلومات، راجع القيود البرمجية للعناصر مضيفة وعناصر التحكم.

راجع أيضًا:

المهام

كيفية القيام بما يلي: إضافة عناصر تحكم محتويات إلى مستندات Word

الإرشادات التفصيلية: إنشاء قالب باستخدام عناصر تحكم محتوى

المبادئ

أتمتة Word عن طريق استخدام الكائنات الموسعة

القيود البرمجية للعناصر مضيفة وعناصر التحكم

موارد أخرى

البيانات في حلول Office

ربط بيانات إلى عناصر تحكم في حلول Office