Interface RibbonGallery

Artigo
05/21/2013

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

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 neste RibbonGallery.
	ColumnCount	Obtém ou define o número de colunas de Item neste RibbonGallery.
	ControlSize	Obtém ou define o tamanho do controle de RibbonGallery .
	Description	Obtém ou define o texto que aparece no controle de RibbonGallery em um botão de menu ou de 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 que usa o Microsoft Office identificar este objeto de RibbonControl . (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 RibbonGallery no manipulador de eventos de LoadImage .
	ItemImageSize	Obtém ou define Size que fornece as dimensões de imagens que são exibidas pelos itens neste RibbonGallery.
	Items	Obtém uma coleção de componentes de RibbonDropDownItem 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 do RibbonComponent. (Herdado de RibbonComponent.)
	OfficeImageId	Obtém ou define a imagem para exibir no controle, se você desejar usar um ícone interno do Microsoft Office.
	Parent	Obtém RibbonComponent que representa o pai deste RibbonComponent. (Herdado de RibbonComponent.)
	Position	Obtém ou define a posição de galeria, se a galeria está no menu do Microsoft Office.
	Ribbon	Obtém o objeto de nível superior de Ribbon que contém a hierarquia de controle. (Herdado de RibbonComponent.)
	RibbonUI	Infraestrutura. Obtém a instância de IRibbonUI que é fornecida pelo aplicativo do Microsoft Office para o código de extensibilidade de fita. (Herdado de RibbonComponent.)
	RowCount	Obtém ou define o número de linhas de componentes de RibbonDropDownItem que este RibbonGallery exibe.
	ScreenTip	Obtém ou o texto de dica de conjuntos 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 de RibbonDropDownItematualmente selecionado.
	ShowImage	Obtém ou define um valor que indica se a imagem que está associada com RibbonGallery é visível.
	ShowItemImage	Obtém ou define um valor que indica se as imagens são exibidas para os itens em galeria.
	ShowItemLabel	Obtém ou define um valor que indica se os rótulos são mostradas para itens neste RibbonGallery.
	ShowItemSelection	Obtém ou define um valor que indica se RibbonDropDownItem atualmente selecionado é diferenciado visualmente do restante de itens de-selecionados.
	ShowLabel	Obtém ou define um valor que indica se o rótulo para este RibbonGallery é 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 RibbonGallery.
	Tag	Obtém ou define os dados específicos do aplicativo que estão associados com esse RibbonComponent. (Herdado de RibbonComponent.)
	Visible	Obtém ou define um valor que indica se este RibbonControl é visível. (Herdado de RibbonControl.)

Superior

Métodos

	Nome	Descrição
	Dispose	Executa tarefas definido pelo aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
	PerformDynamicLayout	Chama o método de Microsoft.Office.Core.IRibbonUI.InvalidateControl do controle pai se RibbonComponent tem um pai dinâmico, como um menu dinâmico, e layout não está suspenso. (Herdado de RibbonComponent.)
	PerformLayout	Chama Microsoft.Office.Core.IRibbonUI.InvalidateControl se RibbonComponent tem um pai e o layout não está suspenso. (Herdado de RibbonComponent.)
	ResumeLayout()	Inverte o efeito de método de SuspendLayout . (Herdado de RibbonComponent.)
	ResumeLayout(Boolean)	Inverte o efeito de método de SuspendLayout . (Herdado de RibbonComponent.)
	SuspendLayout	Impede que o aplicativo do Microsoft Office atualizar o estado de controles em fita. (Herdado de RibbonComponent.)

Superior

Eventos

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

Superior

Comentários

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

Diferentemente de interface de RibbonDropDown , a interface de RibbonGallery gera eventos de Click , em vez de eventos de SelectionChanged , quando um usuário clica em RibbonDropDownItem.Isso significa que, por exemplo, o evento de Click é disparado duas vezes quando um usuário clica mesmo RibbonDropDownItem duas vezes.(O evento de SelectionChanged deve ser gerado no máximo uma vez quando a seleção inicial foi feita para o mesmo situação em RibbonDropDown, dependendo do que a seleção era antes que o primeiro clique.)

A propriedade de ShowItemSelection controla se RibbonDropDownItem atualmente selecionado é diferenciado visualmente de itens de-selecionados.Somente um item pode ser selecionado de cada vez em RibbonGallery.

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

Para adicionar em tempo de design objetos de RibbonDropDownItem

Clique na propriedade de Itens na janela de Propriedades .
Clique nas reticências ()….
No O editor lista suspensa de coleção, adicione, ordenação, e editar novos itens.

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

Para adicionar em tempo de design controles de RibbonButton

Clique na propriedade de Botões na janela de Propriedades .
Clique nas reticências ()….
No O botão editor de coleção, adicione, ordenação, e editar novos controles de botão.

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

Há duas maneiras para acessar o objeto de RibbonFactory :

Usando a propriedade de Factory fita de classe.Utilize esta abordagem de código em sua classe de fita.
Usando o método Globals.Factory.GetRibbonFactory .Utilize esta abordagem de código fora da classe de fita.

Algumas propriedades deste controle podem ser definidas apenas antes que a fita é carregada no aplicativo do Office ou antes que o 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
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 Visual Studio Tools for Office visão geral sobre o tempo de execução.

Uso

Essa documentação descreve a versão desse tipo que é usada apenas nos projetos do Office direcionados ao .NET Framework 4 e ao .NET Framework 4.5. 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. 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.