RibbonDropDown Interface

Définition

Représente la liste des éléments proposés à un utilisateur et la liste des boutons du ruban sur lesquels un utilisateur peut cliquer.

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
Attributs
Implémente

Remarques

Un RibbonDropDown peut contenir des RibbonDropDownItem objets et RibbonButton des contrôles.

Vous pouvez créer un RibbonDropDown au moment de l’exécution à l’aide de la CreateRibbonDropDown 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.

Vous ne pouvez pas ajouter de boutons à la Buttons collection au moment de l’exécution après le chargement du ruban dans Office.

Les procédures ci-dessous expliquent comment ajouter RibbonDropDownItem des objets et RibbonButton des contrôles à un RibbonDropDown.

Pour ajouter des objets RibbonDropDownItem au moment du design

  1. Cliquez sur la propriété Items dans la fenêtre Propriétés .

  2. Cliquez sur les points de suspension (...).

  3. Dans la collection déroulante, Rédacteur, ajouter, classer et modifier de nouveaux éléments.

Vous pouvez ajouter RibbonButton des contrôles à un RibbonDropDown au moment du design.

Pour ajouter des contrôles RibbonButton au moment du design

  1. Cliquez sur la propriété Buttons dans la fenêtre Propriétés .

  2. Cliquez sur les points de suspension (...).

  3. Dans la collection de boutons, Rédacteur, ajouter, classer et modifier de nouveaux contrôles de 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 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

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 affichée sur cette 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 contenus dans cette RibbonDropDown.

KeyTip

Obtient ou définit le raccourci clavier de cette RibbonDropDown.

Label

Obtient ou définit le texte qui apparaît dans cette RibbonDropDown.

Name

Obtient ou définit le nom de ce RibbonComponent.

(Hérité de RibbonComponent)
OfficeImageId

Obtient ou définit l’image à afficher sur la 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

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

SelectedItem

Obtient ou définit le RibbonDropDownItem actuellement sélectionné.

SelectedItemIndex

Obtient ou définit l’index du RibbonDropDownItem actuellement sélectionné.

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 du menu déroulant.

ShowItemLabel

Obtient ou définit une valeur qui indique si les étiquettes 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 RibbonDropDown est visible.

SizeString

Obtient ou définit une chaîne qui détermine la taille de la RibbonDropDown.

SuperTip

Obtient ou définit le texte info-bulle multiligne qui apparaît lorsque l’utilisateur déplace le pointeur sur la RibbonDropDown.

Tag

Obtient ou définit des données propres à 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)

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

ButtonClick

Se produit lorsqu’un utilisateur clique sur un bouton dans une RibbonDropDown.

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.

S’applique à