RibbonGroup (Interfaz)

Artículo
05/15/2013

Representa un grupo de controles en una ficha 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("5d8ffee9-0105-497d-af15-6dcc5cc78310")> _
Public Interface RibbonGroup _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : RibbonComponent, 
    IComponent, IDisposable

El tipo RibbonGroup expone los siguientes miembros.

Propiedades

	Nombre	Descripción
	DialogLauncher	Obtiene o establece el selector de cuadro de diálogo de la cinta de opciones que está asociado al grupo.
	Id	Obtiene una cadena que identifica el grupo actual.
	Items	Obtiene los controles del grupo.
	KeyTip	Obtiene o establece el método abreviado de teclado del grupo.
	Label	Obtiene o establece el texto mostrado en la etiqueta del grupo.
	Name	Obtiene o establece el nombre de este objeto RibbonComponent. (Se hereda de RibbonComponent).
	Parent	Obtiene un objeto RibbonComponent que representa el elemento primario de este objeto RibbonComponent. (Se hereda de RibbonComponent).
	Position	Obtiene o establece la posición de un grupo en una ficha integrada, con respecto a un grupo integrado en la ficha.
	Ribbon	Obtiene el objeto Ribbon de nivel superior que contiene la jerarquía de controles. (Se hereda de RibbonComponent).
	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 el ISite asociado a IComponent. (Se hereda de IComponent).
	Tag	Obtiene o establece los datos específicos de la aplicación que están asociados a este objeto RibbonComponent. (Se hereda de RibbonComponent).
	Visible	Obtiene o establece un valor que indica si el grupo está visible.

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
	DialogLauncherClick	Se produce cuando el usuario hace clic en el icono del selector de cuadro de diálogo de la cinta de opciones en el grupo.
	Disposed	Representa el método que controla el evento Disposed de un componente. (Se hereda de IComponent).

Arriba

Comentarios

Visual Studio crea un objeto RibbonGroup cuando se arrastra un control Agrupar desde la pestaña Controles de la cinta de opciones de Office del Cuadro de herramientas hasta el diseñador de la cinta de opciones.

Tareas comunes

En la tabla siguiente se muestran los miembros que son útiles para las tareas comunes.Todas estas tareas se pueden realizar en tiempo de diseño.Algunas se pueden llevar a cabo en tiempo de ejecución antes de que se cargue la cinta de opciones.Para obtener más información, vea Información general sobre el modelo de objetos para la cinta de opciones.

Tarea	Miembro
Obtener acceso a los controles del grupo, agregar controles al grupo o quitar controles del grupo.	Utilice la propiedad Items.
Agregar un grupo a una ficha de la cinta de opciones.	Agregue RibbonGroup a la colección Groups de la pestaña.
Especificar la ubicación de un grupo en una ficha integrada con respecto a la ubicación de un grupo integrado.	Utilice la propiedad Position.

Puede crear un RibbonGroup en tiempo de ejecución utilizando el método CreateRibbonGroup 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 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.