Compartir a través de

RibbonOfficeMenu (Interfaz)

  • Artículo

Proporciona acceso a los controles que se agregan al menú de Microsoft Office.

Espacio de nombres:  Microsoft.Office.Tools.Ribbon
Ensamblados:   Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)
  Microsoft.Office.Tools.Common.v4.0.Utilities (en Microsoft.Office.Tools.Common.v4.0.Utilities.dll)

Sintaxis

'Declaración
<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

El tipo RibbonOfficeMenu expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública Items Obtiene los controles Ribbon que agregó al menú de Microsoft Office.
Propiedad pública Name Obtiene o establece el nombre de este objeto RibbonComponent. (Se hereda de RibbonComponent).
Propiedad pública Parent Obtiene un objeto RibbonComponent que representa el elemento primario de este objeto RibbonComponent. (Se hereda de RibbonComponent).
Propiedad pública Ribbon Obtiene el objeto Ribbon de nivel superior que contiene la jerarquía de controles. (Se hereda de RibbonComponent).
Propiedad pública RibbonUI Infraestructura. Obtiene la instancia de IRibbonUI que la aplicación de Microsoft Office proporciona al código de extensibilidad de la cinta. (Se hereda de RibbonComponent).
Propiedad pública Site Obtiene o establece el ISite asociado a IComponent. (Se hereda de IComponent).
Propiedad pública Tag Obtiene o establece los datos específicos de la aplicación que están asociados a este objeto RibbonComponent. (Se hereda de RibbonComponent).

Arriba

Métodos

  Nombre Descripción
Método público Dispose Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Se hereda de IDisposable).
Método público PerformDynamicLayout Llama al método Microsoft.Office.Core.IRibbonUI.InvalidateControl del control principal si RibbonComponent tiene un elemento primario dinámico, como un menú dinámico, y no se suspende el diseño. (Se hereda de RibbonComponent).
Método público PerformLayout Llama a Microsoft.Office.Core.IRibbonUI.InvalidateControl si el objeto RibbonComponent tiene un elemento primario y no se ha suspendido el diseño. (Se hereda de RibbonComponent).
Método público ResumeLayout() Invierte el efecto del método SuspendLayout. (Se hereda de RibbonComponent).
Método público ResumeLayout(Boolean) Invierte el efecto del método SuspendLayout. (Se hereda de RibbonComponent).
Método público SuspendLayout Evita que la aplicación de Microsoft Office actualice el estado de los controles de la cinta de opciones. (Se hereda de RibbonComponent).

Arriba

Eventos

  Nombre Descripción
Evento público Disposed Representa el método que controla el evento Disposed de un componente. (Se hereda de IComponent).

Arriba

Comentarios

Al agregar un elemento Cinta (diseñador visual) a un proyecto, Visual Studio asigna automáticamente un nuevo objeto RibbonOfficeMenu a la propiedad OfficeMenu de la interfaz OfficeRibbon generada.Use este objeto para agregar nuevos controles al menú de Microsoft Office en tiempo de ejecución o para tener acceso a los controles agregados al menú de Microsoft Office.

Puede agregar los controles en tiempo de ejecución, pero sólo antes de que se cargue la cinta de opciones.Cree una instancia del control y, a continuación, agregue el nuevo control a la colección Items.Para obtener más información, vea Información general sobre el modelo de objetos para 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, vea Información general sobre el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.

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 y .NET Framework 4.5. 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, vea la siguiente sección de referencia en la documentación de Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.

Ejemplos

En el ejemplo siguiente se recorren en iteración los controles personalizados del menú de la cinta de opciones de Office y se muestran los nombres.Para poder ejecutar este ejemplo de código, primero debe seguir este procedimiento:

  1. Agregue un elemento Cinta (diseñador visual) a un proyecto de Office.

  2. Agregue un botón al Botón de Microsoft Office.

  3. Establezca la propiedad (Name) del botón en myOfficeMenuButton.

  4. Establezca la propiedad PositionType en AfterOfficeID bajo la propiedad Position.

  5. Establezca la propiedad OfficeID en FilePrintMenu bajo la propiedad 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);
    }
}

Vea también

Referencia

Microsoft.Office.Tools.Ribbon (Espacio de nombres)

Otros recursos

Cómo: Agregar controles en la vista Backstage

Información general sobre el modelo de objetos para la cinta de opciones