RibbonSplitButton Interface

  • Referência

Definição

Namespace:
Microsoft.Office.Tools.Ribbon
Assembly:
Microsoft.Office.Tools.Common.dll

Cria um controle de Faixa de Opções que combina um botão ou um botão de alternância e um menu suspenso.

public interface class RibbonSplitButton : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")]
public interface RibbonSplitButton : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("9d4c5611-01e0-4ad2-9614-8b9edaf6fe2c")>]
type RibbonSplitButton = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonSplitButton
Implements IComponent, IDisposable, RibbonControl
Atributos
GuidAttribute
Implementações
RibbonComponent RibbonControl IComponent IDisposable

Comentários

Cria um controle de Faixa de Opções que combina um botão ou um botão de alternância e um menu suspenso RibbonSplitButton. Para escolher entre o botão e o botão de alternância, use a ButtonType propriedade .

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

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

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

ButtonEnabled

Obtém ou define um valor que indica se o botão no RibbonSplitButton está habilitado.
ButtonType

Obtém ou define o tipo do botão no RibbonSplitButton.
Checked

Obtém ou define um valor que indica se RibbonSplitButton deve ser pressionado ou não pressionado.
ControlSize

Obtém ou define o tamanho do controle RibbonSplitButton .
Description

Obtém ou define o texto que aparece nesse controle RibbonSplitButton em um menu suspenso.
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 a imagem que é exibida no controle.
ImageName

Obtém ou define o nome que você pode usar no manipulador de eventos 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 do RibbonSplitButton.
KeyTip

Obtém ou define o atalho de teclado do controle RibbonSplitButton.
Label

Obtém ou define o texto no controle RibbonSplitButton.
Name

Obtém ou define o nome deste RibbonComponent.

(Herdado de RibbonComponent)
OfficeImageId

Obterá ou definirá a imagem a ser exibida no controle RibbonSplitButton, se você quiser usar um ícone interno do Microsoft Office.
Parent

Obtém um RibbonComponent que representa o pai deste RibbonComponent.

(Herdado de RibbonComponent)
Position

Obterá ou definirá a posição do controle RibbonSplitButton, se ele estiver no Menu do Microsoft Office.
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 de ferramenta exibido quando o usuário move o ponteiro sobre o controle RibbonSplitButton.
ShowLabel

Obtém ou define um valor que indica se o rótulo do controle RibbonSplitButton está visível.
SuperTip

Obtém ou define o texto da dica de ferramentas multilinha exibido quando o usuário move o ponteiro sobre o controle RibbonSplitButton.
Tag

Obtém ou define dados específicos do aplicativo associados a este RibbonComponent.

(Herdado de RibbonComponent)
Title

Obtém ou define o título exibido na parte superior do controle RibbonSplitButton caso ele esteja no Menu do Microsoft Office.
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

Click

Ocorre quando o usuário clica no controle RibbonSplitButton.

Aplica-se a