RibbonGroup Interface

  • Referência

Definição

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

Representa um grupo de controles em uma guia de faixa de opções.

public interface class RibbonGroup : IDisposable, Microsoft::Office::Tools::Ribbon::RibbonComponent, System::ComponentModel::IComponent
[System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : IDisposable, Microsoft.Office.Tools.Ribbon.RibbonComponent, System.ComponentModel.IComponent
[<System.Runtime.InteropServices.Guid("5d8ffee9-0105-497d-af15-6dcc5cc78310")>]
type RibbonGroup = interface
    interface RibbonComponent
    interface IComponent
    interface IDisposable
Public Interface RibbonGroup
Implements IComponent, IDisposable, RibbonComponent
Atributos
GuidAttribute
Implementações
RibbonComponent IComponent IDisposable

Comentários

O Visual Studio cria um RibbonGroup objeto quando você arrasta um controle De grupo da guia Controles da Faixa de Opções do Office da Caixa de Ferramentas para o Designer da Faixa de Opções.

Tarefas comuns

A tabela a seguir lista os membros que são úteis para tarefas comuns. Todas essas tarefas podem ser executadas em tempo de design. Algumas dessas tarefas podem ser executadas em tempo de execução antes que a Faixa de Opções seja carregada. Para obter mais informações, consulte Visão geral do modelo de objeto da faixa de opções.

Tarefa Membro
Acesse os controles no grupo, adicione controles ao grupo ou remova controles do grupo. Use a propriedade Items.
Adicione um grupo a uma guia faixa de opções. Adicione um RibbonGroup à Groups coleção da guia .
Especifique o local de um grupo em uma guia interna, em relação ao local de um grupo interno. Use a propriedade Position.

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

DialogLauncher

Obtém ou define o executável da Faixa de Opções associada a esse grupo.
Id

Obtém uma cadeia de caracteres que identifica o grupo atual.
Items

Obtém os controles no grupo.
KeyTip

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

Obtém ou define o texto exibido pelo rótulo do grupo.
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)
Position

Obtém ou define a posição de um grupo em uma guia interna em relação a um grupo interno na guia.
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 grupo está visível.

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

DialogLauncherClick

Ocorre quando o usuário clicar no ícone iniciador da caixa de diálogo da Faixa de Opções no grupo.

Aplica-se a