RibbonDialogLauncher Classe (sistema de 2007)

Artigo
08/25/2010

Representa um pequeno ícone padronizado em um agrupar pode ser usado para em em aberto uma caixa de diálogo.

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

Sintaxe

Public NotInheritable Class RibbonDialogLauncher _
    Implements IDisposable

Dim instance As RibbonDialogLauncher

public sealed class RibbonDialogLauncher : IDisposable

Comentários

A RibbonDialogLauncher é exibida no canto inferior direito de um agrupar por padrão.

The Image, ImageName, e OfficeImageId propriedades terão efeito visível quando o RibbonDialogLauncher é exibida em um agrupar de faixa de opções. No entanto, quando um usuário adiciona um RibbonDialogLauncher da barra de ferramentas de acesso rápido, essas propriedades controlam o comportamento da imagem que é mostrado. Além disso, a Visible propriedade não oculta o RibbonDialogLauncher Quando ele é exibido na barra de ferramentas de acesso rápido. O usuário pode adicionar o RibbonDialogLauncher à barra de ferramentas de acesso rápido por meio do Faixa de opções (XML) item.Para obter mais informações, consulte Visão geral da Faixa de Opções.

The RibbonDialogLauncher aplica-se somente a um RibbonGroup. The RibbonGroup classe tem um DialogLauncher membro de RibbonDialogLauncher Digite. Para obter informações sobre como adicionar um RibbonDialogLauncher para um RibbonGroup, consulte Como: Adicionar um iniciador de caixa de diálogo a um AAgruparar de Faixa de Opções.

Algumas propriedades deste controle podem ser conjunto apenas antes que a faixa de opções é carregada no aplicativo do Office.Para obter informações sobre como definir essas propriedades, consulte Visão geral do modelo de objeto da Faixa de Opções.

Exemplos

O exemplo a seguir mostra como adicionar um RibbonDialogLauncher para um agrupar de faixa de opções e como inicialização uma caixa de diálogo personalizada que permite aos usuários escolher configurações avançadas quando eles clicarem na RibbonDialogLauncher ícone no canto inferior direito das RibbonGroup.

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.
Se você estiver usando Visual Basic, adicione um novo Caixa de diálogo item para o projeto.Se você estiver usando translation from VPE for Csharp, adicione um novo Formulário do Windows item e transformá-lo em uma caixa de diálogo adicionando OK and Cancelar botões ao formulário e Criando evento evento s clicar manipuladores para os botões.
conjunto o (Nome) propriedade da caixa de diálogo para advancedSettingsDialog.Você pode personalizar a caixa de diálogo adicionando controles e configuração mais propriedades.
Adicionar o DialogLauncherClick evento manipulador para o seu código.
Coloque o Sumário do método a seguir o DialogLauncherClick manipulador de eventos.

PrivateSub Group1_DialogLauncherClick(ByVal sender AsObject, ByVal e As Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs) Handles Group1.DialogLauncherClick
    Dim dlg As advancedSettingsDialog = New advancedSettingsDialog()
    dlg.ShowDialog()
EndSub

void group1_DialogLauncherClick(object sender, Microsoft.Office.Tools.Ribbon.RibbonControlEventArgs e)
{
    advancedSettingsDialog dlg = new advancedSettingsDialog();
    dlg.ShowDialog();
}

Hierarquia de herança

System.Object
Microsoft.Office.Tools.Ribbon.RibbonDialogLauncher

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.