RibbonDialogLauncher (Clase) (2007 System)

Artículo
09/04/2008

Actualización: noviembre 2007

Representa un pequeño icono estandarizado en un grupo que se puede utilizar para abrir un cuadro de diálogo.

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

Sintaxis

Public NotInheritable Class RibbonDialogLauncher _
    Implements IDisposable

Dim instance As RibbonDialogLauncher

public sealed class RibbonDialogLauncher : IDisposable

Comentarios

RibbonDialogLauncher se muestra de forma predeterminada en la esquina inferior derecha de un grupo.

Las propiedades Image, ImageName y OfficeImageId no tienen efectos visibles cuando se muestra RibbonDialogLauncher en un grupo de la cinta de opciones. Sin embargo, cuando el usuario agrega un objeto RibbonDialogLauncher a la barra de herramientas de acceso rápido, estas propiedades controlan el comportamiento de la imagen mostrada. Además, la propiedad Visible no oculta RibbonDialogLauncher cuando se muestra en la barra de herramientas de acceso rápido. El usuario puede agregar el RibbonDialogLauncher a la barra de herramientas de acceso rápido a través del elemento (XML) de la cinta de opciones. Para obtener más información, vea Información general sobre la cinta de opciones.

RibbonDialogLauncher se aplica únicamente a un objeto RibbonGroup. La clase RibbonGroup tiene un miembro DialogLauncher del tipo RibbonDialogLauncher. Para obtener información sobre cómo agregar un objeto RibbonDialogLauncher a una colección RibbonGroup, vea Cómo: Agregar un selector de cuadro de diálogo a un grupo de la cinta de opciones.

Algunas propiedades de este control sólo 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.

Ejemplos

En el ejemplo siguiente se muestra cómo agregar un RibbonDialogLauncher a un grupo de cinta de opciones y cómo iniciar un cuadro de diálogo personalizado que permita a los usuarios elegir la configuración avanzada cuando hacen clic en el icono RibbonDialogLauncher de la esquina inferior derecha de RibbonGroup.

Para poder ejecutar este ejemplo de código, primero debe seguir este procedimiento:

Agregue un elemento Cinta (diseñador visual) a un proyecto de Visual Studio Tools para Office.
Agregue un RibbonDialogLauncher al Group1 del grupo predeterminado tal y como se describe en Cómo: Agregar un selector de cuadro de diálogo a un grupo de la cinta de opciones.
Si está utilizando Visual Basic, agregue un nuevo elemento Cuadro de diálogo al proyecto. Si está utilizando C#, agregue un nuevo elemento de formularios Windows Forms y conviértalo en un cuadro de diálogo agregando un botón Aceptar y un botón Cancelar al formulario y creando los controladores de eventos para los eventos de clic de los botones.
Establezca la propiedad (Name) del cuadro de diálogo en advancedSettingsDialog. Puede personalizar el cuadro de diálogo agregando los controles y estableciendo más propiedades.
Agregue el controlador de eventos DialogLauncherClick al código.
Coloque el contenido del método siguiente en el controlador de eventos DialogLauncherClick.

Private Sub Group1_DialogLauncherClick(ByVal sender As Object, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Group1.DialogLauncherClick
    Dim dlg As advancedSettingsDialog = New advancedSettingsDialog()
    dlg.ShowDialog()
End Sub

void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
    advancedSettingsDialog dlg = new advancedSettingsDialog();
    dlg.ShowDialog();
}

Jerarquía de herencia

System.Object
Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher

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.