RibbonOfficeMenu, classe (System 2007)

Mise à jour : novembre 2007

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

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

Syntaxe

Public NotInheritable Class RibbonOfficeMenu _
    Inherits RibbonComponent

Dim instance As RibbonOfficeMenu

public sealed class RibbonOfficeMenu : RibbonComponent

Notes

Lorsque vous ajoutez un élément Ruban (Concepteur visuel) à votre projet, Visual Studio Tools pour Office assigne automatiquement un nouvel objet RibbonOfficeMenu à la propriété OfficeMenu de la classe 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.

Exemples

L'exemple suivant parcourt 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 :

Ajoutez un élément Ruban (Concepteur visuel) à un projet Visual Studio Tools pour Office.
Ajoutez un bouton au bouton Microsoft Office.
Attribuez à la propriété (Name) du bouton la valeur myOfficeMenuButton.
Attribuez à la propriété PositionType la valeur AfterOfficeID sous la propriété Position.
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);
    }
}

Hiérarchie d'héritage

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonOfficeMenu

Sécurité des threads

Tous les membres static (Shared en Visual Basic) publics de ce type sont thread-safe. Il n'est pas garanti que les membres d'instance soient thread-safe.

Voir aussi

Référence

Membres RibbonOfficeMenu

Microsoft.Office.Tools.Ribbon, espace de noms

Autres ressources

Comment : personnaliser le menu Microsoft Office

Vue d'ensemble du modèle objet de ruban

Last updated on 2008-08-23