RibbonDropDown Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Representa uma lista de itens que um usuário pode escolher e uma lista de botões da Faixa de Opções em que um usuário pode clicar.
public interface class RibbonDropDown : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")]
public interface RibbonDropDown : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("dbee9dd2-d9b1-4d37-bb31-099fd6d64a68")>]
type RibbonDropDown = interface
interface RibbonControl
interface RibbonComponent
interface IComponent
interface IDisposable
Public Interface RibbonDropDown
Implements IComponent, IDisposable, RibbonControl
- Atributos
- Implementações
Comentários
Um RibbonDropDown pode conter RibbonDropDownItem objetos e RibbonButton controles.
Você pode criar um RibbonDropDown em tempo de execução usando o CreateRibbonDropDown 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.
Não é possível adicionar botões à Buttons coleção em tempo de execução depois que a Faixa de Opções tiver sido carregada no Office.
Os procedimentos a seguir explicam como adicionar RibbonDropDownItem objetos e RibbonButton controles a um RibbonDropDown.
Para adicionar objetos RibbonDropDownItem em tempo de design
Clique na propriedade Itens na janela Propriedades .
Clique nas reticências (...).
No Editor Coleção DropDown, adicione, solicite e edite novos itens.
Você pode adicionar RibbonButton controles a um RibbonDropDown em tempo de design.
Para adicionar controles RibbonButton em tempo de design
Clique na propriedade Botões na janela Propriedades .
Clique nas reticências (...).
Na Editor Coleção de Botões, adicione, solicite e edite novos controles de botão.
Alguns membros desse tipo podem ser definidos somente antes que a Faixa de Opções seja carregada no aplicativo do Office. 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 uma coleção de objetos RibbonButton que pertencem a este RibbonDropDown. |
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 uma imagem exibida neste RibbonDropDown. |
ImageName |
Obtém ou define o nome que você pode usar no manipulador de eventos LoadImage para identificar uma imagem para o controle. |
Items |
Obtém uma coleção de itens neste RibbonDropDown. |
KeyTip |
Obtém ou define o atalho de teclado para este RibbonDropDown. |
Label |
Obtém ou define o texto exibido neste RibbonDropDown. |
Name |
Obtém ou define o nome deste RibbonComponent. (Herdado de RibbonComponent) |
OfficeImageId |
Obterá ou definirá a imagem a ser exibida no RibbonDropDown, se você quiser usar um ícone interno do Microsoft Office. |
Parent |
Obtém um RibbonComponent que representa o pai deste RibbonComponent. (Herdado de RibbonComponent) |
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) |
ScreenTip |
Obtém ou define o texto da dica exibido quando o usuário move o ponteiro sobre o RibbonDropDown. |
SelectedItem |
Obtém ou define o RibbonDropDownItem 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 RibbonDropDown está visível. |
ShowItemImage |
Obtém ou define um valor que indica se as imagens serão exibidas para os itens do menu suspenso. |
ShowItemLabel |
Obtém ou define um valor que indica se os rótulos serão exibidos para os itens do menu suspenso. |
ShowLabel |
Obtém ou define um valor que indica se o rótulo para esse RibbonDropDown está visível. |
SizeString |
Obtém ou define uma cadeia de caracteres que determina o tamanho do RibbonDropDown. |
SuperTip |
Obtém ou define o texto da dica multilinha que é exibido quando o usuário move o ponteiro sobre o RibbonDropDown. |
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 em um RibbonDropDown. |
ItemsLoading |
Ocorre quando os controles são carregados no RibbonDropDown. |
SelectionChanged |
Ocorre quando um usuário seleciona um novo item em um controle de lista suspensa da Faixa de Opções. |