OfficeRibbon Interface

Definição

Namespace:

Microsoft.Office.Tools.Ribbon

Assemblies:

Microsoft.Office.Tools.Common.dll, Microsoft.Office.Tools.Common.v4.0.Utilities.dll

Representa uma personalização da Faixa de Opções do Microsoft Office que é criada usando o Designer da Faixa de Opções em um projeto do Office no Visual Studio.

public interface class OfficeRibbon : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent

[System.Runtime.InteropServices.Guid("49fbf223-6d24-4c4b-9101-2d5833434328")]
public interface OfficeRibbon : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent

[<System.Runtime.InteropServices.Guid("49fbf223-6d24-4c4b-9101-2d5833434328")>]
type OfficeRibbon = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable

Public Interface OfficeRibbon
Implements IComponent, IDisposable, RibbonComponent

Atributos

GuidAttribute

Implementações

RibbonComponent IComponent IDisposable

Comentários

Normalmente, você não usa a OfficeRibbon interface diretamente. Em vez disso, use a classe Ribbon gerada pelo Visual Studio ao adicionar um novo item de Faixa de Opções (Visual Designer) ao seu projeto. Você pode realizar a maioria das tarefas relacionadas à Faixa de Opções usando eventos e propriedades na classe de Faixa de Opções gerada.

A classe Ribbon gerada herda da RibbonBase classe . Essa classe base redireciona todas as chamadas para seus membros para uma implementação interna da OfficeRibbon interface que o Visual Studio Tools para Office runtime. Se você quiser trabalhar diretamente com o OfficeRibbon objeto, use a Base propriedade da classe Ribbon gerada.

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

Context	Obtém a janela Inspetor ou a janela Gerenciador no Outlook associada a esta Faixa de Opções.
DefaultExtension	Obtém a extensão padrão para esse objeto OfficeRibbon.
Extension	Obtém uma extensão personalizada para esse objeto OfficeRibbon.
Global	Obtém ou define um valor que determina se este OfficeRibbon pode ser usado simultaneamente em vários contextos.
Name	Obtém ou define o nome deste RibbonComponent. (Herdado de RibbonComponent)
OfficeMenu	Obtém um RibbonOfficeMenu que representa a personalização do Menu do Microsoft Office.
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)
RibbonId	Obtém a ID da Faixa de Opções que foi usada para criar essa instância do objeto OfficeRibbon.
RibbonType	Obtém uma lista separada por vírgulas das IDs da Faixa de Opções associadas a essa instância OfficeRibbon.
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)
StartFromScratch	Obtém ou define um valor que indica se deve ocultar todas as guias internas da Faixa de Opções e a maioria dos comandos no Menu do Microsoft Office e exibir somente as personalizações que são definidas neste item da Faixa de Opções.
Tabs	Obtém uma coleção de objetos RibbonTab no RibbonOfficeMenu.
Tag	Obtém ou define dados específicos do aplicativo associados a este RibbonComponent. (Herdado de RibbonComponent)

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

Close	Ocorre quando essa instância de OfficeRibbon está sendo fechada.
Load	Ocorre quando o OfficeRibbon é carregado no aplicativo Microsoft Office.
LoadImage	Ocorre quando o OfficeRibbon é carregado, caso a propriedade ImageName esteja definida para um ou mais controles.