Propriedade RibbonGroup.DialogLauncher

Artigo
08/01/2011

Obtém ou define o iniciador de diálogo de faixa de opções está associado ao grupo.

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

Sintaxe

'Declaração
Property DialogLauncher As RibbonDialogLauncher
    Get
    Set

RibbonDialogLauncher DialogLauncher { get; set; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher
O iniciador do diálogo de faixa de opções é associado ao grupo.

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.

Você pode personalizar o comportamento do recurso Iniciar diálogo de faixa de opções usando as propriedades de RibbonDialogLauncher interface. Por exemplo, para definir a dica de tela que aparece quando o usuário move o ponteiro sobre o ícone do lançador de diálogo, use o ScreenTip propriedade.

Algumas propriedades da RibbonDialogLauncher de interface, como o Image propriedade, são apenas aplicável quando o usuário final adiciona à barra de ferramentas de acesso rápido.

Exemplos

O exemplo a seguir mostra como definir o KeyTip e ScreenTip Propriedades de RibbonDialogLauncher que é adicionado ao grupo padrão.

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 Grupo1 conforme descrito em Como: Adicionar um iniciador de caixa de diálogo a um grupo de faixa de opções.

Private Sub SetDialogLauncherProperties()
    Group1.DialogLauncher.KeyTip = "A"
    Group1.DialogLauncher.ScreenTip = "Advanced Settings"
End Sub

private void SetDialogLauncherProperties()
{
    group1.DialogLauncher.KeyTip = "A";
    group1.DialogLauncher.ScreenTip = "Advanced Settings";
}

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.