Interfaccia RibbonDialogLauncher

Articolo
08/11/2011

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

Sintassi

'Dichiarazione
<GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")> _
Public Interface RibbonDialogLauncher _
    Inherits IDisposable

[GuidAttribute("e143d5e9-e844-4052-9793-2070185d351d")]
public interface RibbonDialogLauncher : IDisposable

Il tipo RibbonDialogLauncher espone i seguenti membri.

Proprietà

	Nome	Descrizione
	Enabled	Ottiene o imposta un valore che indica se l'oggetto RibbonDialogLauncher è abilitato.
	Image	Ottiene o imposta un'immagine visualizzata sull'oggetto RibbonDialogLauncher quando questo viene aggiunto alla barra di accesso rapido.
	ImageName	Ottiene o imposta un identificatore utilizzato per assegnare un'immagine all'oggetto RibbonDialogLauncher quando questo viene aggiunto alla barra di accesso rapido.
	KeyTip	Ottiene o imposta il tasto di scelta rapida per RibbonDialogLauncher.
	OfficeImageId	Ottiene o imposta l'immagine da visualizzare in RibbonDialogLauncher se si desidera utilizzare un'icona incorporata di Microsoft Office.
	Parent	Ottiene l'oggetto RibbonGroup cui appartiene RibbonDialogLauncher.
	Ribbon	Ottiene l'oggetto OfficeRibbon in cui è posizionato l'oggetto RibbonDialogLauncher.
	ScreenTip	Ottiene o imposta il testo del suggerimento visualizzato quando il puntatore del mouse viene passato su RibbonDialogLauncher.
	SuperTip	Ottiene o imposta il testo del suggerimento su più righe visualizzato quando il puntatore del mouse viene passato su RibbonDialogLauncher.
	Visible	Ottiene o imposta un valore che indica se RibbonDialogLauncher è visibile.

In alto

Metodi

	Nome	Descrizione
	Dispose	Esegue attività definite dall'applicazione, ad esempio libera, rilascia o reimposta risorse non gestite. (Ereditato da IDisposable)
	ResumeLayout	Inverte l'effetto del metodo SuspendLayout.
	SuspendLayout	Impedisce all'applicazione di Microsoft Office di aggiornare lo stato dei controlli in OfficeRibbon.

In alto

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 Cenni preliminari sulla barra multifunzione.

RibbonDialogLauncher è applicabile unicamente a RibbonGroup. L'oggetto RibbonGroup dispone di un membro DialogLauncher del tipo RibbonDialogLauncher. Per ulteriori informazioni sull'aggiunta di RibbonDialogLauncher a RibbonGroup, vedere Procedura: aggiungere un pulsante di visualizzazione della finestra di dialogo a un gruppo della barra multifunzione.

È possibile creare RibbonDialogLauncher in fase di esecuzione tramite il metodo CreateRibbonDialogLauncher dell'oggetto RibbonFactory.

Sono disponibili due modi per accedere all'oggetto RibbonFactory:

Mediante la proprietà Factory della classe Ribbon. Utilizzare questo approccio dal codice della classe Ribbon.
Mediante il metodo Globals.Factory.GetRibbonFactory. Utilizzare questo approccio dal codice all'esterno della classe Ribbon.

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.

Nota

Questa interfaccia è implementata da Visual Studio Tools per Office Runtime. Non deve essere implementata nel codice. Per ulteriori informazioni, vedere Cenni preliminari su Visual Studio Tools per Office Runtime.

Utilizzo

Nella presente documentazione viene descritta la versione di questo tipo utilizzata nei progetti di Office destinati a .NET Framework 4. Nei progetti destinati a .NET Framework 3.5, questo tipo potrebbe avere membri diversi e gli esempi di codice forniti per il tipo potrebbero non funzionare. Per la documentazione relativa a questo tipo nei progetti destinati a .NET Framework 3.5, vedere la sezione di riferimento seguente nella documentazione di Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

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