RibbonGallery Interfaccia

Definizione

Spazio dei nomi:

Microsoft.Office.Tools.Ribbon

Assembly:

Microsoft.Office.Tools.Common.dll

Rappresenta un controllo che visualizza un menu di oggetti RibbonDropDownItem e controlli RibbonButton.

public interface class RibbonGallery : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

Attributi

GuidAttribute

Implementazioni

RibbonComponent RibbonControl IComponent IDisposable

Commenti

Come l'interfaccia RibbonDropDown , RibbonGallery visualizza un menu di RibbonDropDownItem oggetti e RibbonButton controlli.

A differenza dell'interfaccia, l'interfaccia RibbonDropDownRibbonGallery genera Click eventi, anziché SelectionChanged eventi, quando un utente fa clic su un RibbonDropDownItemoggetto . Ciò significa, ad esempio, che l'evento Click viene generato due volte quando un utente fa clic sullo stesso RibbonDropDownItem doppio. L'evento SelectionChanged verrà generato al massimo una volta quando la selezione iniziale è stata eseguita per lo stesso scenario in un RibbonDropDownoggetto , a seconda della selezione prima del primo clic.

La ShowItemSelection proprietà controlla se l'oggetto attualmente selezionato RibbonDropDownItem è differenziato visivamente dagli elementi non selezionati. È possibile selezionare un solo elemento alla volta in un RibbonGalleryoggetto .

La ItemImageSize proprietà può essere usata per specificare le dimensioni dell'immagine diverse da 16x16 e 32x32.

Per aggiungere oggetti RibbonDropDownItem in fase di progettazione

1. Fare clic sulla proprietà Items nella finestra Proprietà .

2. Fare clic sui puntini di sospensione (...).

3. Nella raccolta a discesa Editor, aggiungere, ordinare e modificare nuovi elementi.

È possibile aggiungere RibbonButton controlli a un oggetto RibbonGallery in fase di progettazione.

Per aggiungere controlli RibbonButton in fase di progettazione

1. Fare clic sulla proprietà Button nella finestra Proprietà .

2. Fare clic sui puntini di sospensione (...).

3. Nella raccolta button Editor aggiungere, ordinare e modificare i nuovi controlli pulsante.

È possibile creare un RibbonGallery oggetto in fase di esecuzione usando il CreateRibbonGallery metodo dell' RibbonFactory oggetto.

Sono disponibili due modi per accedere all'oggetto RibbonFactory:

• Usando la proprietà Factory della classe Ribbon. Usare questo approccio dal codice della classe Ribbon.

• Usando il metodo Globals.Factory.GetRibbonFactory. Usare questo approccio dal codice all'esterno della classe Ribbon.

Alcune proprietà di questo controllo possono essere impostate solo prima che la barra multifunzione venga caricata nell'applicazione di Office o prima che il controllo venga aggiunto a un menu dinamico in fase di esecuzione. Per informazioni sull'impostazione di queste proprietà, vedere Panoramica del modello a oggetti della barra multifunzione.

Nota

Questa interfaccia è implementata da Visual Studio Tools per Office Runtime. Non deve essere implementata nel codice. Per altre informazioni, vedere Visual Studio Tools for Office Runtime Overview.

Utilizzo

In questa documentazione viene descritta la versione di questo tipo usata nei progetti Office destinati a .NET Framework 4 o versione successiva. 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: http://go.microsoft.com/fwlink/?LinkId=160658.

Proprietà

