RibbonGallery Interface

Definição

public interface class RibbonGallery : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("c1cff037-81e7-44a0-8f9d-150237dfd312")>]
type RibbonGallery = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonGallery
Implements IComponent, IDisposable, RibbonControl

Atributos

GuidAttribute

Implementações

RibbonComponent RibbonControl IComponent IDisposable

Comentários

Assim como a RibbonDropDown interface , RibbonGallery exibe um menu de RibbonDropDownItem objetos e RibbonButton controles.

Ao contrário da RibbonDropDown Interface , a RibbonGallery interface gera Click eventos, em vez de SelectionChanged eventos, quando um usuário clica em um RibbonDropDownItem. Isso significa, por exemplo, que o Click evento é gerado duas vezes quando um usuário clica no mesmo RibbonDropDownItem duas vezes. (O SelectionChanged evento seria gerado no máximo uma vez quando a seleção inicial fosse feita para o mesmo cenário em um RibbonDropDown, dependendo do que era a seleção antes do primeiro clique.)

A ShowItemSelection propriedade controla se o selecionado RibbonDropDownItem no momento é visualmente diferenciado dos itens não selecionados. Somente um item de cada vez pode ser selecionado em um RibbonGallery.

A ItemImageSize propriedade pode ser usada para especificar tamanhos de imagem diferentes de 16x16 e 32x32.

Para adicionar objetos RibbonDropDownItem em tempo de design

1. Clique na propriedade Itens na janela Propriedades .

2. Clique nas reticências (...).

3. No Editor Coleção DropDown, adicione, solicite e edite novos itens.

Você pode adicionar RibbonButton controles a um RibbonGallery em tempo de design.

Para adicionar controles RibbonButton em tempo de design

1. Clique na propriedade Botões na janela Propriedades .

2. Clique nas reticências (...).

3. Na Editor Coleção de Botões, adicione, solicite e edite novos controles de botão.

Você pode criar um RibbonGallery em tempo de execução usando o CreateRibbonGallery método do RibbonFactory objeto .

Existem duas maneiras de acessar o objeto RibbonFactory:

• Usando a propriedade Factory da classe Ribbon. Use essa abordagem no código na classe Ribbon.

• Usando o método Globals.Factory.GetRibbonFactory. Use essa abordagem no código fora da classe Ribbon.

Algumas propriedades desse controle só podem ser definidas antes que a Faixa de Opções seja carregada no aplicativo do Office ou antes que o controle seja adicionado a um menu dinâmico em tempo 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.

Uso

Essa documentação descreve a versão desse tipo que é usada nos projetos do Office direcionados ao .NET Framework 4 ou posterior. Em projetos direcionados ao .NET Framework 3.5, esse tipo pode ter membros diferentes e os exemplos de código fornecidos para este tipo talvez não funcionem. Conheça a documentação sobre este tipo em projetos direcionados ao .NET Framework 3.5 na seguinte seção de referência na documentação do Visual Studio 2008: http://go.microsoft.com/fwlink/?LinkId=160658.

Propriedades

Métodos

Eventos

Aplica-se a