Evento RibbonGroup.DialogLauncherClick

Artigo
08/01/2011

Ocorre quando o usuário clica no ícone do lançador de diálogo da faixa de opções no grupo.

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

Sintaxe

'Declaração
Event DialogLauncherClick As RibbonControlEventHandler

event RibbonControlEventHandler DialogLauncherClick

Comentários

O iniciador da caixa de diálogo de faixa de opções é um pequeno ícone que aparece no grupo. Quando o usuário clica nesse ícone, você pode manipular o DialogLauncherClick evento para abrir 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. For more information, see Como: Adicionar um iniciador de caixa de diálogo a um grupo de faixa de opções.

Exemplos

O exemplo a seguir mostra como adicionar um iniciador de caixa de diálogo para um grupo de faixa de opções e como iniciar uma caixa de diálogo personalizada que permite aos usuários escolher configurações avançadas, quando eles clicam na RibbonDialogLauncher ícone no canto inferior esquerdo do RibbonGroup.

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

Adicionar um a faixa de opções (Visual Designer) item a um projeto do Office.
Adicionar um RibbonDialogLauncher para o grupo padrão, conforme descrito em Como: Adicionar um iniciador de caixa de diálogo a um grupo de faixa de opções.
Se você estiver usando Visual Basic, adicione um novo formulário do Windows caixa de diálogo item ao projeto. Se você estiver usando o C#, adicionar um novo Windows Form item e a transforma em uma caixa de diálogo, adicionando um OK e Cancelar botão para o formulário e criar manipuladores de eventos para os botões Clique em eventos.
Definir o (nome) a propriedade da caixa de diálogo para advancedSettingsDialog. Você pode personalizar a caixa de diálogo adicionando controles e configurando mais propriedades.
Adicionar o DialogLauncherClick o manipulador de eventos para o seu código.
Colocar o conteúdo do seguinte método para o DialogLauncherClick manipulador de eventos.

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();
}

Segurança do .NET Framework

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ódigo parcialmente confiáveis.

Consulte também

Referência

RibbonGroup Interface

Namespace Microsoft.Office.Tools.Ribbon

Outros recursos

Como: Adicionar um iniciador de caixa de diálogo a um grupo de faixa de opções

Compartilhar via