مشاركة عبر

نظرة عامة على جزء الإجراءات

  • مقالة

ينطبق على

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

نوع المشروع

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

إصدار Microsoft Office

  • Excel 2007 و Excel 2010

  • Word 2007 و Word 2010

جزء الإجراءات هو جزء مهام إجراءات المستند مخصص و مرفق إلى مستندات Microsoft Office Word أو مصنف Microsoft Office Excel معين. يتم استضافته ضمن جزء مهام Office مع أجزاء المهام المضمنة الأخرى مثل جزء مهام مصادر XMLفي Excel أو جزء مهام الأنماط و التنسيق في Word. يمكنك استخدام عناصر تحكم Windows Forms أو عناصر تحكم WPF لتصميم واجهة مستخدم جزء الإجراءات.

يمكنك إنشاء جزء إجراءات فقط في تخصيص علي مستوى المستند في Word أو Excel. لا يمكنك إنشاء جزء من الاجراءات في المستوى تطبيق إضافة-في. لمزيد من المعلومات، راجع الميزات المتوفرة بواسطة تطبيقات Office و نوع المشروع.

ملاحظة

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

ارتباط إلى فيديو للحصول على عرض فيديو توضيحي ذي صلة، راجع كيف يمكنني القيام بما يلي: استخدام عناصر تحكم WPF داخل جزء إجراءات Excel؟.

عرض جزء الإجراءات

الإجراءات يتم تمثيلها بالفئة ActionsPane . عند إنشاء مشروع على مستوى المستند، يتوفر مثيل من هذه الفئة للتعليمات البرمجية باستخدام الحقل ActionsPane من الفئة ThisWorkbook (لـ Excel) أو ThisDocument (لـ Word) في المشروع. لعرض جزء الإجراءات ، قم بإضافة عناصر تحكم Windows Forms إلى خاصية Controls الخاصة بحقل ActionsPane . مثال التعليمات البرمجية التالي يضيف عنصر تحكم باسم actions إلى جزء الإجراءات.

Me.ActionsPane.Controls.Add(actions)

this.ActionsPane.Controls.Add(actions);

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

إضافة عناصر تحكم متعددة إلى جزء الإجراءات

إذا كنت تقوم بإضافة عناصر تحكم متعددة إلى جزء "الإجراءات" ، في معظم الحالات يجب عليك تجميع عناصر التحكم الموجودة في عنصر تحكم المستخدم ثم القيام بإضافة عنصر تحكم المستخدم إلى الخاصية Controls . تتضمن تلك العملية الخطوات التالية:

  1. إنشاء المستخدم لواجهة المستخدم (UI) الخاصة بجزء "الإجراءات" عن طريق إضافة عنصر تحكم جزء إجراءات أو عنصر تحكم مستخدم إلى مشروعك. يتضمن كل من هذه، فئات Windows Forms مخصصة UserControl. عناصر عنصر تحكم جزء الإجراءات و عنصر تحكم المستخدم متساوية; الاختلاف الوحيد هو الاسم.

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

    ملاحظة

    يمكنك أيضاً إضافة عناصر تحكم WPF إلى جزء الإجراءات عن طريق إضافة WPF System.Windows.Controls.UserControl إلى UserControlالخاصة بـ Windows Forms. لمزيد من المعلومات، راجع استخدام عناصر التحكم WPF في حلول Office.

  3. أضف المثيل الخاص بعنصر تحكم المستخدم المخصص إلى عناصر التحكم الموجودة في الحقل ActionsPane من الفئة ThisWorkbook (لـ Excel) أو ThisDocument (لـ Word) في مشروعك.

للحصول على أمثلة تشرح هذه العملية بمزيد من التفاصيل راجع كيفية القيام بما يلي: إضافة جزء إجراءات إلى مستندات Word و كيفية القيام بما يلي: إضافة جزء إجراءات إلى مصنفات Excel.

إخفاء جزء الإجراءات

