RibbonGallery Interface

Definição

Namespace:

Microsoft.Office.Tools.Ribbon

Assembly:

Microsoft.Office.Tools.Common.dll

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

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.

Observação

Essa interface é implementada pelo Visual Studio Tools for Office Runtime. Ela não se destina a ser implementada em seu código. Para obter mais informações, consulte Visão geral do Visual Studio Tools para Office Runtime.

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

Buttons	Obtém a coleção de botões neste RibbonGallery.
ColumnCount	Obtém ou define o número de colunas Item nesse RibbonGallery.
ControlSize	Obtém ou define o tamanho do controle RibbonGallery .
Description	Obtém ou define o texto que aparece nesse controle RibbonGallery em um botão de menu ou de divisão.
Enabled	Obtém ou define um valor que indica se o RibbonControl está habilitado. (Herdado de RibbonControl)
Id	Obtém uma cadeia de caracteres que o Microsoft Office usa para identificar esse RibbonControl objeto. (Herdado de RibbonControl)
Image	Obtém ou define a imagem que é exibida no botão.
ImageName	Obtém ou define o nome que você pode usar para identificar o RibbonGallery no manipulador de eventos LoadImage.
ItemImageSize	Obtém ou define um Size que fornece as dimensões das imagens exibidas pelos itens neste RibbonGallery.
Items	Obtém uma coleção dos componentes RibbonDropDownItem neste RibbonGallery.
KeyTip	Obtém ou define o atalho de teclado para este RibbonGallery.
Label	Obtém ou define o texto exibido neste RibbonGallery.
Name	Obtém ou define o nome deste RibbonComponent. (Herdado de RibbonComponent)
OfficeImageId	Obterá ou definirá a imagem a ser exibida no controle, se você quiser usar um ícone interno do Microsoft Office.
Parent	Obtém um RibbonComponent que representa o pai deste RibbonComponent. (Herdado de RibbonComponent)
Position	Obterá ou definirá a posição da galeria, se ela estiver no Menu do Microsoft Office.
Ribbon	Obtém o objeto Ribbon de nível superior que contém a hierarquia de controle. (Herdado de RibbonComponent)
RibbonUI	Obtém a instância IRibbonUI fornecida pelo aplicativo do Microsoft Office para o código de extensibilidade da Faixa de Opções. (Herdado de RibbonComponent)
RowCount	Obtém ou define o número de linhas dos componentes RibbonDropDownItem que esse RibbonGallery exibe.
ScreenTip	Obtém ou define o texto da dica exibido quando o usuário move o ponteiro sobre esse RibbonGallery.
SelectedItem	Obtém ou define o item selecionado atualmente.
SelectedItemIndex	Obtém ou define o índice do RibbonDropDownItem atualmente selecionado.
ShowImage	Obtém ou define um valor que indica se a imagem que está associada ao RibbonGallery está visível.
ShowItemImage	Obtém ou define um valor que indica se as imagens são exibidas para os itens da galeria.
ShowItemLabel	Obtém ou define um valor que indica se os rótulos são mostrados para os itens desta RibbonGallery.
ShowItemSelection	Obtém ou define um valor que indica se o RibbonDropDownItem selecionado atualmente é visualmente diferenciado do restante dos itens não selecionados.
ShowLabel	Obtém ou define um valor que indica se o rótulo para esse RibbonGallery está visível.
SuperTip	Obtém ou define o texto da dica multilinha que é exibido quando o usuário move o ponteiro sobre o RibbonGallery.
Tag	Obtém ou define dados específicos do aplicativo associados a este RibbonComponent. (Herdado de RibbonComponent)
Visible	Obtém ou define um valor que indica se o RibbonControl está visível. (Herdado de RibbonControl)

Métodos

PerformDynamicLayout()	Chamará o método Microsoft.Office.Core.IRibbonUI.InvalidateControl do controle pai se o RibbonComponent tiver um pai dinâmico, como um menu dinâmico, e o layout não for suspenso. (Herdado de RibbonComponent)
PerformLayout()	Chamará Microsoft.Office.Core.IRibbonUI.InvalidateControl se o RibbonComponent tiver um pai e o layout não estiver suspenso. (Herdado de RibbonComponent)
ResumeLayout()	Inverte o efeito do método SuspendLayout(). (Herdado de RibbonComponent)
ResumeLayout(Boolean)	Inverte o efeito do método SuspendLayout(). (Herdado de RibbonComponent)
SuspendLayout()	Impede que o aplicativo Microsoft Office atualize o estado dos controles na Faixa de Opções. (Herdado de RibbonComponent)

Eventos

ButtonClick	Ocorre quando um usuário clica no botão neste RibbonGallery.
Click	Ocorre quando um usuário clica em um item neste RibbonGallery.
ItemsLoading	Ocorre quando este RibbonGallery é aberto.