RibbonGroup Interfaz

Definición

Espacio de nombres:

Microsoft.Office.Tools.Ribbon

Ensamblado:

Microsoft.Office.Tools.Common.dll

Representa un grupo de controles en una pestaña de la cinta de opciones.

public interface class RibbonGroup : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")>]
type RibbonGroup = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGroup
Implements IComponent, IDisposable, RibbonComponent

Atributos

GuidAttribute

Implementaciones

RibbonComponent IComponent IDisposable

Comentarios

Visual Studio crea un objeto al arrastrar un RibbonGroup control Grupo desde la pestaña Controles de cinta de Office del Cuadro de herramientas hasta el Designer de la cinta de opciones.

Tareas comunes

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

Tarea	Miembro
Acceda a los controles del grupo, agregue controles al grupo o quite controles del grupo.	Utilice la propiedad Items.
Agregue un grupo a una pestaña de la cinta de opciones.	Agregue un RibbonGroup objeto a la Groups colección de la pestaña.
Especifique la ubicación de un grupo en una pestaña integrada, en relación con la ubicación de un grupo integrado.	Utilice la propiedad Position.

Puede crear un objeto RibbonGroup en tiempo de ejecución mediante el CreateRibbonGroup método del RibbonFactory objeto .

Hay dos maneras de acceder al objeto RibbonFactory:

• Mediante el uso de la propiedad Factory de la clase Ribbon. Use este enfoque desde el código en la clase Ribbon.

• Usando el método Globals.Factory.GetRibbonFactory. Use este enfoque desde el código externo a 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, consulta Visual Studio Tools for Office Runtime Overview.

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 o una versión posterior. 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, consulte la siguiente sección de referencia en la documentación de Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Propiedades

DialogLauncher	Obtiene o establece el iniciador del cuadro de diálogo de la cinta de opciones 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 que se muestra con la etiqueta del grupo.
Name	Obtiene o establece el nombre de este objeto RibbonComponent. (Heredado de RibbonComponent)
Parent	Obtiene un objeto RibbonComponent que representa el elemento primario de este objeto RibbonComponent. (Heredado de RibbonComponent)
Position	Obtiene o establece la posición de un grupo en una pestaña integrada con respecto a un grupo integrado de la pestaña.
Ribbon	Obtiene el objeto Ribbon de nivel superior que contiene la jerarquía de controles. (Heredado de RibbonComponent)
RibbonUI	Obtiene la instancia de IRibbonUI que la aplicación de Microsoft Office proporciona al código de extensibilidad de la cinta. (Heredado de RibbonComponent)
Tag	Obtiene o establece los datos específicos de la aplicación que están asociados a este objeto RibbonComponent. (Heredado de RibbonComponent)
Visible	Obtiene o establece un valor que indica si el grupo está visible.

Métodos

PerformDynamicLayout()	Llama al método Microsoft.Office.Core.IRibbonUI.InvalidateControl del control primario si el objeto RibbonComponent tiene un elemento primario dinámico, como un menú dinámico, y no se suspende el diseño. (Heredado de RibbonComponent)
PerformLayout()	Llama al método Microsoft.Office.Core.IRibbonUI.InvalidateControl si RibbonComponent tiene un elemento primario y no se suspende el diseño. (Heredado de RibbonComponent)
ResumeLayout()	Invierte el efecto del método SuspendLayout(). (Heredado de RibbonComponent)
ResumeLayout(Boolean)	Invierte el efecto del método SuspendLayout(). (Heredado de RibbonComponent)
SuspendLayout()	Evita que la aplicación de Microsoft Office actualice el estado de los controles de la cinta de opciones. (Heredado de RibbonComponent)

Eventos

DialogLauncherClick

Se produce cuando el usuario hace clic en el icono del iniciador del cuadro de diálogo de la cinta de opciones en el grupo.