RibbonSplitButton Interface
Définition
Important
Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.
Contrôle de ruban qui combine un bouton ou un bouton bascule et un menu déroulant.
public interface class RibbonSplitButton : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")>]
type RibbonSplitButton = interface
interface RibbonControl
interface RibbonComponent
interface IComponent
interface IDisposable
Public Interface RibbonSplitButton
Implements IComponent, IDisposable, RibbonControl
- Attributs
- Implémente
Remarques
RibbonSplitButton Contrôle de ruban qui combine un bouton ou un bouton bascule et un menu déroulant. Pour choisir entre le bouton et le bouton bascule, utilisez la ButtonType propriété .
Contrairement au RibbonMenu contrôle, le RibbonSplitButton contrôle n’ayant pas la Dynamic propriété , le contenu de la collection ne peut pas être modifié au moment de l’exécution Items .
Vous pouvez créer un RibbonSplitButton au moment de l’exécution à l’aide de la CreateRibbonSplitButton 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
ButtonEnabled |
Obtient ou définit une valeur qui indique si le bouton du RibbonSplitButton est activé. |
ButtonType |
Obtient ou définit le type du bouton sur le RibbonSplitButton. |
Checked |
Obtient ou définit une valeur qui indique si RibbonSplitButton est enfoncé ou non. |
ControlSize |
Obtient ou définit la taille du contrôle RibbonSplitButton . |
Description |
Obtient ou définit le texte qui apparaît sur ce contrôle RibbonSplitButton dans un menu déroulant. |
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) |
Image |
Obtient ou définit l’image affichée sur le contrôle. |
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. |
Items |
Obtient la collection des contrôles qui se trouvent sur ce RibbonSplitButton. |
ItemSize |
Obtient ou définit la taille des contrôles du menu déroulant RibbonSplitButton. |
KeyTip |
Obtient ou définit le raccourci clavier du contrôle RibbonSplitButton. |
Label |
Obtient ou définit le texte du contrôle RibbonSplitButton. |
Name |
Obtient ou définit le nom de ce RibbonComponent. (Hérité de RibbonComponent) |
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. |
Parent |
Obtient un RibbonComponent qui représente le parent de ce RibbonComponent. (Hérité de RibbonComponent) |
Position |
Obtient ou définit la position du contrôle RibbonSplitButton, s’il figure dans le menu Microsoft Office. |
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 |
Obtient ou définit le texte info-bulle qui apparaît lorsque l'utilisateur déplace le pointeur sur le contrôle RibbonSplitButton. |
ShowLabel |
Obtient ou définit une valeur qui indique si l’étiquette du contrôle RibbonSplitButton est visible. |
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. |
Tag |
Obtient ou définit des données propres à l’application associées à ce RibbonComponent. (Hérité de RibbonComponent) |
Title |
Obtient ou définit le titre qui s’affiche en haut du contrôle RibbonSplitButton, si le contrôle est dans le menu Microsoft Office. |
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) |
Événements
Click |
Se produit quand l'utilisateur clique sur le contrôle RibbonSplitButton. |