RibbonGroup.DialogLauncherClick-Ereignis

Artikel
08/10/2011

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

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

Syntax

'Declaration
Event DialogLauncherClick As RibbonControlEventHandler

event RibbonControlEventHandler DialogLauncherClick

Hinweise

Das Dialogfeldstartprogramm für das Menüband 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 das Menüband. Weitere Informationen finden Sie unter Gewusst wie: Hinzufügen eines Dialogfeld-Startprogramms zu einer Multifunktionsleistengruppe.

Beispiele

Im folgenden Beispiel wird gezeigt, wie einer Menüband-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 Office-Projekt ein Menüband (Visual Designer)-Element 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();
}

.NET Framework-Sicherheit

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.

Siehe auch

Referenz

RibbonGroup Schnittstelle

Microsoft.Office.Tools.Ribbon-Namespace

Weitere Ressourcen

Gewusst wie: Hinzufügen eines Dialogfeld-Startprogramms zu einer Multifunktionsleistengruppe

Freigeben über