Proprietà RibbonGroup.DialogLauncher (System 2007)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Ottiene o imposta il pulsante di visualizzazione della finestra di dialogo della barra multifunzione associato al gruppo.

Spazio dei nomi: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (in Microsoft.Office.Tools.Common.v9.0.dll)

Sintassi

Public Property DialogLauncher As RibbonDialogLauncher

Dim instance As RibbonGroup
Dim value As RibbonDialogLauncher

value = instance.DialogLauncher

instance.DialogLauncher = value

public RibbonDialogLauncher DialogLauncher { get; set; }

Valore proprietà

Tipo: Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher

Pulsante di visualizzazione della finestra di dialogo della barra multifunzione associato al gruppo.

Note

Il pulsante di visualizzazione della finestra di dialogo della barra multifunzione è costituito da una piccola icona visualizzata nel gruppo. Facendo clic su questa icona è possibile gestire l'evento DialogLauncherClick per aprire una finestra di dialogo personalizzata. Per impostazione predefinita, i gruppi non dispongono di un pulsante di visualizzazione della finestra di dialogo della barra multifunzione. Per ulteriori informazioni, vedere la classe Procedura: aggiungere un'utilità di avvio di finestre di dialogo a un gruppo della barra multifunzione.

Per personalizzare il comportamento del pulsante di visualizzazione della finestra di dialogo della barra multifunzione, utilizzare le proprietà della classe RibbonDialogLauncher. Ad esempio, per impostare il suggerimento visualizzato quando il puntatore viene spostato sull'icona del pulsante di visualizzazione della finestra di dialogo, utilizzare la proprietà ScreenTip.

Alcune proprietà della classe RibbonDialogLauncher, ad esempio la proprietà Image, possono essere applicate unicamente quando vengono aggiunte alla barra di accesso rapido.

Esempi

Nell'esempio seguente viene illustrato come impostare le proprietà KeyTip e ScreenTip nell'oggetto RibbonDialogLauncher aggiunto al gruppo predefinito.

Per eseguire questo esempio di codice, effettuare innanzitutto le seguenti operazioni:

Aggiungere un elemento Barra multifunzione (finestra di progettazione visiva) a un progetto Visual Studio Tools per Office.
Aggiungere un oggetto RibbonDialogLauncher al gruppo predefinito Group1 come descritto in Procedura: aggiungere un'utilità di avvio di finestre di dialogo a un gruppo della barra multifunzione.

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";
}

Autorizzazioni

Attendibilità totale per il chiamante immediato. Impossibile utilizzare questo membro in codice parzialmente attendibile. Per ulteriori informazioni, vedere Utilizzo di librerie da codice parzialmente attendibile.