RibbonDialogLauncher-Klasse (2007 System)

Artikel
08/23/2008

Aktualisiert: November 2007

Stellt ein kleines standardisiertes Symbol für eine Gruppe dar, mit dem ein Dialogfeld geöffnet werden kann.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)

Syntax

Public NotInheritable Class RibbonDialogLauncher _
    Implements IDisposable

Dim instance As RibbonDialogLauncher

public sealed class RibbonDialogLauncher : IDisposable

Hinweise

Ein RibbonDialogLauncher wird standardmäßig in einer Gruppe unten rechts angezeigt.

Die Image-Eigenschaft, die ImageName-Eigenschaft und die OfficeImageId-Eigenschaft haben keinen sichtbaren Effekt, wenn RibbonDialogLauncher in einer Gruppe auf der Multifunktionsleiste angezeigt wird. Wenn ein Benutzer der Symbolleiste für den Schnellzugriff jedoch einen RibbonDialogLauncher hinzufügt, steuern diese Eigenschaften das Verhalten des angezeigten Bilds. Zudem blendet die Visible-Eigenschaft nicht das RibbonDialogLauncher aus, wenn es auf der Symbolleiste für den Schnellzugriff angezeigt wird. Der Benutzer kann mithilfe des Multifunktionsleiste (XML)-Elements den RibbonDialogLauncher der Symbolleiste für den Schnellzugriff hinzufügen. Weitere Informationen hierzu finden Sie unter Übersicht über die Multifunktionsleiste.

RibbonDialogLauncher gilt nur für RibbonGroup. Die RibbonGroup-Klasse besitzt einen DialogLauncher-Member des RibbonDialogLauncher-Typs. Weitere Informationen zum Hinzufügen von RibbonDialogLauncher zu RibbonGroup finden Sie unter Gewusst wie: Hinzufügen eines Dialogfeld-Startprogramms zu einer Multifunktionsleistengruppe.

Einige Eigenschaften dieses Steuerelements können nur vor dem Laden der Multifunktionsleiste in die Office-Anwendung festgelegt werden. Informationen zum Festlegen dieser Eigenschaften finden Sie unter Multifunktionsleisten-Objektmodellübersicht.

Beispiele

Im folgenden Beispiel wird gezeigt, wie ein RibbonDialogLauncher einer Multifunktionsleistengruppe hinzugefügt wird und wie ein benutzerdefiniertes Dialogfeld geöffnet wird, mit dem Benutzer erweiterte Einstellungen auswählen können, indem Sie in der unteren rechten Ecke von RibbonGroup auf das Symbol RibbonDialogLauncher klicken.

Zum Ausführen dieses Codebeispiels müssen zuerst die folgenden Schritte ausgeführt werden:

Fügen Sie einem Visual Studio Tools for Office-Projekt ein Element von Multifunktionsleiste (Visual Designer) hinzu.
Fügen Sie der Standardgruppe Gruppe1 einen RibbonDialogLauncher hinzu, wie in Gewusst wie: Hinzufügen eines Dialogfeld-Startprogramms zu einer Multifunktionsleistengruppe erläutert.
Wenn Sie Visual Basic verwenden, fügen Sie dem Projekt ein neues Dialogfeld-Element hinzu. Wenn Sie C# verwenden, fügen Sie ein neues Windows Form-Element hinzu, und wandeln Sie es in ein Dialogfeld um, indem Sie dem Formular die Schaltflächen OK und Abbrechen hinzufügen und Ereignishandler für die Klickereignisse der Schaltflächen erstellen.
Legen Sie die Eigenschaft (Name) des Dialogfelds auf advancedSettingsDialog fest. Sie können das Dialogfeld anpassen, indem Sie Steuerelemente hinzufügen und weitere Eigenschaften festlegen.
Fügen Sie dem Code den Ereignishandler DialogLauncherClick hinzu.
Fügen Sie den Inhalt folgender Methode dem Ereignishandler DialogLauncherClick hinzu.

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();
}

Vererbungshierarchie

System.Object
Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher

Threadsicherheit

Alle öffentlichen static (Shared in Visual Basic)-Member dieses Typs sind threadsicher. Bei Instanzmembern ist die Threadsicherheit nicht gewährleistet.