RibbonDropDown, interface
Représente une liste des éléments qu'un utilisateur peut sélectionner et une liste des boutons du ruban sur lequel il peut cliquer.
Espace de noms : Microsoft.Office.Tools.Ribbon
Assembly : Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)
Syntaxe
'Déclaration
<GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")> _
Public Interface RibbonDropDown _
Inherits RibbonControl, RibbonComponent, IComponent, IDisposable
[GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : RibbonControl,
RibbonComponent, IComponent, IDisposable
Le type RibbonDropDown expose les membres suivants.
Propriétés
Nom | Description | |
---|---|---|
![]() |
Buttons | Obtient une collection d'objets RibbonButton appartenant à ce RibbonDropDown. |
![]() |
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 qui est affichée sur ce RibbonDropDown. |
![]() |
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 dans ce RibbonDropDown. |
![]() |
KeyTip | Obtient ou définit le raccourci clavier pour ce RibbonDropDown. |
![]() |
Label | Obtient ou définit le texte qui apparaît sur ce RibbonDropDown. |
![]() |
Name | Obtient ou définit le nom de ce RibbonComponent. (Hérité de RibbonComponent.) |
![]() |
OfficeImageId | Obtient ou définit l'image à afficher sur le RibbonDropDown, 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 | Infrastructure. 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 le RibbonDropDown. |
![]() |
SelectedItem | Obtient ou définit le RibbonDropDownItem qui est actuellement sélectionné. |
![]() |
SelectedItemIndex | Obtient ou définit l'index du RibbonDropDownItem sélectionné actuellement. |
![]() |
ShowImage | Obtient ou définit une valeur qui indique si l'image associée au RibbonDropDown est visible. |
![]() |
ShowItemImage | Obtient ou définit une valeur qui indique si les images sont affichées pour les éléments dans le menu déroulant. |
![]() |
ShowItemLabel | Obtient ou définit une valeur qui indique si les étiquettes sont affichées pour les éléments dans le menu déroulant. |
![]() |
ShowLabel | Obtient ou définit une valeur qui indique si l'étiquette de ce RibbonDropDown est visible. |
![]() |
Site | Obtient ou définit le ISite associé à IComponent. (Hérité de IComponent.) |
![]() |
SizeString | Obtient ou définit une chaîne qui détermine la taille du RibbonDropDown. |
![]() |
SuperTip | Obtient ou définit le texte info-bulle multiligne qui apparaît lorsque l'utilisateur déplace le pointeur sur le RibbonDropDown. |
![]() |
Tag | Obtient ou définit des données spécifiques à l'application associées à ce RibbonComponent. (Hérité de RibbonComponent.) |
![]() |
Visible | Obtient ou définit une valeur qui indique si ce RibbonControl est visible. (Hérité de RibbonControl.) |
Début
Méthodes
Nom | Description | |
---|---|---|
![]() |
Dispose | Exécute les tâches définies par l'application associées à la libération ou à la redéfinition des ressources non managées. (Hérité de IDisposable.) |
![]() |
PerformDynamicLayout | Appelle la méthode Microsoft.Office.Core.IRibbonUI.InvalidateControl du contrôle parent si RibbonComponent possède un parent dynamique, tel qu'un menu dynamique, et si 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 mise en page 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.) |
Début
Événements
Nom | Description | |
---|---|---|
![]() |
ButtonClick | Se produit lorsqu'un utilisateur clique sur un bouton sur un RibbonDropDown. |
![]() |
Disposed | Représente la méthode qui gère l'événement Disposed d'un composant. (Hérité de IComponent.) |
![]() |
ItemsLoading | Se produit lorsque les contrôles sont chargés dans le RibbonDropDown. |
![]() |
SelectionChanged | Se produit lorsqu'un utilisateur sélectionne un nouveau contrôle déroulant de ruban. |
Début
Notes
Un RibbonDropDown peut contenir des objets RibbonDropDownItem et des contrôles RibbonButton.
Vous pouvez créer un RibbonDropDown au moment de l'exécution à l'aide de la méthode CreateRibbonDropDown de l'objet RibbonFactory.
Il existe deux méthodes pour accéder à l'objet RibbonFactory :
En utilisant la propriété Factory de la classe du ruban.Utilisez cette approche depuis le code dans votre classe de ruban.
En utilisant la méthode Globals.Factory.GetRibbonFactory.Utilisez cette approche depuis le code en dehors de votre classe de ruban.
Vous ne pouvez pas ajouter de boutons à la collection Buttons au moment de l'exécution une fois le Ruban chargé dans Office.
Les procédures suivantes expliquent comment ajouter des objets RibbonDropDownItem et des contrôles RibbonButton à un RibbonDropDown.
Pour ajouter des objets RibbonDropDownItem au moment du design
Cliquez sur la propriété Items dans la fenêtre Propriétés.
Cliquez sur le bouton de sélection (...).
Dans l'Éditeur de collections DropDown, ajoutez, classez et modifiez les nouveaux éléments.
Vous pouvez ajouter des contrôles RibbonButton à un RibbonDropDown au moment du design.
Pour ajouter des contrôles RibbonButton au moment du design
Cliquez sur la propriété Buttons dans la fenêtre Propriétés.
Cliquez sur le bouton de sélection (...).
Dans l'Éditeur de collections Button, ajoutez, classez et modifiez les nouveaux contrôles bouton.
Certains membres de ce type peuvent être définis uniquement 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 de ruban.
[!REMARQUE]
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 Vue d'ensemble de Visual Studio Tools pour Office Runtime.
Utilisation
Cette documentation décrit la version de ce type utilisée dans les projets Office qui ciblent .NET Framework 4 et .NET Framework 4.5. 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 : https://go.microsoft.com/fwlink/?LinkId=160658.
Voir aussi
Référence
Microsoft.Office.Tools.Ribbon, espace de noms