Buttons	Ottiene l'insieme dei pulsanti in RibbonGallery.
ColumnCount	Ottiene o imposta il numero di colonne di Item in RibbonGallery.
ControlSize	Ottiene o imposta la dimensione del controllo RibbonGallery .
Description	Ottiene o imposta il testo visualizzato nel controllo RibbonGallery in un menu o un pulsante di menu combinato.
Enabled	Ottiene o imposta un valore che indica se RibbonControl è abilitato. (Ereditato da RibbonControl)
Id	Ottiene una stringa usata da Microsoft Office per identificare questo oggetto RibbonControl. (Ereditato da RibbonControl)
Image	Ottiene o imposta l'immagine visualizzata nel pulsante.
ImageName	Ottiene o imposta il nome che può essere usato per identificare RibbonGallery nel gestore eventi LoadImage.
ItemImageSize	Ottiene o imposta un oggetto Size che specifica le dimensioni delle immagini visualizzate dagli elementi in RibbonGallery.
Items	Ottiene una raccolta di componenti di RibbonDropDownItem in RibbonGallery.
KeyTip	Ottiene o imposta il tasto di scelta rapida per questo RibbonGallery.
Label	Ottiene o imposta il testo visualizzato in questo RibbonGallery.
Name	Ottiene o imposta il nome di RibbonComponent. (Ereditato da RibbonComponent)
OfficeImageId	Ottiene o imposta l'immagine da visualizzare nel controllo se si vuole usare un'icona predefinita di Microsoft Office.
Parent	Ottiene un oggetto RibbonComponent che rappresenta l'elemento padre di RibbonComponent. (Ereditato da RibbonComponent)
Position	Ottiene o imposta la posizione della raccolta, se questa è inclusa nel menu Microsoft Office.
Ribbon	Ottiene l'oggetto Ribbon di primo livello che contiene la gerarchia del controllo. (Ereditato da RibbonComponent)
RibbonUI	Ottiene l'istanza di IRibbonUI definita dall'applicazione Microsoft Office per il codice di estendibilità della barra multifunzione. (Ereditato da RibbonComponent)
RowCount	Ottiene o imposta il numero di righe dei componenti RibbonDropDownItem visualizzati da RibbonGallery.
ScreenTip	Ottiene o imposta il testo del suggerimento visualizzato quando il puntatore del mouse viene passato su RibbonGallery.
SelectedItem	Ottiene o imposta l'elemento selezionato.
SelectedItemIndex	Ottiene o imposta l'indice dell'oggetto RibbonDropDownItem attualmente selezionato.
ShowImage	Ottiene o imposta un valore che indica se l'immagine associata a RibbonGallery è visibile o meno.
ShowItemImage	Ottiene o imposta un valore che indica se vengono visualizzate immagini per gli elementi nella raccolta.
ShowItemLabel	Ottiene o imposta un valore che indica se le etichette vengono visualizzate per gli elementi in RibbonGallery.
ShowItemSelection	Ottiene o imposta un valore che indica se l'oggetto RibbonDropDownItem attualmente selezionato è visivamente distinguibile dagli altri elementi non selezionati.
ShowLabel	Ottiene o imposta un valore che indica se l'etichetta per RibbonGallery è visibile o meno.
SuperTip	Ottiene o imposta il testo del suggerimento su più righe visualizzato quando il puntatore del mouse passa sull'oggetto RibbonGallery.
Tag	Ottiene o imposta dati specifici dell'applicazione associati a RibbonComponent. (Ereditato da RibbonComponent)
Visible	Ottiene o imposta un valore che indica se RibbonControl è visibile. (Ereditato da RibbonControl)

Metodi

PerformDynamicLayout()	Chiama il metodo Microsoft.Office.Core.IRibbonUI.InvalidateControl del controllo padre se RibbonComponent ha un elemento padre dinamico, ad esempio un menu dinamico, e il layout non è sospeso. (Ereditato da RibbonComponent)
PerformLayout()	Chiama Microsoft.Office.Core.IRibbonUI.InvalidateControl se RibbonComponent ha un elemento padre e il layout non è sospeso. (Ereditato da RibbonComponent)
ResumeLayout()	Inverte l'effetto del metodo SuspendLayout(). (Ereditato da RibbonComponent)
ResumeLayout(Boolean)	Inverte l'effetto del metodo SuspendLayout(). (Ereditato da RibbonComponent)
SuspendLayout()	Impedisce all'applicazione di Microsoft Office di aggiornare lo stato dei controlli nella barra multifunzione. (Ereditato da RibbonComponent)

Eventi

ButtonClick	Si verifica quando un utente fa clic su un pulsante in RibbonGallery.
Click	Si verifica quando un utente fa clic su un elemento in RibbonGallery.
ItemsLoading	Si verifica quando l'oggetto RibbonGallery viene aperto.