Partilhar via


Interface RibbonDropDown

Representa uma lista de itens de que um usuário pode escolher e uma lista de botões de fita que um usuário pode clicar em.

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

Sintaxe

'Declaração
<GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")> _
Public Interface RibbonDropDown _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable
[GuidAttribute("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

O tipo RibbonDropDown expõe os membros a seguir.

Propriedades

  Nome Descrição
Propriedade pública Buttons Obtém uma coleção de objetos de RibbonButton que pertencem a este RibbonDropDown.
Propriedade pública Enabled Obtém ou define um valor que indica se este RibbonControl está habilitado. (Herdado de RibbonControl.)
Propriedade pública Id Obtém uma cadeia de caracteres que usa o Microsoft Office identificar este objeto de RibbonControl . (Herdado de RibbonControl.)
Propriedade pública Image Obtém ou define uma imagem isso são exibidos neste RibbonDropDown.
Propriedade pública ImageName Obtém ou define o nome que você pode usar o manipulador de eventos de LoadImage para identificar uma imagem para o controle.
Propriedade pública Items Obtém uma coleção de itens neste RibbonDropDown.
Propriedade pública KeyTip Obtém ou define o atalho de teclado para este RibbonDropDown.
Propriedade pública Label Obtém ou define o texto que aparece neste RibbonDropDown.
Propriedade pública Name Obtém ou define o nome do RibbonComponent. (Herdado de RibbonComponent.)
Propriedade pública OfficeImageId Obtém ou define a imagem para exibir em RibbonDropDown, se você desejar usar um ícone interno do Microsoft Office.
Propriedade pública Parent Obtém RibbonComponent que representa o pai deste RibbonComponent. (Herdado de RibbonComponent.)
Propriedade pública Ribbon Obtém o objeto de nível superior de Ribbon que contém a hierarquia de controle. (Herdado de RibbonComponent.)
Propriedade pública 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.)
Propriedade pública ScreenTip Obtém ou o texto de dica de conjuntos que aparece quando o usuário move o ponteiro sobre RibbonDropDown.
Propriedade pública SelectedItem Obtém ou define RibbonDropDownItem que está atualmente selecionado.
Propriedade pública SelectedItemIndex Obtém ou define o índice de RibbonDropDownItematualmente selecionado.
Propriedade pública ShowImage Obtém ou define um valor que indica se a imagem que está associada com RibbonDropDown é visível.
Propriedade pública ShowItemImage Obtém ou define um valor que indica se as imagens são exibidas para os itens no menu suspenso.
Propriedade pública ShowItemLabel Obtém ou define um valor que indica se os rótulos são exibidas para os itens no menu suspenso.
Propriedade pública ShowLabel Obtém ou define um valor que indica se o rótulo para este RibbonDropDown é visível.
Propriedade pública Site Obtém ou define o ISite associados a IComponent. (Herdado de IComponent.)
Propriedade pública SizeString Obtém ou define uma cadeia de caracteres que determina o tamanho de RibbonDropDown.
Propriedade pública SuperTip Obtém ou define o texto de várias linhas de dica que aparece quando o usuário move o ponteiro sobre RibbonDropDown.
Propriedade pública Tag Obtém ou define os dados específicos do aplicativo que estão associados com esse RibbonComponent. (Herdado de RibbonComponent.)
Propriedade pública Visible Obtém ou define um valor que indica se este RibbonControl é visível. (Herdado de RibbonControl.)

Superior

Métodos

  Nome Descrição
Método público Dispose Executa tarefas definido pelo aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
Método público 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.)
Método público PerformLayout Chama Microsoft.Office.Core.IRibbonUI.InvalidateControl se RibbonComponent tem um pai e o layout não está suspenso. (Herdado de RibbonComponent.)
Método público ResumeLayout() Inverte o efeito de método de SuspendLayout . (Herdado de RibbonComponent.)
Método público ResumeLayout(Boolean) Inverte o efeito de método de SuspendLayout . (Herdado de RibbonComponent.)
Método público SuspendLayout Impede que o aplicativo do Microsoft Office atualizar o estado de controles em fita. (Herdado de RibbonComponent.)

Superior

Eventos

  Nome Descrição
Evento público ButtonClick Ocorre quando um usuário clica em um botão em RibbonDropDown.
Evento público Disposed Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.)
Evento público ItemsLoading Ocorre quando os controles são carregados em RibbonDropDown.
Evento público SelectionChanged Ocorre quando um usuário seleciona um novo item em um controle suspensa de fita.

Superior

Comentários

RibbonDropDown pode conter objetos de RibbonDropDownItem e controles de RibbonButton .

Você pode criar RibbonDropDown em tempo de execução usando o método de CreateRibbonDropDown 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.

Você não pode adicionar botões à coleção de Buttons em tempo de execução após a fita foi carregado no Office.

Os procedimentos a seguir explicam como adicionar objetos de RibbonDropDownItem e controles de RibbonButton a RibbonDropDown.

Para adicionar em tempo de design objetos de RibbonDropDownItem

  1. Clique na propriedade de Itens na janela de Propriedades .

  2. Clique nas reticências ().

  3. No O editor lista suspensa de coleção, adicione, ordenação, e editar novos itens.

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

Para adicionar em tempo de design controles de RibbonButton

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

  2. Clique nas reticências ().

  3. No O botão editor de coleção, adicione, ordenação, e editar novos controles de botão.

Alguns membros desse tipo podem ser definidos somente antes que a fita é carregada no aplicativo do Office.Para obter informações sobre como definir essas propriedades, consulte Visão geral do modelo de objeto de faixa de opções.

ObservaçãoObservaçã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

RibbonDropDown.Items

RibbonDropDown.Buttons

Outros recursos

Visão geral da faixa de opções

Designer de faixa de opções

Visão geral do modelo de objeto de faixa de opções

Como: começar a personalizar a faixa de opções.