RibbonOfficeMenu Interfaz

Referencia

Definición

Espacio de nombres:: Microsoft.Office.Tools.Ribbon

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

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Proporciona acceso a los controles que se agregan al menú de 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

Atributos: GuidAttribute

Implementaciones: RibbonComponent IComponent IDisposable

Ejemplos

En el ejemplo siguiente se recorren en iteración los controles personalizados en el menú de Office de la cinta de opciones y se muestra su nombre. Para ejecutar este ejemplo de código, primero debe realizar los pasos siguientes:

Agregue un elemento de cinta de opciones (Visual Designer) a un proyecto de Office.
Agregue un botón al botón de Microsoft Office.
Establezca la propiedad (Name) del botón en myOfficeMenuButton.
Establezca la propiedad PositionType en AfterOfficeID en la propiedad Position .
Establezca la propiedad OfficeID en FilePrintMenu en la propiedad 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

Comentarios

Al agregar un elemento de cinta de opciones (Visual Designer) al proyecto, Visual Studio asigna automáticamente un nuevo RibbonOfficeMenu objeto a la OfficeMenu propiedad de la interfaz generadaOfficeRibbon. Use este objeto para agregar nuevos controles al menú de Microsoft Office en tiempo de ejecución o para acceder a los controles que agregó al menú de Microsoft Office.

Puede agregar controles en tiempo de ejecución, pero solo antes de cargar la cinta de opciones. Cree una instancia del control y agregue el nuevo control a la Items colección. Para obtener más información, vea Información general sobre el modelo de objetos de la cinta de opciones.

Nota

Esta interfaz está implementada por el Runtime de Microsoft Visual Studio Tools para Office No está prevista su implementación en el código. Para obtener más información, consulta Visual Studio Tools for Office Runtime Overview.

Uso

En esta documentación se describe la versión de este tipo que se usa en los proyectos de Office destinados a .NET Framework 4 o una versión posterior. En los proyectos destinados a .NET Framework 3.5, este tipo podría tener unos miembros diferentes y los ejemplos de código de este tipo podrían no funcionar. Para informarse sobre este tipo en los proyectos destinados a .NET Framework 3.5, consulte la siguiente sección de referencia en la documentación de Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Propiedades

Items	Obtiene los controles de la cinta de opciones que agregó al menú de Microsoft Office.
Name	Obtiene o establece el nombre de este objeto RibbonComponent. (Heredado de RibbonComponent)
Parent	Obtiene un objeto RibbonComponent que representa el elemento primario de este objeto RibbonComponent. (Heredado de RibbonComponent)
Ribbon	Obtiene el objeto Ribbon de nivel superior que contiene la jerarquía de controles. (Heredado de RibbonComponent)
RibbonUI	Obtiene la instancia de IRibbonUI que la aplicación de Microsoft Office proporciona al código de extensibilidad de la cinta. (Heredado de RibbonComponent)
Tag	Obtiene o establece los datos específicos de la aplicación que están asociados a este objeto RibbonComponent. (Heredado de RibbonComponent)

Métodos

PerformDynamicLayout()	Llama al método Microsoft.Office.Core.IRibbonUI.InvalidateControl del control primario si el objeto RibbonComponent tiene un elemento primario dinámico, como un menú dinámico, y no se suspende el diseño. (Heredado de RibbonComponent)
PerformLayout()	Llama al método Microsoft.Office.Core.IRibbonUI.InvalidateControl si RibbonComponent tiene un elemento primario y no se suspende el diseño. (Heredado de RibbonComponent)
ResumeLayout()	Invierte el efecto del método SuspendLayout(). (Heredado de RibbonComponent)
ResumeLayout(Boolean)	Invierte el efecto del método SuspendLayout(). (Heredado de RibbonComponent)
SuspendLayout()	Evita que la aplicación de Microsoft Office actualice el estado de los controles de la cinta de opciones. (Heredado de RibbonComponent)

Se aplica a