RibbonGroup.DialogLauncher-Eigenschaft

Artikel
08/10/2011

Ruft das der Gruppe zugeordnete Dialogfeldstartprogramm für das Menüband ab oder legt es fest.

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

Syntax

'Declaration
Property DialogLauncher As RibbonDialogLauncher
    Get
    Set

RibbonDialogLauncher DialogLauncher { get; set; }

Eigenschaftswert

Typ: Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher
Das der Gruppe zugeordnete Dialogfeldstartprogramm für das Menüband.

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.

Das Verhalten des Dialogfeldstartprogramms für das Menüband kann mithilfe der Eigenschaften der RibbonDialogLauncher-Schnittstelle angepasst werden. Soll beispielsweise die QuickInfo festgelegt werden, die angezeigt wird, wenn der Benutzer den Zeiger über das Symbol für das Dialogfeldstartprogramm richtet, verwenden Sie die ScreenTip-Eigenschaft.

Einige Eigenschaften der RibbonDialogLauncher-Schnittstelle, z. B. die Image-Eigenschaft, sind nur gültig, wenn der Endbenutzer sie der Symbolleiste für den Schnellzugriff hinzufügt.

Beispiele

Im folgenden Beispiel wird dargestellt, wie die KeyTip-Eigenschaft und die ScreenTip-Eigenschaft für das der Standardgruppe hinzugefügte RibbonDialogLauncher festgelegt wird.

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 Group1 einen RibbonDialogLauncher hinzu, wie in Gewusst wie: Hinzufügen eines Dialogfeld-Startprogramms zu einer Multifunktionsleistengruppe erläutert.

Private Sub SetDialogLauncherProperties()
    Group1.DialogLauncher.KeyTip = "A"
    Group1.DialogLauncher.ScreenTip = "Advanced Settings"
End Sub

private void SetDialogLauncherProperties()
{
    group1.DialogLauncher.KeyTip = "A";
    group1.DialogLauncher.ScreenTip = "Advanced Settings";
}

.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.