RibbonGallery Classe (sistema de 2007)

Artigo
08/25/2010

Representa um controle que exibe um menu de RibbonDropDownItem objetos e RibbonButton controles.

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

Sintaxe

<ToolboxBitmapAttribute(GetType(RibbonGallery), "RibbonGallery.bmp")> _
Public NotInheritable Class RibbonGallery _
    Inherits RibbonControl

Dim instance As RibbonGallery

[ToolboxBitmapAttribute(typeof(RibbonGallery), "RibbonGallery.bmp")]
public sealed class RibbonGallery : RibbonControl

Comentários

Como a RibbonDropDown classe, RibbonGallery Exibe um menu de RibbonDropDownItem objetos e RibbonButton controles.

Ao contrário de RibbonDropDown classe, o RibbonGallery classe gera Click eventos, em vez de SelectionChanged eventos, quando um usuário clica em um RibbonDropDownItem. Isso significa que, por exemplo, que o Click evento é acionado duas vezes quando um usuário clica o mesmo RibbonDropDownItem duas vezes. (The SelectionChanged evento deve ser gerado no máximo uma vez quando a seleção inicial foi feita para o mesmo cenário em um RibbonDropDownDependendo de qual era a seleção antes do primeiro clicar.)

The ShowItemSelection propriedade controla se atualmente selecionado RibbonDropDownItem visualmente diferenciados dos itens não selecionados. Somente um item por vez pode ser selecionado em um RibbonGallery.

The ItemImageSize propriedade pode ser usada para especificar a imagem de tamanhos diferentes de 16 x 16 e 32 x 32.

Você pode adicionar RibbonDropDownItem objetos para um RibbonGallery em time de design ou em time de execução.

Para adicionar objetos RibbonDropDownItem em time de design

clicar no Itens propriedade a Propriedades janela.
clicar nas reticências (... ).
No DropDown coleção Editor, adicionar pedido e edição itens novos.

As etapas a seguir explicam como adicionar um RibbonDropDownItem em time de execução.

Para adicionar um objeto RibbonDropDownItem em time de execução

Criar um novo RibbonDropDownItem usando o RibbonDropDownItem.
Adicionar o RibbonDropDownItem Você criou para o Items coleção isso RibbonGallery objeto.

Você pode adicionar RibbonButton os controles para um RibbonGallery em time de design.

Adicionar RibbonButton controles em time de design

clicar no Botões propriedade a Propriedades janela.
clicar nas reticências (... ).
No Botão coleção Editor, adicionar pedido e edite novos controles de botão.

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

Hierarquia de herança

System.Object
  System.MarshalByRefObject
    System.ComponentModel.Component
      Microsoft.Office.Tools.Ribbon.RibbonComponent
        Microsoft.Office.Tools.Ribbon.RibbonControl
          Microsoft.Office.Tools.Ribbon.RibbonGallery

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.