Partager via


RibbonGroup, interface

Représente un groupe de contrôles sur un onglet du ruban.

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

Syntaxe

'Déclaration
<GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")> _
Public Interface RibbonGroup _
    Inherits RibbonComponent, IComponent, IDisposable
[GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : RibbonComponent, 
    IComponent, IDisposable

Le type RibbonGroup expose les membres suivants.

Propriétés

  Nom Description
Propriété publique DialogLauncher Obtient ou définit le lanceur de boîte de dialogue du ruban associé au groupe.
Propriété publique Id Obtient une chaîne qui identifie le groupe actuel.
Propriété publique Items Obtient les contrôles dans le groupe.
Propriété publique KeyTip Obtient ou définit le raccourci clavier du groupe.
Propriété publique Label Obtient ou définit le texte affiché par l'étiquette du groupe.
Propriété publique Name Obtient ou définit le nom de ce RibbonComponent. (Hérité de RibbonComponent.)
Propriété publique Parent Obtient un RibbonComponent qui représente le parent de ce RibbonComponent. (Hérité de RibbonComponent.)
Propriété publique Position Obtient ou définit la position d'un groupe sur un onglet intégré par rapport à un groupe intégré sur l'onglet.
Propriété publique Ribbon Obtient l'objet Ribbon de niveau supérieur qui contient la hiérarchie des contrôles. (Hérité de RibbonComponent.)
Propriété publique RibbonUI Infrastructure. Obtient l'instance IRibbonUI fournie par l'application Microsoft Office au code d'extensibilité du ruban. (Hérité de RibbonComponent.)
Propriété publique Site Obtient ou définit le ISite associé à IComponent. (Hérité de IComponent.)
Propriété publique Tag Obtient ou définit des données spécifiques à l'application associées à ce RibbonComponent. (Hérité de RibbonComponent.)
Propriété publique Visible Obtient ou définit une valeur qui indique si le groupe est visible.

Début

Méthodes

  Nom Description
Méthode publique 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.)
Méthode publique 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.)
Méthode publique 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.)
Méthode publique ResumeLayout() Inverse l'effet de la méthode SuspendLayout. (Hérité de RibbonComponent.)
Méthode publique ResumeLayout(Boolean) Inverse l'effet de la méthode SuspendLayout. (Hérité de RibbonComponent.)
Méthode publique 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
Événement public DialogLauncherClick Se produit lorsque l'utilisateur clique sur l'icône du lanceur de boîte de dialogue du ruban dans le groupe.
Événement public Disposed Représente la méthode qui gère l'événement Disposed d'un composant. (Hérité de IComponent.)

Début

Notes

Visual Studio crée un objet RibbonGroup lorsque vous faites glisser un contrôle Group de l'onglet Contrôles de ruban Office de la Boîte à outils sur le Concepteur de 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 du design.Certaines de ces tâches peuvent être exécutées au moment de l'exécution avant le chargement du ruban.Pour plus d'informations, consultez Vue d'ensemble du modèle objet de ruban.

Tâche

Membre

Accéder aux contrôles dans le groupe, ajouter des contrôles au groupe ou supprimer des contrôles du groupe.

Utilisez la propriété Items.

Ajouter un groupe à un onglet du ruban.

Ajoutez un RibbonGroup à la collection Groups de l'onglet.

Spécifier l'emplacement d'un groupe sur un onglet intégré par rapport à l'emplacement d'un groupe intégré.

Utilisez la propriété Position.

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

[!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

Autres ressources

Vue d'ensemble du ruban

Concepteur de ruban

Vue d'ensemble du modèle objet de ruban

Comment : démarrer avec la personnalisation du ruban

Comment : personnaliser un onglet intégré