Evento RibbonGroup.DialogLauncherClick

Artigo
05/21/2013

Ocorre quando o usuário clique no ícone iniciadora da caixa de diálogo de fita 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 lançador da caixa de diálogo de fita é um pequeno ícone que aparece no grupo.Quando o usuário clica neste ícone, você pode manipular o evento de DialogLauncherClick para abrir uma caixa de diálogo personalizada.Por padrão, os grupos não têm um lançador da caixa de diálogo de fita.Para obter mais informações, consulte 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 lançador da caixa de diálogo para um grupo de fita e como iniciar uma caixa de diálogo personalizado que permite que os usuários escolham configurações avançadas quando clique no ícone de RibbonDialogLauncher no canto inferior direito de RibbonGroup.

Para executar este exemplo de código, primeiro você deve executar as seguintes etapas:

Adicionar um item de Faixa de Opções (Visual Designer) a um projeto do Office.
Adicione RibbonDialogLauncher ao grupo padrão de acordo com 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 item de Caixa de Diálogo de formulários do windows ao projeto.Se você estiver usando C#, adicione um novo item de Windows Form e transforme-o em uma caixa de diálogo adicionando um botão de OK e de Cancelar ao formulário e criar manipuladores de eventos para os botões.
Defina a propriedade de (Nome) da caixa de diálogo para advancedSettingsDialog.Você pode personalizar a caixa de diálogo adicionando controles e definindo mais propriedades.
Adicionar o manipulador de eventos de DialogLauncherClick ao seu código.
Coloque o conteúdo do método a seguir no manipulador de eventos de 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();
}

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