RibbonGallery, classe (System 2007)

Article
08/23/2008

Mise à jour : novembre 2007

Représente un contrôle qui affiche un menu d'objets RibbonDropDownItem et de contrôles RibbonButton.

Espace de noms : Microsoft.Office.Tools.Ribbon
Assembly : Microsoft.Office.Tools.Common.v9.0 (dans Microsoft.Office.Tools.Common.v9.0.dll)

Syntaxe

<ToolboxBitmapAttribute(GetType(RibbonGallery), "RibbonGallery.bmp")> _
Public NotInheritable Class RibbonGallery _
    Inherits RibbonControl

Dim instance As RibbonGallery

[ToolboxBitmapAttribute(typeof(RibbonGallery), "RibbonGallery.bmp")]
public sealed class RibbonGallery : RibbonControl

Notes

Comme la classe RibbonDropDown, RibbonGallery affiche un menu d'objets RibbonDropDownItem et de contrôles RibbonButton.

Contrairement à la classe RibbonDropDown, la classe RibbonGallery déclenche des événements Click plutôt que des événements SelectionChanged lorsqu'un utilisateur clique sur un RibbonDropDownItem. Par exemple, cela signifie que l'événement Click est déclenché deux fois lorsqu'un utilisateur clique deux fois sur le même RibbonDropDownItem. L'événement SelectionChanged est déclenché au maximum une fois lorsque la sélection initiale a été faite pour le même scénario sur un RibbonDropDown en fonction de la sélection avant le premier clic.

La propriété ShowItemSelection contrôle si le RibbonDropDownItem actuellement sélectionné se distingue visuellement des éléments non sélectionnés. Il est possible de sélectionner un seul élément à la fois dans un RibbonGallery.

La propriété ItemImageSize peut être utilisée pour spécifier les tailles d'image autres que 16x16 et 32x32.

Vous pouvez ajouter des objets RibbonDropDownItem à un RibbonGallery au moment du design ou de l'exécution.

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.

Les étapes suivantes expliquent comment ajouter un RibbonDropDownItem au moment de l'exécution.

Pour ajouter un objet RibbonDropDownItem au moment de l'exécution

Créez un RibbonDropDownItem en utilisant le RibbonDropDownItem.
Ajoutez le RibbonDropDownItem que vous avez créé dans la collection Items de cet objet RibbonGallery.

Vous pouvez ajouter des contrôles RibbonButton à un RibbonGallery 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.

Certaines propriétés de ce contrôle peuvent être définies uniquement avant de charger le ruban dans l'application Office ou avant d'ajouter le contrôle à un menu dynamique au moment de l'exécution. Pour plus d'informations sur la définition de ces propriétés, consultez Vue d'ensemble du modèle objet de ruban.

Hiérarchie d'héritage

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonGallery

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.