RibbonDialogLauncher الواجهة

مقالة
09/21/2010

يمثل standardized مربع متوسط رمز تشغيل مجموعة التي يمكن استخدامها لفتح صندوق حوار.

مساحة الاسم: Microsoft.Office.Tools.Ribbon
التجميع: Microsoft.Office.Tools.Common (في Microsoft.Office.Tools.Common.dll)

بناء الجملة

'إقرار
<GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")> _
Public Interface RibbonDialogLauncher _
    Inherits IDisposable

[GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")]
public interface RibbonDialogLauncher : IDisposable

ملاحظات

RibbonDialogLauncherهو dهوplayed في الزاوية السفلية اليسرى من المجموعة بشكل افتراضي.

Image، ImageName، و OfficeImageIdخصائص قد لا vهوible التأثير عند RibbonDialogLauncherهو dهوplayed في مجموعة تظهر تشغيل "شريط". ومع ذلك، عندما يضيف مستخدم RibbonDialogLauncherإلى شريط "أدوات الوصول السريع"، تتحكم هذه الخصائص بسلوك الصورة التي هو المعروضة. أيضا، Visibleلا يخفي خاصية RibbonDialogLauncherعند ذلك هو dهوplayed على شريط أدوات "الوصول السريع". يمكن للمستخدم إضافة RibbonDialogLauncherإلى "الوصول السريع" إلى olbar من خلال العنصر "الشريط" (XML) . لمزيد من المعلومات، راجع نظرة عامة على الشريط.

RibbonDialogLauncherيطبق فقط إلى RibbonGroup. RibbonGroupيحتوي الكائن DialogLauncherعضو RibbonDialogLauncherالنوع. لمعلومات حول كيفية إلى إضافة RibbonDialogLauncherإلى RibbonGroup، راجع كيفية: إضافة مشغل مربع حوار إلى مجموعة الشريط.

يمكنك إنشاء RibbonDialogLauncherفي وقت التشغيل بواسطة استخدام CreateRibbonDialogLauncherأسلوب RibbonFactoryالكائن.

هناك طريقتان للوصول إلى الكائن RibbonFactory :

باستخدام الخاصية Factory الخاصة بفئة الشريط استخدم هذه الطريقة من التعليمات البرمجية في فئة الشريط الخاصة بك .
باستخدام أسلوب Globals.Factory.GetRibbonFactory. استخدم هذه الطريقة من لتعليمات البرمجية خارج فئة الشريط الخاصة بك .

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

ملاحظة

يتم تطبيق هذه الواجهة بواسطة Visual Studio Tools لوقت تشغيل Office. ولم يتم تصميمها لتطبيقها في التعليمة البرمجية الخاصة بك. لمزيد من المعلومات، راجع أدوات Visual Studio نظرة عامة وقت تشغيل Office.

الاستخدام

توضح هذه الوثائق الإصدار الخاص بهذا النوع المستخدم في مشاريع Office والذي يستهدف .NET Framework 4. وفي المشاريع التي تستهدف .NET Framework 3.5، قد يكون لدى هذا النوع أعضاء مختلفون وقد لا تعمل نماذج التعليمات البرمجية الخاصة بهذا النوع. للحصول على وثائق حول هذا النوع في المشاريع التي تستهدف .NET Framework 3.5، اطلع على جزء المرجع التالي في وثائق Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

أمثلة

يوضح المثال التالي كيفية إضافة RibbonDialogLauncherإلى مجموعة "شريط" و كيفية تشغيل مربع حوار مخصص الذي يمكن المستخدمين من اختيار الإعدادات المتقدمة عند قيامهم بالنقر فوق RibbonDialogLauncherالرمز في الزاوية اليسرى السفلية RibbonGroup.

إلى تشغيل هذا المثال تعليمات برمجية، يجب أولاً إجراء الخطوات التالية:

إضافة أحد عناصر "شريط" (مصمم Visual Basic) لمشروع المكتب.
إضافة على RibbonDialogLauncherإلى المجموعة الافتراضية مجموعة 1 كما هو موضح في كيفية: إضافة مشغل مربع حوار إلى مجموعة الشريط.
إذا كنت تستخدم Visual أساسى، إضافة عنصر جديد مربع حوار إلى المشروع. إذا كنت تستخدم C#, إضافة عنصر جديد نموذج Windows وتشغيل إلى مربع حوار إضافة ing ‏‏موافق و إلغاء أزرار إلى النموذج وذلك بإنشاء معالجات الأحداث الأزرار الموجودة انقر فوق أحداث.
قم بتعيين خاصية (اسم) من حوار إلى advancedSettings حوار . يمكنك يخصص مربع الحوار بواسطة إضافة عناصر تحكم وتعيين المزيد من الخصائص.
قم بإضافة DialogLauncherClickمعالج الأحداث للتعليمات البرمجية الخاصة بك.
قم بوضع محتويات الأسلوب التالي في DialogLauncherClickمعالج حدث.

Private Sub Group1_DialogLauncherClick(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Group1.DialogLauncherClick
    Dim dlg As advancedSettingsDialog = New advancedSettingsDialog()
    dlg.ShowDialog()
End Sub

void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
    advancedSettingsDialog dlg = new advancedSettingsDialog();
    dlg.ShowDialog();
}