RibbonGroup.DialogLauncherClick-Ereignis (2007 System)

Artikel
08/23/2008

Aktualisiert: November 2007

Tritt auf, wenn der Benutzer in der Gruppe auf das Symbol des Dialogfeldstartprogramms für die Multifunktionsleiste klickt.

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

Syntax

Public Event DialogLauncherClick As EventHandler(Of RibbonControlEventArgs)

Dim instance As RibbonGroup
Dim handler As EventHandler(Of RibbonControlEventArgs)

AddHandler instance.DialogLauncherClick, handler

public event EventHandler<RibbonControlEventArgs> DialogLauncherClick

Hinweise

Das Dialogfeldstartprogramm für die Multifunktionsleiste ist ein kleines Symbol, das in der Gruppe angezeigt wird. Wenn der Benutzer auf dieses Symbol klickt, kann das DialogLauncherClick-Ereignis so behandelt werden, dass ein benutzerdefiniertes Dialogfeld geöffnet wird. Standardmäßig verfügen Gruppen nicht über ein Dialogfeldstartprogramm für die Multifunktionsleiste. Weitere Informationen hierzu finden Sie unter Gewusst wie: Hinzufügen eines Dialogfeld-Startprogramms zu einer Multifunktionsleistengruppe.

Beispiele

Im folgenden Beispiel wird gezeigt, wie einer Multifunktionsleisten-Gruppe ein Dialogfeld-Startprogramm 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 ein 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 Windows Form-Dialogfeld-Element von hinzu. Wenn Sie C# verwenden, fügen Sie ein neues Windows Form-Element hinzu und wandeln 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();
}

Berechtigungen

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.