RibbonOfficeMenu Interface

Référence

Définition

Espace de noms:: Microsoft.Office.Tools.Ribbon

Assemblys:: Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

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.

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

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 :

Ajoutez un élément ruban (Visual Designer) à un projet Office.
Ajoutez un bouton au bouton Microsoft Office.
Définissez la propriété (Name) du bouton sur myOfficeMenuButton.
Définissez la propriété PositionType sur AfterOfficeID sous la propriété Position .
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.

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

Items	Obtient les contrôles de ruban que vous avez ajoutés au menu Microsoft Office.
Name	Obtient ou définit le nom de ce RibbonComponent. (Hérité de RibbonComponent)
Parent	Obtient un RibbonComponent qui représente le parent de ce RibbonComponent. (Hérité de RibbonComponent)
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)
Tag	Obtient ou définit des données propres à l’application associées à ce RibbonComponent. (Hérité de RibbonComponent)

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)

S’applique à

Partager via