Partager via


RibbonSplitButton, interface

Contrôle de ruban qui combine un bouton ou un bouton bascule et un menu déroulant.

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

Syntaxe

'Déclaration
<GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")> _
Public Interface RibbonSplitButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable
[GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

Le type RibbonSplitButton expose les membres suivants.

Propriétés

  Nom Description
Propriété publique ButtonEnabled Obtient ou définit une valeur qui indique si le bouton sur le RibbonSplitButton est activé.
Propriété publique ButtonType Obtient ou définit le type du bouton sur le RibbonSplitButton.
Propriété publique Checked Obtient ou définit une valeur qui indique si RibbonSplitButton est enfoncé ou non.
Propriété publique ControlSize Obtient ou définit la taille du contrôle RibbonSplitButton.
Propriété publique Description Obtient ou définit le texte qui apparaît sur ce contrôle RibbonSplitButton dans un menu déroulant.
Propriété publique Enabled Obtient ou définit une valeur qui indique si ce RibbonControl est activé. (Hérité de RibbonControl.)
Propriété publique Id Obtient une chaîne que Microsoft Office utilise pour identifier cet objet RibbonControl. (Hérité de RibbonControl.)
Propriété publique Image Obtient ou définit l'image affichée sur le contrôle.
Propriété publique ImageName Obtient ou définit le nom que vous pouvez utiliser dans le gestionnaire d'événements E:Microsoft.Office.Tools.Ribbon.LoadImage pour identifier une image pour le contrôle.
Propriété publique Items Obtient la collection des contrôles situés sur ce RibbonSplitButton.
Propriété publique ItemSize Obtient ou définit la taille des contrôles dans le menu déroulant RibbonSplitButton.
Propriété publique KeyTip Obtient ou définit le raccourci clavier du contrôle RibbonSplitButton.
Propriété publique Label Obtient ou définit le texte sur le contrôle RibbonSplitButton.
Propriété publique Name Obtient ou définit le nom de ce RibbonComponent. (Hérité de RibbonComponent.)
Propriété publique OfficeImageId Obtient ou définit l'image à afficher sur le contrôle RibbonSplitButton, si vous souhaitez utiliser une icône Microsoft Office intégrée.
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 du contrôle RibbonSplitButton, si le contrôle est dans le menu Microsoft Office.
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 ScreenTip Obtient ou définit le texte info-bulle qui apparaît lorsque l'utilisateur déplace le pointeur sur le contrôle RibbonSplitButton.
Propriété publique ShowLabel Obtient ou définit une valeur qui indique si l'étiquette pour le contrôle RibbonSplitButton est visible.
Propriété publique Site Obtient ou définit le ISite associé à IComponent. (Hérité de IComponent.)
Propriété publique SuperTip Obtient ou définit le texte info-bulle multiligne qui apparaît lorsque l'utilisateur déplace le pointeur sur le contrôle RibbonSplitButton.
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 Title Obtient ou définit le titre qui apparaît sur le contrôle RibbonSplitButton s'il est dans le menu Microsoft Office.
Propriété publique Visible Obtient ou définit une valeur qui indique si ce RibbonControl est visible. (Hérité de RibbonControl.)

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 Click Se produit lorsque l'utilisateur clique sur le contrôle RibbonSplitButton.
É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

Contrôle RibbonSplitButton qui combine un bouton ou un bouton bascule et un menu déroulant.Pour choisir entre le bouton et le bouton bascule, utilisez la propriété ButtonType.

Contrairement au contrôle RibbonMenu, le contrôle RibbonSplitButton n'a pas la propriété Dynamic, par conséquent, le contenu de la collection Items ne peut pas être modifié au moment de l'exécution.

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