OfficeRibbon Interface

Definição

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
Implementações

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.

Aplica-se a