RibbonGroup Interface

Définition

Espace de noms:

Microsoft.Office.Tools.Ribbon

Assembly:

Microsoft.Office.Tools.Common.dll

Représente un groupe de contrôles d’un onglet de ruban.

public interface class RibbonGroup : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")>]
type RibbonGroup = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGroup
Implements IComponent, IDisposable, RibbonComponent

Attributs

GuidAttribute

Implémente

RibbonComponent IComponent IDisposable

Remarques

Visual Studio crée un RibbonGroup objet lorsque vous faites glisser un contrôle Groupe de l’onglet Contrôles du ruban Office de la boîte à outils vers le Designer du ruban.

Tâches courantes

Le tableau suivant répertorie les membres qui sont utiles pour les tâches courantes. Toutes ces tâches peuvent être effectuées au moment de la conception. Certaines de ces tâches peuvent être effectuées au moment de l’exécution avant le chargement du ruban. Pour plus d’informations, consultez Vue d’ensemble du modèle objet du ruban.

Tâche	Membre
Accédez aux contrôles du groupe, ajoutez des contrôles au groupe ou supprimez des contrôles du groupe.	Utilisez la propriété Items.
Ajoutez un groupe à un onglet Ruban.	Ajoutez un RibbonGroup à la Groups collection de l’onglet.
Spécifiez l’emplacement d’un groupe sous un onglet intégré, par rapport à l’emplacement d’un groupe intégré.	Utilisez la propriété Position.

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

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

DialogLauncher	Obtient ou définit le lanceur de boîte de dialogue du ruban associé au groupe.
Id	Obtient une chaîne qui identifie le groupe actuel.
Items	Obtient les contrôles contenus dans le groupe.
KeyTip	Obtient ou définit le raccourci clavier du groupe.
Label	Obtient ou définit le texte affiché par l’étiquette du groupe.
Name	Obtient ou définit le nom de ce RibbonComponent. (Hérité de RibbonComponent)
Parent	Obtient un RibbonComponent qui représente le parent de ce RibbonComponent. (Hérité de RibbonComponent)
Position	Obtient ou définit la position d’un groupe sur un onglet prédéfini par rapport à un groupe intégré de l’onglet.
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)
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 le groupe est visible.

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

DialogLauncherClick

Se produit lorsque l’utilisateur clique sur l’icône du lanceur de boîte de dialogue du ruban dans le groupe.