نظرة عامة على أجزاء الإجراءات المخصصة
ينطبق على |
|---|
|
تنطبق المعلومات الموجودة في هذا الموضوع فقط على أنواع المشاريع وإصدارات Microsoft Office التالية: لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع. نوع المشروع
تطبيق Microsoft Office
|
أجزاء المهام هي لوحات واجهة مستخدم يتم إرساؤها عادةً على أحد جانبي النافذة في تطبيق Microsoft Office. تعطيك أجزاء المهام المخصصة طريقة لإنشاء جزء المهام الخاص بك و مد المستخدمين بواجهة مألوفة للوصول إلى ميزات الحل الخاص بك. على سبيل المثال ،يمكن أن تحتوي النافذة على عناصر تحكم تشغل التعليمات البرمجية لتعديل المستندات أو عرض البيانات من مصدر بيانات.
يمكنك إنشاء جزء مهام مخصص فقط في الوظائف الإضافية على مستوى التطبيق في أحد تطبيقات Microsoft Office المذكورة أعلاه. لا يمكنك إنشاء جزء مهام مخصص في تخصيص على مستوى المستند. لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع.
ملاحظة
مهمة جزء المهام الخاص تختلف عن جزء الإجراءات. جزء الإجراءات هو جزء من التخصيصات على مستوى المستند لـ Microsoft Office Word وMicrosoft Office Excel. لمزيد من المعلومات، راجع نظرة عامة على جزء الإجراءات.
فوائد أجزاء المهام المخصصة
تسمح أجزاء المهام المخصصة لك بتكامل الميزات في نافذة مستخدم مألوفة . يمكنك إنشاء جزء مهام مخصص بسرعة باستخدام أدوات Visual Studio.
واجهة مستخدم مألوفة
مستخدمي التطبيقات في نظام Microsoft Office معتادون بالفعل على استخدام أجزاء المهام مثل جزء المهام أنماط وتنسيقات في Word. أجزاء المهام الخاصة تتصرف مثل أجزاء المهام الأخرى في نظام Microsoft Office. يمكن للمستخدمين إرساء أجزاء المهام المخصصة إلى جوانب مختلفة من نافذة التطبيق أو يمكنهم سحب أجزاء المهام المخصصة إلى أي موقع في النافذة. يمكنك إنشاء وظيفة إضافية تعرض أجزاء مهام خاصة متعددة في نفس الوقت , و يمكن للمستخدمين التحكم في أي جزء بشكل فردي.
دعم Windows Forms
واجهة المستخدم في جزء المهام المخصص الذي قمت بإنشائه باستخدام أدوات تطوير Office في Visual Studio تعتمد على عناصر تحكم Windows Forms. يمكن استخدام "مصمم Windows Forms المألوف" لتصميم واجهة المستخدم لجزء مهام مخصص. يمكنك أيضاً استخدام دعم ربط البيانات في Windows Forms لربط مصدر البيانات بعناصر التحكم الموجودة في جزء المهام.
إنشاء جزء مهام مخصص
يمكنك إنشاء جزء مهام مخصص أساسي في الخطوتين التاليتين:
قم بإنشاء نافذة مستخدم لجزء المهام المخصص الخاص بك عن طريق إضافة عناصر تحكم Windows Forms إلى كائن UserControl .
بدلاً من ذلك، استخدم ClickOnce أو مثبت Windows لنشر إضافة-في.CustomTaskPaneCollection عندما تقوم بإغلاق مثيل ل Outlook التي هو تشغيل وظيفة الإضافية التي تم إنشاؤها باستخدام أدوات تطوير المكتب في Studio Vهوual، الوظيفة الإضافية هو تم إلغاء تحميلها قبل الوظيفة الإضافية يتلقى CustomTaskPaneحدث.
للحصول على إجراء خطوة بخطوة, راجع كيفية القيام بما يلي: إضافة جزء مهام مخصص إلى تطبيق ما.
إنشاء واجهة المستخدم
كافة أجزاء المهام المخصصة التي تم إنشاؤها باستخدام أدوات تطوير Office في Visual Studio تحتوي على الكائن UserControl . يوفر عنصر التحكم هذا واجهة المستخدم لجزء المهام المخصص الخاص بك. يمكنك إنشاء عنصر تحكم المستخدم في وقت التصميم أو في وقت التشغيل. إذا قمت بإنشاء عنصر تحكم المستخدم في وقت التصميم يمكن استخدام مصمم Windows Form لإنشاء واجهة المستخدم من جزء المهام الخاص بك.
إنشاء مثيل لجزء المهام المخصص
بعد إنشاء عنصر تحكم مستخدم يحتوي على واجهة المستخدم لجزء المهام المخصص ,أنت تحتاج إلى إنشاء مثيل CustomTaskPane. للقيام بذلك، قم بتمرير عنصر تحكم إلى CustomTaskPaneCollection في الوظيفة الإضافية عن طريق استدعاء أحد أساليب Add . هذه المجموعة يتم عرضها كالحقل CustomTaskPanes من الفئة ThisAddIn . الهدف من مثال التعليمات البرمجية التالية هو أن يتم تشغيلها من فئة ThisAddIn .
myUserControl1 = New MyUserControl
myCustomTaskPane = Me.CustomTaskPanes.Add(myUserControl1, "My Task Pane")
myCustomTaskPane.Visible = True
myUserControl1 = new MyUserControl();
myCustomTaskPane = this.CustomTaskPanes.Add(myUserControl1, "My Task Pane");
myCustomTaskPane.Visible = true;
تقوم الأساليب Add بإرجاع كائن CustomTaskPane جديد. يمكنك استخدام هذا الكائن لتعديل مظهر جزء المهام و الاستجابة لأحداث المستخدم.
التحكم في جزء المهام في نوافذ متعددة
أجزاء المهام المخصصة المرتبطة مع نافذة إطار المستند، التي تقدم طريقة عرض مستند أو عنصر للمستخدم. يكون جزء المهام مرئياً فقط عندما تكون النافذة المقترنة مرئية.
لتحديد أى نافذة تعرض جزء المهام المخصص، استخدم التحميل الزائد المناسب للأسلوب Add عند إنشاء جزء المهام:
لربط جزء المهام مع الإطار النشط، استخدم أسلوب CustomTaskPaneCollection.Add(UserControl, String) .
لربط جزء المهام مع مستند يستضيفه نافذة محددة, استخدم أسلوب CustomTaskPaneCollection.Add(UserControl, String, Object) .
يتطلب Outlook و Word و InfoPath تعليمات صريحة عن وقت إنشاء أو عرض جزء المهام الخاص بك عندما يكون أكثر من نافذة مفتوحة. هذا يجعل من المهم الأخذ فى الاعتبار أين ينبغى إنشاء مثيل جزء المهام المخصص في التعليمات البرمجية الخاصة بك للتأكد من ظهور جزء المهام مع المستندات أو العناصر المناسبة في التطبيق. لمزيد من المعلومات، راجع إدارة أجزاء مهام مخصصة في تطبيقات Windows متعددة.
الوصول إلى التطبيق من خلال جزء المهام
إذا أردت أتمتة التطبيق من عنصر تحكم المستخدم ، يمكنك الوصول مباشرة إلى نموذج الكائن باستخدام Globals.ThisAddIn.Application فى التعليمات البرمجية الخاصة بك الفئة الثابتة Globals توفر الوصول إلى كائنThisAddIn . يعتبر حقل Application من هذا الكائن هو نقطة الإدخال إلى طراز كائن التطبيق.
لمزيد من المعلومات حول حقل Application من الكائن ThisAddIn ,راجع برمجة وظائف إضافية على مستوى التطبيق. للحصول على الإرشادات التفصيلية توضح كيفية أتمتة تطبيق من جزء مهام مخصص ، راجع الإرشادات التفصيلية: أتمتة تطبيق ما من جزء مهام مخصص. لمزيد من المعلومات حول الفئة Globals، راجع الوصول العمومي إلى الكائنات في مشاريع Office.
إدارة واجهة المستخدم من جزء مهام
بعد إنشاء "جزء المهام" ، يمكنك استخدام خصائص وأحداث الكائن CustomTaskPane للتحكم في واجهة مستخدم جزء المهام و للاستجابة عندما يقوم المستخدم بتغيير جزء المهام.
جعل جزء المهام المخصص مرئياً
بشكل افتراضي، جزء المهام يكون غير مرئي. لإظهار جزء المهام, يجب تعيين خاصية Visible إلى true.
يمكن للمستخدمين إغلاق جزء مهام في أي وقت بالنقر فوق الزر إغلاق، زر (X) في زاوية جزء المهام. ومع ذلك ،لا توجد طريقة افتراضية للمستخدمين لفتح جزء المهام المخصص مرة أخرى. إذا قام مستخدم يإغلاق جزء المهام مخصص ،لا يستطيع هذا المستخدم عرض جزء المهام المخصص مرة أخرى إلا إذا قمت بتوفير طريقة لعرضه.
إذا قمت بإنشاء جزء مهام مخصص في الوظيفة الإضافية عليك أيضاً إنشاء عنصر واجهة مستخدم (UI) ,مثل زر, يمكن للمستخدمين النقر فوقه لعرض أو إخفاء جزء المهام المخصص. في حالة إنشاء جزء مهام مخصص في أحد تطبيقات Microsoft Office التي تدعم تخصيص الشريط ,يمكنك إضافة مجموعة عناصر تحكم إلى "الشريط" مع الزر الذي يعرض أو يخفي جزء المهام المخصص. للحصول على إرشادات تفصيلية توضح كيفية عمل بذلك، راجع الإرشادات التفصيلية: مزامنة جزء المهام المخصص مع زر الشريط.
في حالة إنشاء جزء مهام مخصص في أحد تطبيقات Microsoft Office التي لا تدعم تخصيص الشريط ,يمكنك إضافة CommandBarButton الذي يعرض أو يخفي جزء المهام المخصص الخاص بك .
تعديل مظهر جزء المهام
يمكنك التحكم في حجم وموقع جزء المهام المخصص باستخدام خصائص الكائن CustomTaskPane . يمكنك إجراء العديد من التغييرات على مظهر جزء المهام المخصص و ذلك باستخدام خصائص الكائن UserControl المضمن في جزء المهام المخصص. على سبيل المثال، يمكنك تحديد صورة خلفية لجزء مهام مخصص باستخدام خاصية BackgroundImage من عنصر تحكم المستخدم.
يسرد الجدول التالي التغييرات التي يمكنك إجراؤها في جزء المهام المخصص باستخدام خصائص CustomTaskPane.
المهمة |
الخصائص |
|---|---|
لتغيير حجم جزء المهام |
|
لتغيير موقع جزء المهام |
|
لإخفاء جزء المهام أو جعله مرئياً |
|
لمنع المستخدم من تغيير موقع جزء المهام |
برمجة أحداث جزء المهام مخصص
قد تريدُ أن تستجيب الوظيفة الافتراضية الخاصة بك عندما يقوم المستخدم بتعديل جزء المهام المخصص. على سبيل المثال، إذا قام المستخدم بتغيير اتجاه الجزء من عمودي إلى أفقي ، قد تحتاج لتغيير موضع عناصر التحكم.
يسرد الجدول التالي الأحداث التي يمكنك معالجتها للاستجابة إلى التغييرات التي قام المستخدم بها على جزء المهام المخصص.
المهمة |
الحدث |
|---|---|
للاستجابة عندما يغير المستخدم موقع جزء المهام. |
|
للاستجابة عندما يقوم المستخدم بإخفاء جزء المهام أو يجعله مرئياً. |
تنظيف الموارد المستخدمة بواسطة جزء المهام
بعد إنشاء جزء مهام مخصص، سيبقى الكائن CustomTaskPane في الذاكرة طالما الوظيفة الإضافية الخاصة بك تعمل. يبقى الكائن في الذاكرة حتى بعد قيام المستخدم بالنقر فوق الزر إغلاق ( X) في زاوية جزء المهام.
لتنظيف الموارد المستخدمة من قبل جزء المهام أثناء تشغيل الوظائف الإضافية ,استخدم أساليب Remove أو RemoveAt . هذه الطرق تقوم بإزالة الكائن CustomTaskPane المحدد من المجموعة CustomTaskPanes، و يقومون باستدعاء الأسلوب Dispose() من الكائن.
يقوم Visual Studio Tools لوقت تشغيل Office تلقائياً بتنظيف الموارد المستخدمة من قبل جزء مهام مخصص عند إلغاء تحميل وظائف إضافية. لا تستدع الأساليب Remove أو RemoveAt في معالج الأحداث ThisAddIn_Shutdown في المشروع. ستقوم هذه الطرق بطرح ObjectDisposedException, لأن Visual Studio Tools لوقت تشغيل Office يقوم بتنظيف الموارد المستخدمة من قبل الكائن CustomTaskPane قبل استدعاء ThisAddIn_Shutdown. لمزيد من المعلومات حول ThisAddIn_Shutdown، راجع الأحداث في مشاريع Office.
راجع أيضًا:
المهام
كيفية القيام بما يلي: إضافة جزء مهام مخصص إلى تطبيق ما
الإرشادات التفصيلية: أتمتة تطبيق ما من جزء مهام مخصص
الإرشادات التفصيلية: مزامنة جزء المهام المخصص مع زر الشريط
الإرشادات التفصيلية: عرض أجزاء المهام المخصصة مع رسائل البريد الإلكتروني في Outlook
كيفية القيام بما يلي: عرض أجزاء مهام مخصصة مع رسائل بريد إلكتروني في Outlook