RibbonTab, interface

Article
05/16/2013

Contient un ou plusieurs groupes de contrôles sur le ruban.

Espace de noms : Microsoft.Office.Tools.Ribbon
Assemblys : Microsoft.Office.Tools.Common.v4.0.Utilities (dans Microsoft.Office.Tools.Common.v4.0.Utilities.dll)
Microsoft.Office.Tools.Common (dans Microsoft.Office.Tools.Common.dll)

Syntaxe

'Déclaration
<GuidAttribute("b2c81178-b119-41af-b358-46460ae005d9")> _
Public Interface RibbonTab _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("b2c81178-b119-41af-b358-46460ae005d9")]
public interface RibbonTab : RibbonComponent, 
    IComponent, IDisposable

Le type RibbonTab expose les membres suivants.

Propriétés

	Nom	Description
	ControlId	Obtient ou définit le nom unique à l'aide duquel une application Microsoft Office fait référence à l'onglet.
	Groups	Obtient la collection des groupes qui sont sur le RibbonTab.
	KeyTip	Obtient ou définit le raccourci clavier pour l'onglet.
	Label	Obtient ou définit le texte qui apparaît sur l'onglet.
	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 de l'onglet sur le ruban par rapport aux onglets intégrés.
	Ribbon	Obtient l'objet Ribbon de niveau supérieur qui contient la hiérarchie des contrôles. (Hérité de RibbonComponent.)
	RibbonUI	Infrastructure. Obtient l'instance IRibbonUI fournie par l'application Microsoft Office au code d'extensibilité du ruban. (Hérité de RibbonComponent.)
	Site	Obtient ou définit le ISite associé à IComponent. (Hérité de IComponent.)
	Tag	Obtient ou définit des données spécifiques à l'application associées à ce RibbonComponent. (Hérité de RibbonComponent.)
	Visible	Obtient ou définit une valeur qui indique si l'onglet est visible.

Début

Méthodes

	Nom	Description
	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.)
	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.)
	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.)
	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.)

Début

Événements

	Nom	Description
	Disposed	Représente la méthode qui gère l'événement Disposed d'un composant. (Hérité de IComponent.)

Début

Notes

Il y a une hiérarchie pour ajouter des contrôles de ruban.Seul un contrôle RibbonTab peut être utilisé sur un contrôle Microsoft.Office.Tools.Ribbon.Seul un RibbonGroup peut être utilisé sur un contrôle RibbonTab.

Le Concepteur de ruban prend en charge les onglets personnalisés et intégrés.

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