RibbonComboBox Interface

Définition

Espace de noms:

Microsoft.Office.Tools.Ribbon

Assembly:

Microsoft.Office.Tools.Common.dll

Représente une zone de liste déroulante sur un ruban personnalisé.

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

[System.Runtime.InteropServices.Guid("97074be3-d4bb-4923-881a-7a6e225738af")]
public interface RibbonComboBox : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("97074be3-d4bb-4923-881a-7a6e225738af")>]
type RibbonComboBox = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonComboBox
Implements IComponent, IDisposable, RibbonControl

Attributs

GuidAttribute

Implémente

RibbonComponent RibbonControl IComponent IDisposable

Remarques

Une zone de liste déroulante présente à un utilisateur un champ d’entrée de texte et une liste de choix dans un menu déroulant.

Vous pouvez créer un au moment de RibbonComboBox l’exécution à l’aide de la CreateRibbonComboBox méthode de l’objet RibbonFactory .

Il existe deux façons d'accéder à l'objet RibbonFactory :

• À l'aide de la propriété Factory de la classe Ribbon. Utilisez cette approche basée sur le code dans votre classe Ribbon.

• À l'aide de la méthode Globals.Factory.GetRibbonFactory. Utilisez cette approche basée sur le code hors de votre classe Ribbon.

Certains membres de ce type ne peuvent être définis qu’avant le chargement du ruban dans l’application Office. Pour plus d’informations sur la définition de ces propriétés, consultez Vue d’ensemble du modèle objet du ruban.

Notes

Cette interface est implémentée par Visual Studio Tools pour Office Runtime. Elle n'est pas destinée à être implémentée dans votre code. Pour plus d'informations, consultez Visual Studio Tools for Office Runtime Overview.

Utilisation

Cette documentation décrit la version de ce type utilisée dans les projets Office qui ciblent le .NET Framework 4 ou ultérieur. Dans les projets qui ciblent .NET Framework 3.5, ce type peut contenir d'autres membres, et les exemples de code qui y figurent sont susceptibles de ne pas fonctionner. Pour obtenir de la documentation sur ce type dans les projets ciblant .NET Framework 3.5, consultez la section de référence suivante dans la documentation Visual Studio 2008 : http://go.microsoft.com/fwlink/?LinkId=160658.

Propriétés

Enabled	Obtient ou définit une valeur qui indique si ce RibbonControl est activé. (Hérité de RibbonControl)
Id	Obtient une chaîne que Microsoft Office utilise pour identifier cet objet RibbonControl. (Hérité de RibbonControl)
Image	Obtient ou définit une image affichée sur cette RibbonComboBox.
ImageName	Obtient ou définit le nom que vous pouvez utiliser dans le gestionnaire d’événements LoadImage pour identifier une image pour le contrôle.
Items	Obtient une collection des éléments contenus dans cette RibbonComboBox.
KeyTip	Obtient ou définit le raccourci clavier de cette RibbonComboBox.
Label	Obtient ou définit le texte qui apparaît dans cette RibbonComboBox.
MaxLength	Obtient ou définit une valeur qui indique le nombre maximal de caractères autorisés par entrée dans cette RibbonComboBox.
Name	Obtient ou définit le nom de ce RibbonComponent. (Hérité de RibbonComponent)
OfficeImageId	Obtient ou définit l’image à afficher sur la RibbonComboBox, si vous souhaitez utiliser une icône Microsoft Office intégrée.
Parent	Obtient un RibbonComponent qui représente le parent de ce RibbonComponent. (Hérité de RibbonComponent)
Ribbon	Obtient l’objet Ribbon de niveau supérieur qui contient la hiérarchie des contrôles. (Hérité de RibbonComponent)
RibbonUI	Obtient l’instance IRibbonUI fournie par l’application Microsoft Office au code d’extensibilité du ruban. (Hérité de RibbonComponent)
ScreenTip	Obtient ou définit le texte info-bulle qui apparaît lorsque l’utilisateur déplace le pointeur sur la RibbonComboBox.
ShowImage	Obtient ou définit une valeur qui indique si l’image associée au RibbonComboBox est visible.
ShowItemImage	Obtient ou définit une valeur qui indique si les images sont affichées pour les éléments du menu déroulant.
ShowLabel	Obtient ou définit une valeur qui indique si l’étiquette de cette RibbonComboBox est visible.
SizeString	Obtient ou définit une chaîne qui détermine la taille de la RibbonComboBox.
SuperTip	Obtient ou définit le texte info-bulle multiligne qui apparaît lorsque l’utilisateur déplace le pointeur sur la RibbonComboBox.
Tag	Obtient ou définit des données propres à l’application associées à ce RibbonComponent. (Hérité de RibbonComponent)
Text	Obtient ou définit le texte qui apparaît dans ce RibbonComboBox.
Visible	Obtient ou définit une valeur qui indique si ce RibbonControl est visible. (Hérité de RibbonControl)

Méthodes

PerformDynamicLayout()	Appelle la méthode Microsoft.Office.Core.IRibbonUI.InvalidateControl du contrôle parent, si le RibbonComponent a un parent dynamique, tel qu’un menu dynamique, et que la disposition n’est pas interrompue. (Hérité de RibbonComponent)
PerformLayout()	Appelle Microsoft.Office.Core.IRibbonUI.InvalidateControl si le RibbonComponent a un parent et que la disposition n’est pas interrompue. (Hérité de RibbonComponent)
ResumeLayout()	Inverse l’effet de la méthode SuspendLayout(). (Hérité de RibbonComponent)
ResumeLayout(Boolean)	Inverse l’effet de la méthode SuspendLayout(). (Hérité de RibbonComponent)
SuspendLayout()	Empêche l'application Microsoft Office d'actualiser l'état des contrôles sur le ruban. (Hérité de RibbonComponent)

Événements

ItemsLoading	Se produit lorsque la liste déroulante de cette RibbonComboBox est ouverte.
TextChanged	Se produit quand un utilisateur modifie le texte de la RibbonComboBox.