Partager via


RibbonOfficeMenu, interface

Fournit l'accès aux contrôles que vous ajoutez au menu Microsoft Office.

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

Syntaxe

'Déclaration
<GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")> _
Public Interface RibbonOfficeMenu _
    Inherits RibbonComponent, IComponent, IDisposable
[GuidAttribute("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : RibbonComponent, 
    IComponent, IDisposable

Le type RibbonOfficeMenu expose les membres suivants.

Propriétés

  Nom Description
Propriété publique Items Obtient les contrôles du ruban que vous avez ajoutés au menu Microsoft Office.
Propriété publique Name Obtient ou définit le nom de ce RibbonComponent. (Hérité de RibbonComponent.)
Propriété publique Parent Obtient un RibbonComponent qui représente le parent de ce RibbonComponent. (Hérité de RibbonComponent.)
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 Site Obtient ou définit le ISite associé à IComponent. (Hérité de IComponent.)
Propriété publique Tag Obtient ou définit des données spécifiques à l'application associées à ce RibbonComponent. (Hérité de RibbonComponent.)

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 Disposed Représente la méthode qui gère l'événement Disposed d'un composant. (Hérité de IComponent.)

Début

Notes

Lorsque vous ajoutez un élément Ruban (Concepteur visuel) à votre projet, Visual Studio assigne automatiquement un nouvel objet RibbonOfficeMenu à la propriété OfficeMenu de l'interface OfficeRibbon générée. Utilisez cet objet pour ajouter de nouveaux contrôles au menu Microsoft Office au moment de l'exécution ou pour accéder aux contrôles que vous avez ajoutés au menu Microsoft Office.

Vous pouvez ajouter des contrôles au moment de l'exécution, mais uniquement avant le chargement du ruban. Créez une instance du contrôle et ajoutez ensuite le nouveau contrôle à la collection Items. Pour plus d'informations, consultez Vue d'ensemble du modèle objet de ruban.

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 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.

Exemples

L'exemple suivant itère les contrôles personnalisés dans le menu Office du ruban et affiche leur nom. Pour exécuter cet exemple de code, vous devez exécuter tout d'abord les étapes suivantes :

  1. Ajoutez un élément Ruban (Concepteur visuel) à un projet Office.

  2. Ajoutez un bouton au bouton Microsoft Office.

  3. Attribuez à la propriété (Name) du bouton la valeur myOfficeMenuButton.

  4. Attribuez à la propriété PositionType la valeur AfterOfficeID sous la propriété Position.

  5. Affectez à la propriété OfficeID la valeur FilePrintMenu sous la propriété Position.

Private Sub ListOfficeRibbonCustomControls()
    System.Windows.Forms.MessageBox.Show( _
            "Listing all Office Menu custom controls...")
    For Each control As RibbonComponent In Globals.Ribbons.Ribbon1.OfficeMenu.Items
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name)
    Next
End Sub
private void ListOfficeRibbonCustomControls()
{
    System.Windows.Forms.MessageBox.Show(
        "Listing all Office Menu custom controls...");
    foreach (RibbonComponent control in Globals.Ribbons.Ribbon1.OfficeMenu.Items)
    {
        System.Windows.Forms.MessageBox.Show("Control name: " + control.Name);
    }
}

Voir aussi

Référence

Microsoft.Office.Tools.Ribbon, espace de noms

Autres ressources

Comment : ajouter des contrôles au mode Backstage

Vue d'ensemble du modèle objet de ruban