Evento RibbonGroup.DialogLauncherClick (sistema de 2007)

Artigo
08/25/2010

Ocorre quando o usuário clica no ícone de iniciador de diálogo da faixa de opções no agrupar.

Namespace: Microsoft.Office.Tools.Ribbon
Assembly: Microsoft.Office.Tools.Common.v9.0 (em Microsoft.Office.Tools.Common.v9.0.dll)

Sintaxe

Public Event DialogLauncherClick As EventHandler(Of RibbonControlEventArgs)

Dim instance As RibbonGroup
Dim handler As EventHandler(Of RibbonControlEventArgs)

AddHandler instance.DialogLauncherClick, handler

public event EventHandler<RibbonControlEventArgs> DialogLauncherClick

Comentários

O iniciador do diálogo faixa de opções é um pequeno ícone aparece no agrupar.Quando o usuário clica nesse ícone, você pode manipular o DialogLauncherClick evento para em em aberto uma caixa de diálogo personalizada. Por padrão, os grupos não têm um iniciador de caixa de diálogo de faixa de opções.Para obter mais informações, consulte Como: Adicionar um iniciador de caixa de diálogo a um AAgruparar de Faixa de Opções.

Exemplos

O exemplo a seguir mostra como adicionar um iniciador de caixa de diálogo para um agrupar de faixa de opções e como inicialização uma caixa de diálogo personalizada que permite que os usuários escolham as configurações avançadas quando eles clicarem no RibbonDialogLauncher ícone no canto inferior direito das RibbonGroup.

Para executar este exemplo de código, realize as seguintes etapas:

Adicionar um Faixa de opções (Visual Designer) item to a Visual Studio Tools for Office projeto.
Adicionar um RibbonDialogLauncher para o agrupar padrão, conforme descrito em Como: Adicionar um iniciador de caixa de diálogo a um AAgruparar de Faixa de Opções.
Se você estiver usando Visual Basic, adicione um Windows formulário novo Caixa de diálogo item para o projeto.Se você estiver usando translation from VPE for Csharp, adicione um novo Formulário do Windows item e transformá-lo em uma caixa de diálogo, adicionando um OK and Cancelareventos de clicar de botão para o formulário e criar manipuladores de eventos para os botões.
conjunto o (Nome) propriedade da caixa de diálogo para advancedSettingsDialog.Você pode personalizar a caixa de diálogo adicionando controles e configuração mais propriedades.
Adicionar o DialogLauncherClick evento manipulador para o seu código.
Coloque o Sumário do método a seguir o DialogLauncherClick manipulador de eventos.

PrivateSub Group1_DialogLauncherClick(ByVal sender AsObject, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Group1.DialogLauncherClick
    Dim dlg As advancedSettingsDialog = New advancedSettingsDialog()
    dlg.ShowDialog()
EndSub

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

Permissões

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de códigos parcialmente Confiável.