Compartir a través de


RibbonTab (Interfaz)

Contiene uno o varios grupos de controles de la cinta de opciones.

Espacio de nombres:  Microsoft.Office.Tools.Ribbon
Ensamblado:  Microsoft.Office.Tools.Common (en Microsoft.Office.Tools.Common.dll)

Sintaxis

'Declaración
<GuidAttribute("b2c81178-b119-41af-b358-46460ae005d9")> _
Public Interface RibbonTab _
    Inherits RibbonComponent, IComponent, IDisposable
[GuidAttribute("b2c81178-b119-41af-b358-46460ae005d9")]
public interface RibbonTab : RibbonComponent, 
    IComponent, IDisposable

El tipo RibbonTab expone los siguientes miembros.

Propiedades

  Nombre Descripción
Propiedad pública ControlId Obtiene o establece el nombre único con el que una aplicación de Microsoft Office hace referencia a la ficha.
Propiedad pública Groups Obtiene la colección de grupos que hay en RibbonTab.
Propiedad pública KeyTip Obtiene o establece el método abreviado de teclado para la ficha.
Propiedad pública Label Obtiene o establece el texto que aparece en la ficha.
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 Position Obtiene o establece la posición de la ficha en la cinta de opciones con respecto a las fichas integradas.
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 la interfaz ISite asociada a la interfaz 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).
Propiedad pública Visible Obtiene o establece un valor que indica si la ficha está visible.

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

Hay una jerarquía para agregar controles de la cinta de opciones. Sólo se puede usar un control RibbonTab en un control Microsoft.Office.Tools.Ribbon. Sólo se puede usar un objeto RibbonGroup en un control RibbonTab.

El diseñador de la cinta de opciones admite fichas personalizadas e integradas.

Puede crear un RibbonTab en tiempo de ejecución utilizando el método CreateRibbonTab del objeto RibbonFactory.

Existen dos maneras de obtener acceso al objeto RibbonFactory:

  • Mediante la propiedad Factory de la clase Ribbon. Utilice este enfoque para código en la clase Ribbon.

  • Mediante el método Globals.Factory.GetRibbonFactory. Utilice este enfoque para código fuera de la clase Ribbon.

Nota

Esta interfaz está implementada por el motor en tiempo de ejecución de 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

Esta documentación describe la versión de este tipo que se utiliza en los proyectos de Office destinados a .NET Framework 4. En los proyectos destinados a .NET Framework 3.5, este tipo puede tener miembros diferentes y es posible que los ejemplos de código proporcionados para dicho tipo no funcionen. 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.

Vea también

Referencia

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

Otros recursos

Información general sobre la cinta de opciones

Diseñador de la cinta de opciones

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

Cómo: Iniciarse en la personalización de la cinta de opciones