الإرشادات التفصيلية: مزامنة جزء المهام المخصص مع زر الشريط

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

توضح هذه الإرشادات التفصيلية كيفية إنشاء جزء مهام مخصص يمكن للمستخدمين إخفاؤه أو عرضه عن طريق النقر فوق زر التبديل على الشريط. يجب إنشاء عنصر واجهة مستخدم (UI) دوماً، مثل الزر ، يمكن للمستخدمين النقر عليه لعرض أو إخفاء جزء المهام المخصص الخاص بك لأن تطبيقات Microsoft Office لا توفر طريقة افتراضية للمستخدمين لإظهار أو إخفاء أجزاء المهام المخصصة.

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

توضح هذه الإرشادات التفصيلية المهام التالية:

• تصميم واجهة المستخدم الخاصة بجزء المهام المخصص.

• إضافة زر التبديل إلى الشريط.

• مزامنة زر التبديل مع جزء المهام المخصص.

ملاحظة

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

المتطلبات الأساسية

تحتاج إلى المكونات التالية لاستكمال هذه الإرشادات التفصيلية:

-

إصدار لـ Visual Studio 2010 يشمل أدوات مطوري Microsoft Office. لمزيد من المعلومات، راجع [تكوين كمبيوتر لتطوير حلول Office](bb398242\(v=vs.100\).md).

• Microsoft Office Excel 2007 أو Microsoft Excel 2010.

إنشاء مشروع وظيفة إضافية

في هذه الخطوة، سوف تقوم بإنشاء مشروع وظيفى إضافي لـ Excel.

لإنشاء أحد المشروعات الجديدة

• إنشاء Excel إضافة-في مشروع يحمل الاسم SynchronizeTaskPaneAndRibbon، باستخدام Excel إضافة-في قالب المشروع. لمزيد من المعلومات، راجع كيفية القيام بما يلي: إنشاء مشاريع Office في Visual Studio.

  Visual Studio يفتح ملف الرمز ThisAddIn.cs أو ThisAddIn.vb و يقوم بإضافة المشروع SynchronizeTaskPaneAndRibbon إلى مستكشف الحلول .

إضافة زر التبديل إلى الشريط.

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

لإضافة زر التبديل إلى الشريط.

1. في مشروع قائمة ، انقر فوق إضافة عنصر جديد .

2. في مربع الحوار أضف عنصر جديد ، حدد الشريط (مصمم مرئى) .

3. قم بتغيير اسم الشريط الجديد إلى ManageTaskPaneRibbonثم انقر فوق أضف .

   إن ملف ManageTaskPaneRibbon.cs أو ManageTaskPaneRibbon.vb يتم فتحه في مصمم الشريط و يعرض المجموعة و التبويب الافتراضيين .

4. في مصمم الشريط، انقر فوق المجموعة1 (group1) .

5. في الإطار خصائص، قم بتعيين تسمية خاصية إلى مهمة إدارة جزء التنقل.

6. من التبويب عناصر تحكم شريط Officeفى مربع الأدوات، اسحب زر تبديل (ToggleButton) إلى المجموعة إدارة جزء المهام.

7. انقر فوق toggleButton1 .

8. في الإطار خصائص، قم بتعيين التسمية خاصية إلى إظهار جزء المهام.

تصميم واجهة المستخدم الخاصة بجزء المهام المخصص

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

تصميم واجهة المستخدم الخاصة بجزء المهام المخصص

1. في القائمة مشروع، انقر فوق إضافة عنصر تحكم المستخدم .

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

   عنصر تحكم المستخدم يتم فتحه في المصمم.

3. من التبويب عناصر تحكم شائعة في مربع الأدوات (Toolbox)، اسحب عنصر تحكم مربع النص (TextBox) إلى عنصر تحكم المستخدم.

إنشاء جزء المهام المخصص

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

لإنشاء جزء المهام المخصص

1. في مستكشف الحلول ، قم بتوسيع Excel.

2. انقر بزر الماوس الأيمن على ThisAddIn.cs أو ThisAddIn.vb وانقر فوق عرض التعليمات البرمجية.

3. قم بإضافة التعليمات البرمجية التالية إلى فئة ThisAddIn . هذه التعليمات البرمجية تقوم بالتصريح بمثيل TaskPaneControl كعضو في ThisAddIn.

   Private taskPaneControl1 As TaskPaneControl
   Private WithEvents taskPaneValue As Microsoft.Office.Tools.CustomTaskPane
   

   private TaskPaneControl taskPaneControl1;
   private Microsoft.Office.Tools.CustomTaskPane taskPaneValue;
   

