Interface RibbonBox

Artigo
05/21/2013

Organiza e alinha os controles em uma faixa de opções personalizada.

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

Sintaxe

'Declaração
<GuidAttribute("e351eac0-961f-458a-8811-58090e3198ef")> _
Public Interface RibbonBox _
    Inherits RibbonControl, RibbonComponent, IComponent, IDisposable

[GuidAttribute("e351eac0-961f-458a-8811-58090e3198ef")]
public interface RibbonBox : RibbonControl, 
    RibbonComponent, IComponent, IDisposable

O tipo RibbonBox expõe os membros a seguir.

Propriedades

	Nome	Descrição
	BoxStyle	Obtém um RibbonBoxStyle valor que indica se os controles colocados nesta RibbonBox serão colocados horizontalmente ou verticalmente.
	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.)
	Items	Obtém uma coleção de controles que estão nesta RibbonBox objeto.
	Name	Obtém ou define o nome do RibbonComponent. (Herdado de RibbonComponent.)
	Parent	Obtém RibbonComponent que representa o pai deste RibbonComponent. (Herdado de RibbonComponent.)
	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.)
	Site	Obtém ou define o ISite associados a IComponent. (Herdado de IComponent.)
	Tag	Obtém ou define os dados específicos do aplicativo que estão associados com esse RibbonComponent. (Herdado de RibbonComponent.)
	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
	Disposed	Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.)

Superior

Comentários

O RibbonBox Alinha automaticamente os controles da faixa de opções como solta nele.

Use o BoxStyle propriedade para organizar controles filho horizontalmente (padrão) ou verticalmente.Se o conjunto de controles sejam organizados verticalmente e não há espaço suficiente, eles são organizados em várias colunas.

Algumas propriedades deste controle podem ser definidas antes da faixa de opções é 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.

Você pode criar um RibbonBox em tempo de execução usando o CreateRibbonBox método de RibbonFactory objeto.

Há duas maneiras para acessar o RibbonFactory objeto:

Usando o Factory propriedade da classe da faixa de opções.Use essa abordagem de código na classe da faixa de opções.
Usando o Globals.Factory.GetRibbonFactory método.Use essa abordagem do código fora a classe 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 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.