Classe RibbonDialogLauncher (System 2007)

Articolo
09/12/2008

Aggiornamento: novembre 2007

Rappresenta una piccola icona standardizzata in un gruppo utilizzabile per aprire una finestra di dialogo.

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

Sintassi

Public NotInheritable Class RibbonDialogLauncher _
    Implements IDisposable

Dim instance As RibbonDialogLauncher

public sealed class RibbonDialogLauncher : IDisposable

Note

Per impostazione predefinita, nell'angolo inferiore destro di un gruppo viene visualizzato un oggetto RibbonDialogLauncher.

Le proprietà Image, ImageName e OfficeImageId non hanno alcun effetto visibile quando l'oggetto RibbonDialogLauncher viene visualizzato in un gruppo della barra multifunzione. Tuttavia, quando viene aggiunto un oggetto RibbonDialogLauncher alla barra di accesso rapido, tali proprietà controllano il comportamento dell'immagine visualizzata. La proprietà Visible, inoltre, non nasconde l'oggetto RibbonDialogLauncher quando questo viene visualizzato nella barra di accesso rapido. L'utente può aggiungere l'oggetto RibbonDialogLauncher alla Barra degli strumenti accesso rapido tramite l'elemento Barra multifunzione (XML). Per ulteriori informazioni, vedere la classe Cenni preliminari sulla barra multifunzione.

RibbonDialogLauncher è applicabile unicamente a RibbonGroup. La classe RibbonGroup dispone di un membro DialogLauncher del tipo RibbonDialogLauncher. Per ulteriori informazioni sull'aggiunta di RibbonDialogLauncher a RibbonGroup, vedere Procedura: aggiungere un'utilità di avvio di finestre di dialogo a un gruppo della barra multifunzione.

Alcune proprietà di questo controllo possono essere impostate unicamente prima del caricamento della barra multifunzione nell'applicazione di Office. Per ulteriori informazioni sull'impostazione di tali proprietà, vedere Cenni preliminari sul modello a oggetti della barra multifunzione.

Esempi

Nell'esempio seguente viene illustrato come aggiungere un oggetto RibbonDialogLauncher 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 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.
Se si utilizza Visual Basic, aggiungere un nuovo elemento Finestra di dialogo al progetto. Se si utilizza C#, aggiungere un nuovo elemento Windows Form e trasformarlo in una finestra di dialogo aggiungendo i pulsanti 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();
}