RibbonBox Interface

Referência

Definição

Namespace:: Microsoft.Office.Tools.Ribbon

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

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.

Organiza e alinha os controles em uma Faixa de Opções personalizada.

public interface class RibbonBox : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonControl, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("e351eac0-961f-458a-8811-58090e3198ef")]
public interface RibbonBox : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonControl, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("e351eac0-961f-458a-8811-58090e3198ef")>]
type RibbonBox = interface
    interface RibbonControl
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface RibbonBox
Implements IComponent, IDisposable, RibbonControl

Atributos: GuidAttribute

Implementações: RibbonComponent RibbonControl IComponent IDisposable

Comentários

O RibbonBox alinha automaticamente os controles da Faixa de Opções à medida que você os solta nele.

Use a BoxStyle propriedade para organizar controles filho horizontalmente (padrão) ou verticalmente. Se os controles estiverem definidos para serem organizados verticalmente e não houver espaço suficiente, eles serão organizados em várias colunas.

Algumas propriedades desse controle só podem ser definidas 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.

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

BoxStyle	Obtém um valor RibbonBoxStyle que indica se os controles colocados neste RibbonBox ficarão na horizontal ou vertical.
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)
Items	Obtém uma coleção de controles que estão neste objeto RibbonBox.
Name	Obtém ou define o nome deste RibbonComponent. (Herdado de RibbonComponent)
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)
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)

Aplica-se a

Compartilhar via