على الرغم من أن فئة ActionsPane تحتوي على أسلوب Hide و خاصية Visible ، لا يمكنك إزالة جزء الإجراءات من واجهة المستخدم باستخدام أي أعضاء من الفئة ActionsPane نفسها. استدعاء الأسلوب Hide أو تعيين الخاصية Visibleإلى false يقوم بإخفاء عناصر التحكم فقط في جزء الإجراءات; و لا يخفي جزء المهام.

لإخفاء جزء المهام في الحل الخاص بك ، لديك خيارات متعددة:

  • بالنسبة لـ Word،قم بتعيين الخاصية Visible من كائن TaskPane الذي يمثل جزء مهام إجراءات المستند إلى false. الهدف من مثال التعليمة البرمجية التالية هو أن يتم تشغيلها من الفئة ThisDocument في المشروع الخاص بك.

    Me.Application.TaskPanes(Word.WdTaskPanes.wdTaskPaneDocumentActions).Visible = False

    this.Application.TaskPanes[Word.WdTaskPanes.wdTaskPaneDocumentActions].Visible = false;

  • لـ Excel،قم بتعيين الخاصية DisplayDocumentActionTaskPane الخاصة بكائن Application إلى false. الهدف من مثال التعليمة البرمجية التالية هو أن يتم تشغيلها من الفئة ThisWorkbook في المشروع الخاص بك.

    Me.Application.DisplayDocumentActionTaskPane = False

    this.Application.DisplayDocumentActionTaskPane = false;

  • بالنسبة Word أو Excel يمكنك بدلا من ذلك، تعيين الخاصية CommandBarVisible() الخاصة بشريط الأوامر التي تمثل جزء المهام إلى false. الهدف من مثال التعليمة البرمجية التالي هو أن يتم تشغيله من الفئة ThisDocument أو ThisWorkbook في المشروع الخاص بك.

    Me.Application.CommandBars("Task Pane").Visible = False

    this.Application.CommandBars["Task Pane"].Visible = false;

مسح جزء الإجراءات عند فتح المستند

إذا قام المستخدم بحفظ المستند بينما كان جزء الإجراءات مرئياً، يكون جزء الإجراءات مرئياً كل مرة يتم فيها فتح المستند, سواء كان جزء الإجراءات أو لم يكن يحتوي على أي عناصر تحكم. إذا كنت تريد التحكم فى وقت ظهوره، قم باستدعاء الأسلوب Clear من الحقل ActionsPane في معالج الأحداث Startup من ThisDocument أو ThisWorkbook للتأكد من أن جزء الإجراءات غير مرئي عند فتح المستند.

تحديد متى يتم إغلاق جزء الإجراءات

لا يوجد هناك حدث يتم رفعه عند إغلاق جزء الإجراءات. على الرغم من أن الفئة ActionsPane تحتوي على الحدث VisibleChanged ،فإن هذا الحدث لا يتم تشغيله عند إغلاق المستخدم لجزء الإجراءات. بدلاً من ذلك، يتم رفع هذا الحدث عندما يتم إخفاء عناصر التحكم الموجودة في جزء "الإجراءات" عن طريق استدعاء الأسلوب Hide أو بتعيين الخاصية Visible إلى false.

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

لعرض جزء الإجراءات باستخدام واجهة Word أو Excel

  1. انقر على علامة التبويب عرض، فوق الشريط.

  2. في المجموعة إظهار\إخفاء انقر فوق زر تبديل إجراءات المستند.

أحداث جزء إجراءات البرمجة

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

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

ربط بيانات بعناصر تحكم في جزء الإجراءات

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

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

التحقق من صحة البيانات في عناصر تحكم جزء إجراءات

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

ترتيب تكديس عناصر تحكم المستخدم

