Compartir a través de

RibbonBase (Clase)

  • Artículo

Actúa como clase base para las personalizaciones de la cinta de opciones de Microsoft Office.

Jerarquía de herencia

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonBase

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

Sintaxis

'Declaración
Public MustInherit Class RibbonBase _
    Inherits Component _
    Implements IRibbonExtension, IExtension, IDisposable

public abstract class RibbonBase : Component, 
    IRibbonExtension, IExtension, IDisposable

El tipo RibbonBase expone los siguientes miembros.

Constructores

  Nombre Descripción
Método público RibbonBase Infraestructura. Inicializa una nueva instancia de la clase RibbonBase.

Arriba

Propiedades

  Nombre Descripción
Propiedad pública Base Obtiene el objeto RibbonBase que este objeto RibbonBase extiende.
Propiedad protegida CanRaiseEvents Obtiene un valor que indica si el componente puede generar un evento. (Se hereda de Component).
Propiedad pública Container Obtiene IContainer que contiene Component. (Se hereda de Component).
Propiedad pública Context Obtiene la ventana del inspector o explorador de Outlook, que está asociada a esta cinta.
Propiedad protegida DesignMode Obtiene un valor que indica si Component está actualmente en modo de diseño. (Se hereda de Component).
Propiedad protegida Events Obtiene la lista de controladores de eventos asociados a Component. (Se hereda de Component).
Propiedad pública Factory Obtiene o establece el generador de cintas asociado a este RibbonBase.
Propiedad pública Global Obtiene o establece un valor que determina si este objeto RibbonBase se puede usar simultáneamente en varios contextos.
Propiedad pública Name Obtiene o establece el nombre de este objeto RibbonBase.
Propiedad pública OfficeMenu Obtiene un objeto RibbonOfficeMenu que representa la personalización del menú de Microsoft Office.
Propiedad pública Parent Obtiene un objeto RibbonComponent que representa el elemento primario del RibbonComponent de este objeto RibbonBase.
Propiedad pública RibbonId Obtiene el id. de cinta que se usó para crear esta instancia de la clase RibbonBase.
Propiedad pública RibbonType Obtiene una lista de identificadores de cinta separados por comas que están asociados a esta instancia de RibbonBase.
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.
Propiedad pública Site Obtiene o establece ISite de Component. (Se hereda de Component).
Propiedad pública StartFromScratch Obtiene o establece un valor que indica si se van a ocultar todas las fichas integradas de la cinta de opciones y la mayoría de los comandos del menú de Microsoft Office y si se van a mostrar únicamente las personalizaciones definidas en este elemento de cinta.
Propiedad pública Tabs Obtiene una colección de los objetos RibbonTab de RibbonOfficeMenu.
Propiedad pública Tag Obtiene o establece los datos específicos de la aplicación que están asociados a este objeto RibbonBase.

Arriba

Métodos

  Nombre Descripción
Método público CreateObjRef Crea un objeto que contiene toda la información relevante necesaria para generar un proxy utilizado para comunicarse con un objeto remoto. (Se hereda de MarshalByRefObject).
Método público Dispose() Libera todos los recursos utilizados por el objeto Component. (Se hereda de Component).
Método protegido Dispose(Boolean) Libera los recursos no administrados utilizados por la clase RibbonBase y, de forma opcional, libera los recursos administrados. (Invalida a Component.Dispose(Boolean)).
Método público Equals Determina si el objeto Object especificado es igual al objeto Object actual. (Se hereda de Object).
Método protegido Finalize Libera recursos no administrados y realiza otras operaciones de limpieza antes de que se reclame el objeto Component durante la recolección de elementos no utilizados. (Se hereda de Component).
Método público GetHashCode Actúa como función hash para un tipo concreto. (Se hereda de Object).
Método público GetLifetimeService Recupera el objeto de servicio de duración actual que controla la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegido GetService Devuelve un objeto que representa el servicio suministrado por Component o por Container. (Se hereda de Component).
Método público GetType Obtiene el objeto Type de la instancia actual. (Se hereda de Object).
Método público InitializeLifetimeService Obtiene un objeto de servicio de duración para controlar la directiva de duración de esta instancia. (Se hereda de MarshalByRefObject).
Método protegido MemberwiseClone() Crea una copia superficial del objeto Object actual. (Se hereda de Object).
Método protegido MemberwiseClone(Boolean) Crea una copia superficial del objeto MarshalByRefObject actual. (Se hereda de MarshalByRefObject).
Método público PerformDynamicLayout Llama al método Microsoft.Office.Core.IRibbonUI.InvalidateControl del control primario si el RibbonComponent de RibbonBase tiene un elemento primario dinámico, como un menú dinámico, y no se suspende el diseño.
Método público PerformLayout Actualiza la interfaz de usuario de la cinta de opciones.
Método público ResumeLayout() Invierte el efecto del método SuspendLayout.
Método público ResumeLayout(Boolean) Invierte el efecto del método SuspendLayout.
Método público SuspendLayout Evita que la aplicación de Microsoft Office actualice el estado de los controles de la cinta de opciones.
Método público ToString Devuelve un objeto String que contiene el nombre del objeto Component, en caso de que exista.Este método no debe reemplazarse. (Se hereda de Component).

Arriba

Eventos

  Nombre Descripción
Evento público Close Se produce cuando se cierra esta instancia de RibbonBase.
Evento público Disposed Se produce cuando el componente se elimina mediante una llamada al método Dispose. (Se hereda de Component).
Evento público Load Se produce cuando se carga RibbonBase en la aplicación de Microsoft Office.
Evento público LoadImage Se produce cuando se carga RibbonBase si la propiedad ImageName está establecida para uno o varios controles.

Arriba

Implementaciones explícitas de interfaces

  Nombre Descripción
Implementación explícita de interfacesPropiedad privada IExtension.ExtensionBase Infraestructura.

Arriba

Comentarios

Cuando se agrega un nuevo elemento Cinta (diseñador visual) a un proyecto, Visual Studio agrega al proyecto una clase Ribbon que hereda de RibbonBase. RibbonBase contiene los métodos y propiedades que son comunes a todas las clases Ribbon. Para obtener más información, vea Diseñador de la cinta de opciones.

Algunas propiedades de RibbonBase solo se pueden establecer antes de que se cargue la cinta de opciones en la aplicación de Office. Para obtener información sobre cómo establecer estas propiedades, vea Información general sobre el modelo de objetos para la cinta de opciones.

Uso

Este tipo se usa solamente en los proyectos de Office destinados a .NET Framework 4. El ensamblado que define este tipo no forma parte del motor en tiempo de ejecución de Visual Studio Tools para Office. Este ensamblado se debe implementar con la solución. Para obtener más información, vea Ensamblados en el Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office.

Seguridad para subprocesos

Todos los miembros static (Shared en Visual Basic) públicos de este tipo son seguros para la ejecución de subprocesos. No se garantiza que los miembros de instancias sean seguros para la ejecución de subprocesos.

Vea también

Referencia

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