قيود عناصر تحكم Windows Forms على مستندات Office
ينطبق على |
|---|
|
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع
إصدار Microsoft Office
|
توجد بعض الاختلافات بين عناصر تحكم Windows Forms التي تمت إضافتها إلى مستندات Microsoft Office Word أو أوراق عمل Microsoft Office Excel و عناصر تحكم Windows Forms التي تم إضافتها إلى Windows Forms. على سبيل المثال, عند إضافة عنصر تحكم Button إلى مستند ,الخصائص مثل Dock ، Anchor ، و TabIndex لا تتصرف كما هو متوقع.
العديد من هذه الاختلافات تحدث بسبب الطريقة التى يتم بها استضافة عنصر تحكم Windows Forms على المستندات. عند إضافة عنصر تحكم Windows Forms إلى مستند ، Visual Studio Tools لوقت تشغيل Office يضمّن عنصر تحكم ActiveX الذي يستضيف عناصر تحكم Windows Form في المستند. عنصر تحكم Windows Forms لا يتم تضمينه بشكل مباشر من المستند.
تقييدات على أساليب وخصائص تحكم Windows Forms.
هناك عدد من أساليب وخصائص عناصر تحكم Windows Forms لا تعمل بنفس الطريقة على المستند كما تعمل على Windows Form و لذلك، فمن المستحسن أن لا يتم استخدامها. على سبيل المثال، إعداد الخصائص مثل Dock و Anchor يؤثر فقط على موضع عنصر التحكم فيما يتعلق بعنصر تحكم ActiveX الحاوية بدلاً من المستند. القائمة التالية هي خصائص وأساليب غير معتمدة لعناصر تحكم Windows Forms الخاصة Word و Excel:
أساليب وخصائص غير معتمدة من عناصر تحكم Excel:
Anchor
Dock
Location
TabIndex
TabStop
TopLevelControl
أساليب وخصائص غير معتمدة من عناصر تحكم Word:
Hide
Show
Anchor
Dock
Location
TabIndex
TabStop
TopLevelControl
Visible
كما لا يمكنك تعيين خاصية Left أو Top من عناصر تحكم Windows Forms الذى على نفس الخط مع النص على مستند Word. يتم إضافة عناصر تحكم Windows Forms التى في نفس السطر مع النص في الحالات التالية:
يمكنك برمجياً أصافة عنصر تحكم إلى مستند Word واستخدام أسلوب لتحديد نطاق الموقع. لمزيد من المعلومات، راجع الأساليب المساعدة لعناصر تحكم Windows Forms.
تقوم بإضافة عنصر تحكم Windows Forms إلى مستند Word في وقت التصميم. يمكنك تغيير ذلك بواسطة تعديل عنصر التحكم في التصميم. لمزيد من المعلومات، راجع استخدام عناصر تحكم Windows Forms في مستندات Word.
الاختلافات في عناصر تحكم Windows Forms في مستندات Office
بشكل عام عناصر تحكم Windows Forms لديها نفس السلوك على مستند Office كما هى على Windows Form ولكن توجد بعض الاختلافات. يصف الجدول التالي الاختلافات الموجودة في عناصر تحكم Windows Form الموجودة في مستندات Office.
الوظائف |
الاختلاف |
|---|---|
ترتيب تبويب عنصر التحكم |
لا يمكنك التبويب خلال عناصر التحكم في ورقة عمل Excel أو مستند Word. |
تجميع عناصر التحكم |
لا يمكنك استخدام عناصر تحكم GroupBox لتحتوي على عناصر التحكم الأخرى الموجودة مستند Office. عندما تقوم بإضافة أزرار الخيارات المتعددة مباشرةً إلى المستند, لا تستبعد الأزرار التبادلية بعضها بعضاً. يمكنك كتابة تعليمات برمجية لجعل أزرار التبادلية يستبعد بعضها بعضاً; و مع ذلك، يعتبر الأسلوب المفضل هو إضافة الأزرار التبادلية إلى عنصر تحكم المستخدم و إضافة عنصر تحكم المستخدم إلى المستند. لمزيد من المعلومات، راجع نموذج عناصر تحكم Word أو نموذج عناصر تحكم Excel في نماذج تطوير Office وإرشادات تفصيلية. |
نوع عنصر تحكم |
عناصر تحكم Windows Forms المستخدمة في المستندات تُلف في الفئة التى يتم توفيرها بواسطة Visual Studio Tools لوقت تشغيل Office الذى يعطي عناصر التحكم وظيفة إضافية خاصة بورقة عمل Excel أو مستند Word. على سبيل المثال، إذا كان لديك عنصر تحكم Button الموجود في ورقة عمل Excel ، تأكد من تحديد النوع كـ Microsoft.Office.Tools.Excel.Controls.Button بدلاً من System.Windows.Forms.Button عند الإشارة إلى أو تحويل الكائن. |
موضع و حجم عنصر التحكم |
يتم تحديد حجم و موضع عنصر التحكم بواسطة الخصائص التي هي جزء من عنصر تحكم ActiveX الحاوية. خصائص عنصر تحكم ActiveX تأخذ قيماً مختلفةً عن خصائص عناصر تحكم Windows Forms المكافئة. عند تعيين خصائص عنصر التحكم Top أو Left أو Height أو Width، ويتم حسابه بالنقاط بدلاً من البكسل. |
وضع عنصر التحكم على مستندات Word |
إذا قمت بإضافة عناصر تحكم إلى تخطيط يستند إلى تدفق، ضع في الاعتبار أن عناصر التحكم ستساير المحتوى كلما تغيٌر المحتوى. لا يمكن تثبيت عنصر التحكم إلى فقرة عند سحبه من مربع الأدوات لأنه يتم إضافة عنصر التحكم إلى مستند Word الذى على نفس السطر مع النص. في حالة استخدام أسلوب آخر لإضافة عنصر التحكم، مثل النقر المزدوج فوق عنصر التحكم, يتم إدراج عنصر التحكم استناداً إلى خيار Word الذي قمت بتعيينه لإدراج الصور. لا يمكنك تعيين خاصية Left أو Top لعنصر التحكم الذى على نفس الخط مع النص. لا يمكنك وضع عناصر التحكم في رأس الصفحة أو تذييل الصفحة أو ضمن مستند ثانوي. |
أحداث عنصر التحكم |
عند اختيار عنصر التحكم , يتم رفع الأحداث بالترتيب التالي:
عند إلغاء اختيار عنصر التحكم , يتم رفع الأحداث بالترتيب التالي:
|
تغيير حجم عنصر التحكم |
عند تغيير إعداد التكبير/التصغير بمستند إلى أي شيء يختلف عن 100 % ، يتم تعطيل عناصر التحكم، على الرغم من أن ظهورها بالمقاييس مع المستند. على سبيل المثال، إذا قمت بالنقر فوق زر عندما يكون المستند الخاص بك مكبراً بنسبة 130 % ، فإنه سيتم إظهار رسالة بأنه قد تم تعطيل عنصر التحكم إلى أن يتم تعيين التكبير/التصغير إلى 100 %. سوف تعمل عناصر التحكم بشكل صحيح عند تغيير التكبير/التصغير إلى 100 %. |
قيم خاصية عنصر التحكم. |
على الرغم من أنه يتم تعيين خصائص عناصر التحكم على Windows Form إلى قيمة عدد صحيح، فإنه يتم تعيينهم إلى واحدة لعناصر التحكم في مستند Word. في Excel، يتم تعيين قيم خاصية عناصر التحكم إلى مزدوج. إذا كانت خاصية عنصر التحكم Height و Width تتجاوز حجم ورقة العمل أو الشاشة , يتم بتر القيمة. |
تغيير حجم عنصر التحكم |
إذا قمت بتغيير حجم عنصر التحكم على المستند باستخدام أحد مقابض تغيير الحجم الثمانية ,فإن أبعاد عنصر التحكم الجديدة لا تنعكس في النافذة خصائص حتى يتم إعادة اختيار عنصر التحكم. |
سلوك عنصر التحكم |
قد تتصرف عناصر التحكم على ورقة عمل Excel بشكل غير متوقع عند انقسام نافذة ورقة العمل. على سبيل المثال, الوصول إلى TextBox على ورقة العمل فقط قد يتوفر في أحد النوافذ. |
تسمية عنصر التحكم |
لا يمكنك استخدام الكلمات المحجوزة لتسمية عناصر التحكم. على سبيل المثال، إذا قمت بإضافة عنصر تحكم Button إلى ورقة عمل ثم قمت بتغيير الاسم إلى System ، سيحدث خطأ عند بناء المشروع. |
إضافة عناصر تحكم برمجياً |
لا تستخدم منشئ عنصر التحكم لإضافة عنصر تحكم إلى المستند الخاص بك أثناء وقت التشغيل. بدلاً من ذلك، استخدم الأساليب المساعدة التي يوفرها Visual Studio Tools لوقت تشغيل Office. على سبيل المثال، استخدام أسلوب AddButton لإضافة زر إلى ورقة العمل. إذا كنت تريد إضافة عنصر تحكم غير معتمد من قبل هذه الأساليب المساعدة، يمكنك استخدام أسلوب AddControl . لمزيد من المعلومات، راجع إضافة عناصر تحكم إلى مستندات Office في وقت التشغيل. |
نسخ عناصر التحكم |
إذا قمت بنسخ عناصر تحكم Windows Forms ولصقها في مستند في وقت التشغيل ,فإن عنصر تحكم ActiveX الحاوية الفارغ يتم لصقه في المستند. لا تظهر عناصر تحكم Windows Forms في الموقع الجديد ,ولا يتم نسخ التعليمات البرمجية خلف عنصر التحكم الأصلي إلى عنصر تحكم ActiveX الحاوية. |
قيود في المشاريع على مستوى المستند
بعض قيود استخدام عناصر تحكم Windows Forms على المستندات تكون فريدة في المشاريع على مستوى المستند.
دعم عنصر التحكم في وقت التصميم
تتم إزالة عناصر تحكم Windows Forms معينة من مربع الأدوات عند فتح ورقة عمل Excel أو مستند Word في مصمم Visual Studio . هذا بسبب القيود الفنية أو لأن الوظيفة متوفرة مسبقاً داخل Word أو Excel. تدعم مشاريع Excel وWord عناصر تحكم Windows Forms والمكونات الأخرى التي تظهر في مربع الأدوات عند التركيز على المستند ويمكن أيضا إضافة عناصر تحكم خارجية إلى مستند أو ورقة عمل.
ملاحظة
تتم إزالة كافة عناصر التحكم من مربع الأدوات عندما يكون المستند محمياً. لمزيد من المعلومات حول حماية المستند راجع حفظ المستندات في حلول على مستوى المستند.
ملاحظة
يجب أن تكون أجهزة التحكم الجهة الخارجية فيها السمة ComVisibleAttribute معينة إلى true لكي يتم استخدامها في حلول Office.
عناصر التحكم والمكونات التالية غير متوفرة في مربع الأدوات:
دعم عناصر تحكم ActiveX القديمة
إذا قمت بإنشاء مشروع Office على مستوى المستند يستخدم مستند Word موجود أو مصنف Excel يحتوي على عناصر تحكم ActiveX، وظيفة عناصر تحكم ActiveX لا تكون مفقودة; ومع ذلك، لا يوجد أي دعم لإضافة عناصر تحكم ActiveX جديدة إلى المستندات الخاصة بك من داخل Visual Studio. على سبيل المثال، إذا كان مستند Word الخاص بك يحتوى على زر من مربع الأدوات عناصر التحكم يقوم بتشغيل ماكرو Visual Basic للتطبيقات (VBA)، سيستمر فى تشغيل الماكرو بعد استعمال المستند فى مشروع Office. و على كل حال، ينصح بإزالة عنصر تحكم ActiveX و وحدات ماكرو VBA و استبدالهم بعناصر تحكم Windows Forms و تعليمات برمجية مدارة.
راجع أيضًا:
المهام
كيفية القيام بما يلي: إضافة عناصر تحكم Windows Forms إلى مستندات Office
المبادئ
نظرة عامة على عناصر تحكم Windows Forms فى مستندات Office
إضافة عناصر تحكم إلى مستندات Office في وقت التشغيل