Propriedade RibbonGroup.DialogLauncher

Artigo
05/21/2013

Obtém ou define o lançador da caixa de diálogo de fita que está associado com o grupo.

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

Sintaxe

'Declaração
Property DialogLauncher As RibbonDialogLauncher

RibbonDialogLauncher DialogLauncher { get; set; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher
O lançador da caixa de diálogo de fita que está associado com o grupo.

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.

Você pode personalizar o comportamento iniciadora da caixa de diálogo de fita usando propriedades de interface de RibbonDialogLauncher .Por exemplo, para definir a dica de tela que aparece quando o usuário move o ponteiro do mouse sobre o ícone iniciadora da caixa de diálogo, use a propriedade de ScreenTip .

Algumas propriedades de RibbonDialogLauncher interface, como a propriedade de Image , somente são aplicáveis quando o usuário final para adicionar à barra de ferramentas de acesso rápido.

Exemplos

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

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 Group1 de acordo com 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.