4. قم باستبدال معالج الأحداث ThisAddIn_Startup بالتعليمات البرمجية التالية. تعمل هذه التعليمة البرمجية على إضافة كائن TaskPaneControl إلى حقل CustomTaskPanes ولكنه لا يعرض جزء المهام المخصص (بشكل افتراضي خاصية Visible من فئة CustomTaskPane هي false). التعليمات البرمجية الخاصة ب Visual C# يمكنها أيضاً إرفاق معالج الأحداث إلى الحدث VisibleChanged .

   Private Sub ThisAddIn_Startup(ByVal sender As Object, _
       ByVal e As System.EventArgs) Handles Me.Startup
   
       taskPaneControl1 = New TaskPaneControl()
       taskPaneValue = Me.CustomTaskPanes.Add( _
           taskPaneControl1, "MyCustomTaskPane")
   End Sub
   

   private void ThisAddIn_Startup(object sender, System.EventArgs e)
   {
       taskPaneControl1 = new TaskPaneControl();
       taskPaneValue = this.CustomTaskPanes.Add(
           taskPaneControl1, "MyCustomTaskPane");
       taskPaneValue.VisibleChanged +=
           new EventHandler(taskPaneValue_VisibleChanged);
   }
   

5. قم بإضافة الأسلوب التالي إلى الفئة ThisAddIn . يعالج هذا الأسلوب حدث VisibleChanged. عند إغلاق المستخدم لجزء المهام بالنقر فوق زر إغلاق (X) ، هذا الأسلوب يقوم بتحديث حالة زر التبديل على الشريط..

   Private Sub taskPaneValue_VisibleChanged(ByVal sender As Object, _
       ByVal e As System.EventArgs) Handles taskPaneValue.VisibleChanged
   
       Globals.Ribbons.ManageTaskPaneRibbon.ToggleButton1.Checked = taskPaneValue.Visible
   End Sub
   

   private void taskPaneValue_VisibleChanged(object sender, System.EventArgs e)
   {
       Globals.Ribbons.ManageTaskPaneRibbon.toggleButton1.Checked = 
           taskPaneValue.Visible;
   }
   

6. قم بإضافة الخاصية التالية إلى الفئة ThisAddIn . هذه الخاصية تقوم بكشف كائن myCustomTaskPane1 الخاص إلى الفئات الأخرى. لاحقًا في هذه الإرشادات التفصيلية سوف تقوم بإضافة التعليمات البرمجية إلى فئة MyRibbon التي تستخدم هذه الخاصية.

   Public ReadOnly Property TaskPane() As Microsoft.Office.Tools.CustomTaskPane
       Get
           Return taskPaneValue
       End Get
   End Property
   

   public Microsoft.Office.Tools.CustomTaskPane TaskPane
   {
       get
       {
           return taskPaneValue;
       }
   }
   

إخفاء و إظهار جزء مهام مخصص عن طريق استخدام زر التبديل

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

لعرض أو إخفاء جزء المهام المخصص باستخدام زر التبديل

1. في مصمم الشريط، انقر نقراً مزدوجاً فوق زر التبديل إظهار جزء المهام .

   Visual Studio يقوم تلقائياً بتشغيل معالج أحداث يدعى toggleButton1_Click ، يقوم بمعالجة الحدث Click الخاص بزر التبديل. يقوم Visual Studio أيضاً بفتح ملف MyRibbon.cs أو MyRibbon.vb في محرر التعليمات البرمجية.

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

   Private Sub ToggleButton1_Click(ByVal sender As System.Object, _
       ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles ToggleButton1.Click
   
       Globals.ThisAddIn.TaskPane.Visible = _
           TryCast(sender, Microsoft.Office.Tools.Ribbon.RibbonToggleButton).Checked
   End Sub
   

   private void toggleButton1_Click(object sender, RibbonControlEventArgs e)
   {
       Globals.ThisAddIn.TaskPane.Visible = ((RibbonToggleButton)sender).Checked;
   }
   

اختبار الوظائف الإضافية

عندما تقوم بتشغيل مشروع ، يفتح Excel دون عرض جزء المهام المخصص. انقر فوق زر التبديل على "الشريط" لاختبار التعليمات البرمجية.

لاختبار الوظائف الإضافية الخاصة بك

1. اضغط F5 لتشغيل مشروعك.

   تأكد من أن Excel يفتح و من أن علامة التبويب الوظائف الإضافية يظهر على الشريط.

2. انقر فوق علامة التبويب الوظائف الإضافية على الشريط.

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

   تأكد من إن جزء المهام يتم عرضه و إخفاؤه بشكل متناوب عند النقر فوق زر التبديل .

4. عندما يكون جزء المهام مرئياً، انقر فوق زر إغلاق (X) في زاوية جزء المهام.

   تحقق من إن زر التبديل لا يبدو مضغوطاً عليه

الخطوات التالية

يمكنك معرفة المزيد حول كيفية إنشاء أجزاء مهام مخصصة من هذه المواضيع:

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

• أتمتة تطبيق من جزء مهام مخصص. لمزيد من المعلومات، راجع الإرشادات التفصيلية: أتمتة تطبيق ما من جزء مهام مخصص.

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

راجع أيضًا:

المهام

كيفية القيام بما يلي: إضافة جزء مهام مخصص إلى تطبيق ما

الإرشادات التفصيلية: أتمتة تطبيق ما من جزء مهام مخصص

الإرشادات التفصيلية: عرض أجزاء المهام المخصصة مع رسائل البريد الإلكتروني في Outlook

كيفية القيام بما يلي: عرض أجزاء مهام مخصصة مع رسائل بريد إلكتروني في Outlook

المبادئ

إدارة أجزاء مهام مخصصة في تطبيقات Windows متعددة

موارد أخرى

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

نظرة عامة على الشريط