OfficeRibbon Interface

Définition

Espace de noms:

Microsoft.Office.Tools.Ribbon

Assemblys:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Représente une personnalisation de ruban Microsoft Office créée à l'aide du concepteur de ruban dans un projet Office dans Visual Studio.

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

[System.Runtime.InteropServices.Guid("49fbf223-6d24-4c4b-9101-2d5833434328")]
public interface OfficeRibbon : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("49fbf223-6d24-4c4b-9101-2d5833434328")>]
type OfficeRibbon = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface OfficeRibbon
Implements IComponent, IDisposable, RibbonComponent

Attributs

GuidAttribute

Implémente

RibbonComponent IComponent IDisposable

Remarques

Vous n’utilisez généralement pas l’interface OfficeRibbon directement. Au lieu de cela, utilisez la classe Ribbon générée par Visual Studio lorsque vous ajoutez un nouvel élément Ribbon (Visual Designer) à votre projet. Vous pouvez accomplir la plupart des tâches liées au ruban à l’aide d’événements et de propriétés dans la classe Ribbon générée.

La classe Ribbon générée hérite de la RibbonBase classe . Cette classe de base redirige tous les appels à ses membres vers une implémentation interne de l’interface OfficeRibbon Visual Studio Tools pour Office runtime. Si vous souhaitez utiliser l’objet OfficeRibbon directement, utilisez la Base propriété de la classe Ribbon générée.

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

Context	Obtient la fenêtre Inspecteur ou Explorateur dans Outlook, qui est associée à ce ruban.
DefaultExtension	Obtient l’extension par défaut de cet objet OfficeRibbon.
Extension	Obtient une extension personnalisée pour cet objet OfficeRibbon.
Global	Obtient ou définit une valeur qui détermine si ce OfficeRibbon peut être utilisé simultanément dans plusieurs contextes.
Name	Obtient ou définit le nom de ce RibbonComponent. (Hérité de RibbonComponent)
OfficeMenu	Obtient un RibbonOfficeMenu qui représente la personnalisation du menu Microsoft Office.
Parent	Obtient un RibbonComponent qui représente le parent de ce RibbonComponent. (Hérité de RibbonComponent)
Ribbon	Obtient l’objet Ribbon de niveau supérieur qui contient la hiérarchie des contrôles. (Hérité de RibbonComponent)
RibbonId	Obtient l'ID de ruban utilisé pour créer cette instance de l'objet OfficeRibbon.
RibbonType	Obtient une liste séparée par des virgules des ID de ruban associés à cette instance OfficeRibbon.
RibbonUI	Obtient l’instance IRibbonUI fournie par l’application Microsoft Office au code d’extensibilité du ruban. (Hérité de RibbonComponent)
StartFromScratch	Obtient ou définit une valeur qui indique s'il convient de masquer tous les onglets intégrés sur le ruban et la plupart des commandes dans le menu Microsoft Office, et d'afficher uniquement les personnalisations définies dans cet élément de ruban.
Tabs	Obtient une collection des objets RibbonTab dans le RibbonOfficeMenu.
Tag	Obtient ou définit des données propres à l’application associées à ce RibbonComponent. (Hérité de RibbonComponent)

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

Close	Se produit lorsque cette instance OfficeRibbon se ferme.
Load	Se produit lorsque le OfficeRibbon est chargé dans l'application Microsoft Office.
LoadImage	Se produit quand le OfficeRibbon charge, si la propriété ImageName est définie pour un ou plusieurs contrôles.