Interface RibbonGallery

Artigo
08/01/2011

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

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

Sintaxe

'Declaração
<GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")> _
Public Interface RibbonGallery _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("c1cff037-81e7-44a0-8f9d-150237dfd312")]
public interface RibbonGallery : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

O tipo RibbonGallery expõe os membros a seguir.

Propriedades

	Nome	Descrição
	Buttons	Obtém a coleção de botões na RibbonGallery.
	ColumnCount	Obtém ou define o número de Item colunas neste RibbonGallery.
	ControlSize	Obtém ou define o tamanho da RibbonGallery de controle.
	Description	Obtém ou define o texto que aparece neste RibbonGallery o controle em um botão de menu ou divisão.
	Enabled	Obtém ou define um valor que indica se este RibbonControl está habilitado. (Herdado de RibbonControl.)
	Id	Obtém uma cadeia de caracteres 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 na LoadImage manipulador de eventos.
	ItemImageSize	Obtém ou define um Size que permite que as dimensões das imagens que são exibidas pelos itens neste RibbonGallery.
	Items	Obtém uma coleção da RibbonDropDownItem componentes neste RibbonGallery.
	KeyTip	Obtém ou define o atalho de teclado para este RibbonGallery.
	Label	Obtém ou define o texto que aparece neste RibbonGallery.
	Name	Obtém ou define o nome deste RibbonComponent. (Herdado de RibbonComponent.)
	OfficeImageId	Obtém ou define a imagem seja exibida no controle, se você quiser usar um ícone de Microsoft Office interno.
	Parent	Obtém um RibbonComponent que representa o pai RibbonComponent. (Herdado de RibbonComponent.)
	Position	Obtém ou define a posição da galeria, se a galeria no Menu de Microsoft Office.
	Ribbon	Obtém um nível superior Ribbon objeto que contém a hierarquia de controle. (Herdado de RibbonComponent.)
	RibbonUI	Infraestrutura. Obtém o IRibbonUI instância que é fornecida pelo aplicativo de 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 de RibbonDropDownItem componentes que este RibbonGallery exibe.
	ScreenTip	Obtém ou define o texto de dica que aparece quando o usuário move o ponteiro sobre este RibbonGallery.
	SelectedItem	Obtém ou define o item atualmente selecionado.
	SelectedItemIndex	Obtém ou define o índice do selecionado no momento RibbonDropDownItem.
	ShowImage	Obtém ou define um valor que indica se a imagem que está associado com o RibbonGallery está visível.
	ShowItemImage	Obtém ou define um valor que indica se as imagens são exibidas para os itens na galeria.
	ShowItemLabel	Obtém ou define um valor que indica se os rótulos são mostrados para os itens nesta RibbonGallery.
	ShowItemSelection	Obtém ou define um valor que indica se o selecionado no momento RibbonDropDownItem visualmente é diferenciado do restante dos itens não selecionados.
	ShowLabel	Obtém ou define um valor que indica se o rótulo RibbonGallery está visível.
	Site	Obtém ou define o ISite associados a IComponent. (Herdado de IComponent.)
	SuperTip	Obtém ou define o texto de várias linhas de dica que aparece quando o usuário move o ponteiro sobre o RibbonGallery.
	Tag	Obtém ou define os dados específicos do aplicativo que está associados esta RibbonComponent. (Herdado de RibbonComponent.)
	Visible	Obtém ou define um valor que indica se este RibbonControl está visível. (Herdado de RibbonControl.)

Início

Métodos

	Nome	Descrição
	Dispose	Executa tarefas de definição de aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
	PerformDynamicLayout	Chamadas a Microsoft.Office.Core.IRibbonUI.InvalidateControl método do pai de controle se o RibbonComponent tem um pai dinâmico, como, por exemplo, um menu dinâmico, e o layout não for suspensa. (Herdado de RibbonComponent.)
	PerformLayout	Chamadas Microsoft.Office.Core.IRibbonUI.InvalidateControl se a RibbonComponent tem um pai e o layout não for suspensa. (Herdado de RibbonComponent.)
	ResumeLayout()	Reverte o efeito da SuspendLayout método. (Herdado de RibbonComponent.)
	ResumeLayout(Boolean)	Reverte o efeito da SuspendLayout método. (Herdado de RibbonComponent.)
	SuspendLayout	Impede que o aplicativo Microsoft Office o estado dos controles da faixa de opções de atualização. (Herdado de RibbonComponent.)

Início

Eventos

	Nome	Descrição
	ButtonClick	Ocorre quando um usuário clica no botão sobre isso RibbonGallery.
	Click	Ocorre quando um usuário clica em um item nesta RibbonGallery.
	Disposed	Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.)
	ItemsLoading	Ocorre quando este RibbonGallery é aberto.

Início

Comentários

Como o RibbonDropDown interface, RibbonGallery exibe um menu de RibbonDropDownItem objetos e RibbonButton controles.

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

O ShowItemSelection controles de propriedade se atualmente selecionada RibbonDropDownItem é visualmente diferenciados de itens não selecionados. Somente um item por vez pode ser selecionado em um RibbonGallery.

O ItemImageSize propriedade pode ser usada para especificar os tamanhos de imagem diferente de 16 x 16 e 32 x 32.

Para adicionar objetos de RibbonDropDownItem em tempo de design

Clique o itens propriedade de Propriedades janela.
Clique nas reticências (...).
No dropdown Collection Editor, adicionar, ordem e editar itens novos.

Você pode adicionar RibbonButton os controles para uma RibbonGallery em tempo de design.

Para adicionar controles de RibbonButton em tempo de design

Clique o botões propriedade de Propriedades janela.
Clique nas reticências (...).
No O Editor de coleção de botão, adicionar, ordem e editar os novos controles de botão.

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

Há duas maneiras para acessar o RibbonFactory objeto:

Usando o Factory propriedade da classe de faixa de opções. Use essa abordagem do código na sua classe de faixa de opções.
Usando o Globals.Factory.GetRibbonFactory método. Use essa abordagem do código fora de sua classe de faixa de opções.

Algumas propriedades desse controle podem ser definidas antes da faixa de opções é carregada em um aplicativo do Office ou antes do controle é 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 de faixa de opções.

Observação
Esta 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 Visual Studio Tools for Office visão geral sobre o tempo de execução.

Usage

Esta documentação descreve a versão deste tipo que é usada em projetos do Office destinados ao .NET Framework 4. Em projetos destinados ao .NET Framework 3.5, este tipo poderá ter membros diferentes, e os exemplos de código fornecidos para o tipo talvez não funcionem. Para obter documentação sobre este tipo em projetos destinados ao .NET Framework 3.5, consulte a seguinte seção de referência na documentação do Visual Studio 2008: https://go.microsoft.com/fwlink/?LinkId=160658.