Partager via


RibbonLabel Interface

Définition

Représente une étiquette sur un RibbonGroup ou un RibbonBox.

public interface class RibbonLabel : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("7182361b-5a62-424e-9ab4-6d9a78432fb7")]
public interface RibbonLabel : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("7182361b-5a62-424e-9ab4-6d9a78432fb7")>]
type RibbonLabel = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonLabel
Implements IComponent, IDisposable, RibbonControl
Attributs
Implémente

Remarques

Visual Studio crée un RibbonLabel objet pour vous lorsque vous faites glisser une étiquette à partir de l’onglet Contrôles du ruban Office de la boîte à outils vers le ruban Designer.

Pour ajouter une étiquette à un groupe au moment de l’exécution, créez un RibbonLabel objet, puis ajoutez cet objet à la Items collection d’un RibbonGroup ou à la Items collection d’un RibbonBox. Vous ne pouvez le faire qu’avant le chargement du ruban. Pour plus d’informations, consultez Vue d’ensemble du modèle objet du ruban.

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

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)
Label

Obtient ou définit le texte affiché par l’étiquette.

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)
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)
ScreenTip

Cette propriété n’a aucun effet.

ShowLabel

Obtient ou définit une valeur qui indique si le texte affiché par l’étiquette est visible.

SuperTip

Cette propriété n’a aucun effet.

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)

S’applique à