Condividi tramite


RibbonToggleButton Interfaccia

Definizione

Rappresenta un controllo interruttore in una barra multifunzione.

public interface class RibbonToggleButton : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("fc50977f-187c-4082-ab53-087e81f4ded1")]
public interface RibbonToggleButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("fc50977f-187c-4082-ab53-087e81f4ded1")>]
type RibbonToggleButton = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonToggleButton
Implements IComponent, IDisposable, RibbonControl
Attributi
Implementazioni

Commenti

Un RibbonToggleButton oggetto può essere utilizzato per indicare se un elemento è selezionato.

È possibile creare un RibbonToggleButton oggetto in fase di esecuzione usando il CreateRibbonToggleButton 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 l'interruttore viene premuto o meno.

ControlSize

Ottiene o imposta la dimensione del controllo RibbonToggleButton .

Description

Ottiene o imposta il testo visualizzato nel controllo RibbonToggleButton in un menu.

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 controllo.

ImageName

Ottiene o imposta il nome che può essere usato nel gestore eventi di LoadImage per identificare un'immagine per il controllo.

KeyTip

Ottiene o imposta i tasti di scelta rapida dell'interruttore.

Label

Ottiene o imposta il testo visualizzato sull'interruttore.

Name

Ottiene o imposta il nome di RibbonComponent.

(Ereditato da RibbonComponent)
OfficeImageId

Ottiene o imposta l'immagine da visualizzare nell'oggetto RibbonToggleButton, 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 di RibbonToggleButton, se il controllo è 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 sull'interruttore.

ShowImage

Ottiene o imposta un valore che indica se l'immagine associata a RibbonToggleButton è visibile o meno.

ShowLabel

Ottiene o imposta un valore che indica se l'etichetta per RibbonToggleButton è visibile.

SuperTip

Ottiene o imposta il testo su più righe del suggerimento visualizzato quando il puntatore del mouse viene passato sul controllo RibbonToggleButton.

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 l'utente fa clic sul controllo RibbonToggleButton.

Si applica a