Proprietà RibbonGroup.DialogLauncher

Articolo
05/17/2013

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 (in Microsoft.Office.Tools.Common.dll)

Sintassi

'Dichiarazione
Property DialogLauncher As RibbonDialogLauncher

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 Procedura: aggiungere un pulsante di visualizzazione della finestra 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à dell'interfaccia 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à dell'interfaccia RibbonDialogLauncher, ad esempio la proprietà Image, possono essere applicate unicamente quando vengono aggiunte dall'utente 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 Office.
Aggiungere un oggetto RibbonDialogLauncher al gruppo predefinito Group1 come descritto in Procedura: aggiungere un pulsante di visualizzazione della finestra 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";
}

Sicurezza di .NET Framework

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.