RibbonGroup.DialogLauncher A propriedade (sistema de 2007)

Artigo
08/25/2010

Obtém ou define o iniciador do diálogo Faixa de Opções de Opções associado com o agrupar.

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

Sintaxe

Public Property DialogLauncher As RibbonDialogLauncher

Dim instance As RibbonGroup
Dim value As RibbonDialogLauncher

value = instance.DialogLauncher

instance.DialogLauncher = value

public RibbonDialogLauncher DialogLauncher { get; set; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher
O iniciador do diálogo Faixa de Opções de Opções associado com o agrupar.

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.

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

Algumas propriedades do RibbonDialogLauncher classe, sistema autônomo o Image propriedade, são aplicável somente quando o usuário participante a adiciona à barra de ferramentas de acesso rápido.

Exemplos

O exemplo a seguir mostra como conjunto o KeyTip e ScreenTip nas propriedades de RibbonDialogLauncher que é adicionado ao agrupar padrão.

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

PrivateSub SetDialogLauncherProperties()
    Group1.DialogLauncher.KeyTip = "A"
    Group1.DialogLauncher.ScreenTip = "Advanced Settings"EndSub

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

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.