OfficeRibbon (Interfaz)

Representa una personalización de la cinta de opciones de Microsoft Office que se crea mediante el diseñador de dicha cinta en un proyecto de Office en Visual Studio.

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

Sintaxis

'Declaración
<GuidAttribute("49fbf223-6d24-4c4b-9101-2d5833434328")> _
Public Interface OfficeRibbon _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("49fbf223-6d24-4c4b-9101-2d5833434328")]
public interface OfficeRibbon : RibbonComponent, 
    IComponent, IDisposable

El tipo OfficeRibbon expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	Context	Obtiene la ventana del inspector o explorador de Outlook, que está asociada a esta cinta.
	DefaultExtension	Obtiene la extensión predeterminada de este objeto OfficeRibbon.
	Extension	Obtiene una extensión personalizada de este objeto OfficeRibbon.
	Global	Obtiene o establece un valor que determina si este objeto OfficeRibbon puede usarse simultáneamente en varios contextos.
	Name	Obtiene o establece el nombre de este objeto RibbonComponent. (Se hereda de RibbonComponent).
	OfficeMenu	Obtiene un objeto RibbonOfficeMenu que representa la personalización del menú de Microsoft Office.
	Parent	Obtiene un objeto RibbonComponent que representa el elemento primario de este objeto RibbonComponent. (Se hereda de RibbonComponent).
	Ribbon	Obtiene el objeto Ribbon de nivel superior que contiene la jerarquía de controles. (Se hereda de RibbonComponent).
	RibbonId	Obtiene el identificador de cinta que se usó para crear esta instancia del objeto OfficeRibbon.
	RibbonType	Obtiene una lista de identificadores de cinta separados por comas que están asociados a esta instancia de OfficeRibbon.
	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).
	Site	Obtiene o establece la interfaz ISite asociada a la interfaz IComponent. (Se hereda de IComponent).
	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.
	Tabs	Obtiene una colección de los objetos RibbonTab de RibbonOfficeMenu.
	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
	Dispose	Realiza tareas definidas por la aplicación asociadas a la liberación o al restablecimiento de recursos no administrados. (Se hereda de IDisposable).
	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).
	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).
	ResumeLayout()	Invierte el efecto del método SuspendLayout. (Se hereda de RibbonComponent).
	ResumeLayout(Boolean)	Invierte el efecto del método SuspendLayout. (Se hereda de RibbonComponent).
	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
	Close	Se produce cuando se cierra esta instancia de OfficeRibbon.
	Disposed	Representa el método que controla el evento Disposed de un componente. (Se hereda de IComponent).
	Load	Se produce cuando se carga OfficeRibbon en la aplicación de Microsoft Office.
	LoadImage	Se produce cuando se carga OfficeRibbon si la propiedad ImageName está establecida para uno o varios controles.

Arriba

Comentarios

Normalmente, no se utiliza la interfaz OfficeRibbon directamente. En su lugar, use la clase Ribbon que Visual Studio genera al agregar un nuevo elemento Cinta (diseñador visual) a un proyecto. Puede lograr la mayoría de las tareas relacionadas con la Cinta mediante los eventos y propiedades en la clase Ribbon generada.

La clase Ribbon generada hereda de la clase RibbonBase. Esta clase base redirige todas las llamadas a sus miembros a una implementación interna de la interfaz OfficeRibbon del Motor en tiempo de ejecución de Microsoft Visual Studio Tools para Office. Si desea trabajar con el objeto OfficeRibbon directamente, use la propiedad Base de la clase Ribbon generada.

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)