RibbonCheckBox Interfaccia

Riferimento

Definizione

Spazio dei nomi:: Microsoft.Office.Tools.Ribbon

Assembly:: Microsoft.Office.Tools.Common.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Rappresenta un controllo di casella di controllo in una barra multifunzione.

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

[System.Runtime.InteropServices.Guid("2119eecb-0ee2-4a64-8b87-b76bd1fa395e")]
public interface RibbonCheckBox : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("2119eecb-0ee2-4a64-8b87-b76bd1fa395e")>]
type RibbonCheckBox = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonCheckBox
Implements IComponent, IDisposable, RibbonControl

Attributi: GuidAttribute

Implementazioni: RibbonComponent RibbonControl IComponent IDisposable

Commenti

È possibile creare un'istanza di questo controllo in fase di esecuzione e aggiungerla a un menu dinamico. Un menu è dinamico se si imposta la relativa Dynamic proprietà su true.

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.

È possibile creare un RibbonCheckBox oggetto in fase di esecuzione usando il CreateRibbonCheckBox 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.

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à

Checked	Ottiene o imposta un valore che indica se RibbonCheckBox è il contenitore predefinito.
Description	Ottiene o imposta una descrizione per questo oggetto RibbonCheckBox che viene visualizzato quando la proprietà `ItemSize` del relativo controllo padre è impostata su RibbonControlSizeLarge.
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)
KeyTip	Ottiene o imposta il tasto di scelta rapida per questo RibbonCheckBox.
Label	Ottiene o imposta il testo visualizzato in questo RibbonCheckBox.
Name	Ottiene o imposta il nome di RibbonComponent. (Ereditato da RibbonComponent)
Parent	Ottiene un oggetto RibbonComponent che rappresenta l'elemento padre di RibbonComponent. (Ereditato da RibbonComponent)
Position	Ottiene o imposta la posizione della casella di controllo, se questa è incluso 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)
ScreenTip	Ottiene o imposta il testo del suggerimento visualizzato quando il puntatore del mouse viene passato su RibbonCheckBox.
SuperTip	Ottiene o imposta il testo del suggerimento su più righe visualizzato quando il puntatore del mouse passa sull'oggetto RibbonCheckBox.
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

Click

Si verifica quando un utente fa clic sulla casella di controllo.

Si applica a

Condividi tramite