Interface RibbonSplitButton

Artigo
08/01/2011

Um controle de faixa de opções que combina um botão ou um botão de alternância e um menu drop-down.

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

Sintaxe

'Declaração
<GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")> _
Public Interface RibbonSplitButton _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

O tipo RibbonSplitButton expõe os membros a seguir.

Propriedades

	Nome	Descrição
	ButtonEnabled	Obtém ou define um valor que indica se o botão a RibbonSplitButton está habilitado.
	ButtonType	Obtém ou define o tipo do botão na RibbonSplitButton.
	Checked	Obtém ou define um valor que indica se RibbonSplitButton é pressionado ou não pressionado.
	ControlSize	Obtém ou define o tamanho da RibbonSplitButton de controle.
	Description	Obtém ou define o texto que aparece neste RibbonSplitButton o controle em um menu drop-down.
	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 controle.
	ImageName	Obtém ou define o nome que você pode usar o E:Microsoft.Office.Tools.Ribbon.LoadImage o manipulador de eventos para identificar uma imagem para o controle.
	Items	Obtém a coleção de controles que estão nesta RibbonSplitButton.
	ItemSize	Obtém ou define o tamanho dos controles de RibbonSplitButton drop-down menu.
	KeyTip	Obtém ou define o atalho de teclado da RibbonSplitButton de controle.
	Label	Obtém ou define o texto a RibbonSplitButton de controle.
	Name	Obtém ou define o nome deste RibbonComponent. (Herdado de RibbonComponent.)
	OfficeImageId	Obtém ou define a imagem para exibir o RibbonSplitButton o controle, se você quiser usar um ícone de Microsoft Office internos.
	Parent	Obtém um RibbonComponent que representa o pai RibbonComponent. (Herdado de RibbonComponent.)
	Position	Obtém ou define a posição do RibbonSplitButton o controle, se o controle estiver 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.)
	ScreenTip	Obtém ou define o texto de dica de ferramenta que aparece quando o usuário move o ponteiro sobre o RibbonSplitButton de controle.
	ShowLabel	Obtém ou define um valor que indica se o rótulo para o RibbonSplitButton controle é 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 de ferramenta que aparece quando o usuário move o ponteiro sobre o RibbonSplitButton de controle.
	Tag	Obtém ou define os dados específicos do aplicativo que está associados esta RibbonComponent. (Herdado de RibbonComponent.)
	Title	Obtém ou define o título que aparece na parte superior da RibbonSplitButton controle se o controle está no Menu de Microsoft Office.
	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
	Click	Ocorre quando o usuário clica o RibbonSplitButton de controle.
	Disposed	Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.)

Início

Comentários

A RibbonSplitButton controle combina um botão ou um botão de alternância e um menu drop-down. Para escolher entre o botão e um botão de alternância, use o ButtonType propriedade.

Diferentemente do RibbonMenu controle, o RibbonSplitButton controle não tem o Dynamic propriedade, então, conteúdo da Items coleção não pode ser alterada em tempo de execução.

Você pode criar um RibbonSplitButton em tempo de execução usando o CreateRibbonSplitButton 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.

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.