Condividi tramite


RibbonDropDown Interfaccia

Definizione

Rappresenta un elenco di elementi da cui l'utente può scegliere un'opzione e un elenco di pulsanti della barra multifunzione su cui l'utente può fare clic.

public interface class RibbonDropDown : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl
Attributi
Implementazioni

Commenti

Un RibbonDropDown oggetto può contenere RibbonDropDownItem oggetti e RibbonButton controlli.

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

Non è possibile aggiungere pulsanti alla raccolta in fase di esecuzione dopo il caricamento della Buttons barra multifunzione in Office.

Le procedure seguenti illustrano come aggiungere RibbonDropDownItem oggetti e RibbonButton controlli a un RibbonDropDownoggetto .

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

Alcuni membri di questo tipo possono essere impostati solo prima che la barra multifunzione venga caricata nell'applicazione Office. 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 una raccolta di oggetti RibbonButton appartenenti a questo RibbonDropDown.

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 un'immagine visualizzata in questo oggetto RibbonDropDown.

ImageName

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

Items

Ottiene una raccolta di elementi inclusi in RibbonDropDown.

KeyTip

Ottiene o imposta il tasto di scelta rapida per questo RibbonDropDown.

Label

Ottiene o imposta il testo visualizzato in questo RibbonDropDown.

Name

Ottiene o imposta il nome di RibbonComponent.

(Ereditato da RibbonComponent)
OfficeImageId

Ottiene o imposta l'immagine da visualizzare nell'oggetto RibbonDropDown, 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)
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 RibbonDropDown.

SelectedItem

Ottiene o imposta l'oggetto RibbonDropDownItem attualmente 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 RibbonDropDown è visibile o meno.

ShowItemImage

Ottiene o imposta un valore che indica se vengono visualizzate immagini per gli elementi nel menu a discesa.

ShowItemLabel

Ottiene o imposta un valore che indica se vengono visualizzate etichette per gli elementi nel menu a discesa.

ShowLabel

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

SizeString

Ottiene o imposta una stringa che determina le dimensioni dell'oggetto RibbonDropDown.

SuperTip

Ottiene o imposta il testo del suggerimento su più righe visualizzato quando il puntatore del mouse passa sull'oggetto RibbonDropDown.

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 un oggetto RibbonDropDown.

ItemsLoading

Si verifica quando i controlli vengono caricati in RibbonDropDown.

SelectionChanged

Si verifica quando viene selezionato un nuovo elemento in un controllo a discesa di una barra multifunzione.

Si applica a