Condividi tramite


Interfaccia RibbonSplitButton

Controllo della barra multifunzione che combina un pulsante o un interruttore e un menu a discesa.

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

Sintassi

'Dichiarazione
<GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")> _
Public Interface RibbonSplitButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable
[GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

Il tipo RibbonSplitButton espone i seguenti membri.

Proprietà

  Nome Descrizione
Proprietà pubblica ButtonEnabled Ottiene o imposta un valore che indica se il pulsante in RibbonSplitButton è abilitato.
Proprietà pubblica ButtonType Ottiene o imposta il tipo di pulsante in RibbonSplitButton.
Proprietà pubblica Checked Ottiene o imposta un valore che indica se l'oggetto RibbonSplitButton viene premuto o meno.
Proprietà pubblica ControlSize Ottiene o imposta la dimensione del controllo RibbonSplitButton.
Proprietà pubblica Description Ottiene o imposta il testo visualizzato nel controllo RibbonSplitButton incluso in un menu a discesa.
Proprietà pubblica Enabled Ottiene o imposta un valore che indica se l'oggetto RibbonControl è abilitato. (Ereditato da RibbonControl)
Proprietà pubblica Id Ottiene una stringa utilizzata da Microsoft Office per identificare l'oggetto RibbonControl. (Ereditato da RibbonControl)
Proprietà pubblica Image Ottiene o imposta l'immagine visualizzata nel controllo.
Proprietà pubblica ImageName Ottiene o imposta il nome utilizzabile nel gestore eventi E:Microsoft.Office.Tools.Ribbon.LoadImage per identificare un'immagine per il controllo.
Proprietà pubblica Items Ottiene l'insieme di controlli presenti in RibbonSplitButton.
Proprietà pubblica ItemSize Ottiene o imposta le dimensioni dei controlli nel menu a discesa RibbonSplitButton.
Proprietà pubblica KeyTip Ottiene o imposta i tasti di scelta rapida del controllo RibbonSplitButton.
Proprietà pubblica Label Ottiene o imposta il testo nel controllo RibbonSplitButton.
Proprietà pubblica Name Ottiene o imposta il nome di RibbonComponent. (Ereditato da RibbonComponent)
Proprietà pubblica OfficeImageId Ottiene o imposta l'immagine da visualizzare nel controllo RibbonSplitButton se si desidera utilizzare un'icona incorporata di Microsoft Office.
Proprietà pubblica Parent Ottiene un oggetto RibbonComponent che rappresenta l'elemento padre di RibbonComponent. (Ereditato da RibbonComponent)
Proprietà pubblica Position Ottiene o imposta la posizione del controllo RibbonSplitButton, se questo è incluso nel menu Microsoft Office.
Proprietà pubblica Ribbon Ottiene l'oggetto Ribbon di primo livello contenente la gerarchia dei controlli. (Ereditato da RibbonComponent)
Proprietà pubblica RibbonUI Infrastruttura. Ottiene l'istanza di IRibbonUI fornita dall'applicazione Microsoft Office al codice di estensibilità della barra multifunzione. (Ereditato da RibbonComponent)
Proprietà pubblica ScreenTip Ottiene o imposta il testo della descrizione comandi visualizzata quando il puntatore del mouse viene passato sul controllo RibbonSplitButton.
Proprietà pubblica ShowLabel Ottiene o imposta un valore che indica se l'etichetta del controllo RibbonSplitButton è visibile o meno.
Proprietà pubblica Site Ottiene o imposta l'oggetto ISite associato a IComponent. (Ereditato da IComponent)
Proprietà pubblica SuperTip Ottiene o imposta il testo su più righe della descrizione comandi visualizzata quando il puntatore del mouse viene passato sul controllo RibbonSplitButton.
Proprietà pubblica Tag Ottiene o imposta dati specifici dell'applicazione associati a RibbonComponent. (Ereditato da RibbonComponent)
Proprietà pubblica Title Ottiene o imposta il titolo visualizzato all'inizio del controllo RibbonSplitButton, se questo è incluso nel menu Microsoft Office.
Proprietà pubblica Visible Ottiene o imposta un valore che indica se RibbonControl è visibile. (Ereditato da RibbonControl)

In alto

Metodi

  Nome Descrizione
Metodo pubblico Dispose Esegue attività definite dall'applicazione, ad esempio libera, rilascia o reimposta risorse non gestite. (Ereditato da IDisposable)
Metodo pubblico PerformDynamicLayout Chiama il metodo Microsoft.Office.Core.IRibbonUI.InvalidateControl del controllo padre se l'oggetto RibbonComponent dispone di un elemento padre dinamico, ad esempio un menu dinamico, e il layout non è sospeso. (Ereditato da RibbonComponent)
Metodo pubblico PerformLayout Effettua la chiamata a Microsoft.Office.Core.IRibbonUI.InvalidateControl se RibbonComponent dispone di un elemento padre e il layout non è sospeso. (Ereditato da RibbonComponent)
Metodo pubblico ResumeLayout() Inverte l'effetto del metodo SuspendLayout. (Ereditato da RibbonComponent)
Metodo pubblico ResumeLayout(Boolean) Inverte l'effetto del metodo SuspendLayout. (Ereditato da RibbonComponent)
Metodo pubblico SuspendLayout Impedisce all'applicazione di Microsoft Office di aggiornare lo stato dei controlli nella barra multifunzione. (Ereditato da RibbonComponent)

In alto

Eventi

  Nome Descrizione
Evento pubblico Click Si verifica quando l'utente fa clic sul controllo RibbonSplitButton.
Evento pubblico Disposed Rappresenta il metodo che gestisce l'evento Disposed di un componente. (Ereditato da IComponent)

In alto

Note

Controllo RibbonSplitButton della barra multifunzione che combina un pulsante o un interruttore e un menu a discesa. Per scegliere tra pulsante e interruttore, utilizzare la proprietà ButtonType.

A differenza del controllo RibbonMenu, il controllo RibbonSplitButton non dispone della proprietà Dynamic, pertanto il contenuto dell'insieme Items non può essere modificato in fase di esecuzione.

È possibile creare RibbonSplitButton in fase di esecuzione tramite il metodo CreateRibbonSplitButton 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.

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.

Vedere anche

Riferimenti

Spazio dei nomi Microsoft.Office.Tools.Ribbon

Altre risorse

Cenni preliminari sulla barra multifunzione

Finestra di progettazione della barra multifunzione

Cenni preliminari sul modello a oggetti della barra multifunzione

Procedura: iniziare a personalizzare la barra multifunzione