Interface RibbonGallery
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.
Consulte também
Referência
Namespace Microsoft.Office.Tools.Ribbon
Outros recursos
Visão geral da faixa de opções