RibbonGroup.DialogLauncher-Eigenschaft (2007 System)

Článek
08/23/2008

Aktualisiert: November 2007

Ruft das der Gruppe zugeordnete Dialogfeldstartprogramm für die Multifunktionsleiste ab oder legt es fest.

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

Syntax

'Declaration
Public Property DialogLauncher As RibbonDialogLauncher
'Usage
Dim instance As RibbonGroup
Dim value As RibbonDialogLauncher

value = instance.DialogLauncher

instance.DialogLauncher = value

public RibbonDialogLauncher DialogLauncher { get; set; }

Eigenschaftenwert

Typ: Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher

Das der Gruppe zugeordnete Dialogfeldstartprogramm für die Multifunktionsleiste.

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.

Das Verhalten des Dialogfeldstartprogramms für die Multifunktionsleiste kann mithilfe der Eigenschaften der RibbonDialogLauncher-Klasse 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-Klasse (beispielsweise 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 Visual Studio Tools for Office-Projekt ein Element von Multifunktionsleiste (Visual Designer) 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";
}

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.