Interface RibbonSplitButton

Artigo
05/21/2013

Um controle de fita que combina um botão ou um botão de alternância e um menu suspenso.

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

Superior

Comentários

Um controle de RibbonSplitButton combina um botão ou um botão de alternância e um menu suspenso.Para escolher entre o botão e o botão de alternância, use a propriedade de ButtonType .

Ao contrário do controle de RibbonMenu , o controle de RibbonSplitButton não tem a propriedade de Dynamic , para que o conteúdo da coleção de Items não podem ser alterados em tempo de execução.

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

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.