إذا كنت تستخدم عناصر تحكم مستخدم متعددة، يمكنك كتابة تعليمة برمجية لتكديس عناصر تحكم المستخدم في جزء الإجراءات بشكل صحيح سواء قد تم إرساؤها عمودياً أو أفقياً. يمكنك تعيين ترتيب تكديس عناصر التحكم المستخدم في جزء الإجراءات باستخدام تعداد StackStyle الخاص بالخاصية StackOrder. لمزيد من المعلومات، انظر كيفية القيام بما يلي: إدارة تخطيط عنصر تحكم على أجزاء إجراءات.

StackOrderتستغرق خاصية التالية StackStyleقيم التعداد.

نمط التكديس

التعريف

FromBottom

تكديس من الجزء السفلي من جزء الإجراءات.

FromLeft

تكديس من الجزء الأيسر من جزء الإجراءات.

FromRight

تكديس من الجزء الأيمن من جزء الإجراءات.

FromTop

تكديس من الجزء الأعلى من جزء الإجراءات.

None

لا ترتيب تكدس معرف ; يتم التحكم في الترتيب من قبل المطور.

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

Me.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop

this.ActionsPane.StackOrder = Microsoft.Office.Tools.StackStyle.FromTop;

عناصر تحكم الارتساء (Anchoring)

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

تغيير حجم جزء الإجراءات

لا يمكنك تغيير حجم ActionsPane مباشرة لأن ActionsPane مضمن في جزء المهام. ومع ذلك، يمكنك تغيير عرض جزء المهام برمجياً بواسطة إعداد الخاصية Width() من CommandBar التي تمثل جزء المهام. يمكنك تغيير الارتفاع الخاص بجزء المهام إذا تم إرساؤه أفقياً أو كان عائما.

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

Me.CommandBars("Task Pane").Width = 200

this.CommandBars["Task Pane"].Width = 200;

تغيير موضع جزء الإجراءات

لا يمكن تغيير موضع ActionsPane مباشرة لأنه مضمن في جزء المهام. ومع ذلك، يمكنك تحريك جزء المهام برمجياً بواسطة إعداد الخاصية Position() من CommandBar التي تمثل جزء المهام.

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

Me.CommandBars("Task Pane").Position = _
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft

this.CommandBars["Task Pane"].Position =
    Microsoft.Office.Core.MsoBarPosition.msoBarLeft;

ملاحظة

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

تعيين خصائص Top و Left من ActionsPane لا يغير موضعه لأن الكائن ActionsPane مضمن في جزء المهام.

إذا لم يتم إرساء جزء المهام ، يمكنك تعيين خصائص Top() و Left() من CommandBar الذي يمثل جزء المهام. تقوم التعليمات البرمجية التالية بنقل جزء المهام الذي لم يتم إرساؤه إلى الزاوية اليسرى العليا من المستند.

If Me.CommandBars("Task Pane").Position = _
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating Then

    Me.CommandBars("Task Pane").Top = 0
    Me.CommandBars("Task Pane").Left = 0

End If

if (this.CommandBars["Task Pane"].Position == 
    Microsoft.Office.Core.MsoBarPosition.msoBarFloating)
{
    this.CommandBars["Task Pane"].Top = 0;
    this.CommandBars["Task Pane"].Left = 0;
}

راجع أيضًا:

المهام

كيفية القيام بما يلي: إضافة جزء إجراءات إلى مستندات Word

كيفية القيام بما يلي: إضافة جزء إجراءات إلى مصنفات Excel

الإرشادات التفصيلية: إدراج نص في مستند من جزء الإجراءات

الإرشادات التفصيلية: ربط بيانات إلى عناصر تحكم في جزء إجراءات Word

الإرشادات التفصيلية: ربط بيانات إلى عناصر تحكم في جزء إجراءات Excel

الإرشادات التفصيلية: تغيير جزء الإجراءات طبقًا لسياق المستخدم

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

المبادئ

استخدام عناصر التحكم WPF في حلول Office

الوصول العمومي إلى الكائنات في مشاريع Office

موارد أخرى

تخصيص واجهة Office