RibbonGallery Interface

Définition

Espace de noms:

Microsoft.Office.Tools.Ribbon

Assembly:

Microsoft.Office.Tools.Common.dll

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

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

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

Attributs

GuidAttribute

Implémente

RibbonComponent RibbonControl IComponent IDisposable

Remarques

Comme l’interfaceRibbonDropDown, RibbonGallery affiche un menu d’objets et RibbonButton de RibbonDropDownItem contrôles.

Contrairement à l’interface RibbonDropDown , l’interface RibbonGallery déclenche Click des événements, plutôt que SelectionChanged des événements, lorsqu’un utilisateur clique sur un RibbonDropDownItem. Cela signifie, par exemple, 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 serait déclenché au plus une fois lorsque la sélection initiale a été effectuée pour le même scénario sur un RibbonDropDown, en fonction de ce qu’était la sélection avant le premier clic.)

La ShowItemSelection propriété contrôle si le actuellement sélectionné RibbonDropDownItem est visuellement différencié des éléments non sélectionnés. Un seul élément à la fois peut être sélectionné dans un RibbonGallery.

La ItemImageSize propriété peut être utilisée pour spécifier des tailles d’image autres que 16 x 16 et 32 x 32.

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

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

Certaines propriétés de ce contrôle peuvent être définies uniquement avant le chargement du ruban dans l’application Office ou avant l’ajout du 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 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 la collection de boutons de cette RibbonGallery.
ColumnCount	Obtient ou définit le nombre de colonnes Item contenues dans cette RibbonGallery.
ControlSize	Obtient ou définit la taille du contrôle RibbonGallery .
Description	Obtient ou définit le texte qui apparaît sur ce contrôle RibbonGallery dans un menu ou un bouton partagé.
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 l'image affichée sur le bouton.
ImageName	Obtient ou définit le nom que vous pouvez utiliser pour identifier la RibbonGallery dans le gestionnaire d’événements LoadImage.
ItemImageSize	Obtient ou définit une Size qui donne les dimensions des images affichées par les éléments de cette RibbonGallery.
Items	Obtient une collection des composants RibbonDropDownItem dans cette RibbonGallery.
KeyTip	Obtient ou définit le raccourci clavier de cette RibbonGallery.
Label	Obtient ou définit le texte qui apparaît dans cette RibbonGallery.
Name	Obtient ou définit le nom de ce RibbonComponent. (Hérité de RibbonComponent)
OfficeImageId	Obtient ou définit l’image à afficher sur le contrôle, 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)
Position	Obtient ou définit l'emplacement de la galerie, si la galerie est dans le menu Microsoft Office.
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)
RowCount	Obtient ou définit le nombre de lignes des composants RibbonDropDownItem que ce RibbonGallery affiche.
ScreenTip	Obtient ou définit le texte info-bulle qui apparaît lorsque l’utilisateur déplace le pointeur sur cette RibbonGallery.
SelectedItem	Obtient ou définit l'élément 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 RibbonGallery est visible.
ShowItemImage	Obtient ou définit une valeur qui indique si les images sont affichées pour les éléments de la galerie.
ShowItemLabel	Obtient ou définit une valeur qui indique si les étiquettes sont affichées pour les éléments sur ce RibbonGallery.
ShowItemSelection	Obtient ou définit une valeur qui indique si le RibbonDropDownItem actuellement sélectionné se distingue visuellement des autres éléments non sélectionnés.
ShowLabel	Obtient ou définit une valeur qui indique si l’étiquette de cette RibbonGallery est visible.
SuperTip	Obtient ou définit le texte info-bulle multiligne qui apparaît lorsque l’utilisateur déplace le pointeur sur la RibbonGallery.
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 sur ce RibbonGallery.
Click	Se produit lorsqu’un utilisateur clique sur un élément de cette RibbonGallery.
ItemsLoading	Se produit lorsque cette RibbonGallery est ouverte.