RibbonOfficeMenu Interface

Définition

public interface class RibbonOfficeMenu : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")]
public interface RibbonOfficeMenu : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("49cea6a9-3670-4ae0-9a36-9305e27f302b")>]
type RibbonOfficeMenu = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonOfficeMenu
Implements IComponent, IDisposable, RibbonComponent

Attributs

GuidAttribute

Implémente

RibbonComponent IComponent IDisposable

Exemples

L’exemple suivant effectue une itération au sein des contrôles personnalisés dans le menu Office du ruban et affiche leur nom. Pour exécuter cet exemple de code, vous devez d’abord effectuer les étapes suivantes :

1. Ajoutez un élément ruban (Visual Designer) à un projet Office.

2. Ajoutez un bouton au bouton Microsoft Office.

3. Définissez la propriété (Name) du bouton sur myOfficeMenuButton.

4. Définissez la propriété PositionType sur AfterOfficeID sous la propriété Position .

5. Définissez la propriété OfficeID sur FilePrintMenu sous la propriété Position .

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);
    }
}

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

Remarques

Lorsque vous ajoutez un élément ribbon (Visual Designer) à votre projet, Visual Studio affecte automatiquement un nouvel RibbonOfficeMenu objet à la OfficeMenu propriété de l’interface généréeOfficeRibbon. 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 un instance du contrôle, puis ajoutez le nouveau contrôle à la Items collection. Pour plus d’informations, consultez Vue d’ensemble du modèle objet du ruban.

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

Méthodes

S’applique à