Evento RibbonGroup.DialogLauncherClick

Articolo
08/11/2011

Si verifica quando viene fatto clic sull'icona del pulsante di visualizzazione della finestra di dialogo della barra multifunzione nel gruppo.

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

Sintassi

'Dichiarazione
Event DialogLauncherClick As RibbonControlEventHandler

event RibbonControlEventHandler DialogLauncherClick

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.

Esempi

Nell'esempio seguente viene illustrato come aggiungere un pulsante di visualizzazione della finestra di dialogo a un gruppo della barra multifunzione e come avviare una finestra di dialogo personalizzata che consente agli utenti di scegliere impostazioni avanzate quando selezionano l'icona RibbonDialogLauncher nell'angolo inferiore destro dell'oggetto RibbonGroup.

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 come descritto in Procedura: aggiungere un pulsante di visualizzazione della finestra di dialogo a un gruppo della barra multifunzione.
Se si utilizza Visual Basic, aggiungere un nuovo elemento Finestra di dialogo di Windows Form al progetto. Se si utilizza C#, aggiungere un nuovo elemento Windows Form e trasformarlo in una finestra di dialogo aggiungendo un pulsante OK e Annulla al form e creando gestori eventi per gli eventi Click dei pulsanti.
Impostare la proprietà (Name) della finestra di dialogo su advancedSettingsDialog. È possibile personalizzare la finestra di dialogo aggiungendo controlli e impostando più proprietà.
Aggiungere il gestore eventi DialogLauncherClick al codice.
Posizionare il contenuto del metodo seguente nel gestore eventi DialogLauncherClick.

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();
}

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.

Vedere anche

Riferimenti

RibbonGroup Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Ribbon

Altre risorse

Procedura: aggiungere un pulsante di visualizzazione della finestra di dialogo a un gruppo della barra multifunzione

Condividi tramite