Interface RibbonGroup

Artigo
08/01/2011

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

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

Sintaxe

'Declaração
<GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")> _
Public Interface RibbonGroup _
    Inherits RibbonComponent, IComponent, IDisposable

[GuidAttribute("5d8ffee9-0105-497d-af15-6dcc5cc78310")]
public interface RibbonGroup : RibbonComponent, 
    IComponent, IDisposable

O tipo RibbonGroup expõe os membros a seguir.

Propriedades

	Nome	Descrição
	DialogLauncher	Obtém ou define o iniciador de diálogo de faixa de opções está associado ao grupo.
	Id	Obtém uma seqüência 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 que é 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 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 um nível superior Ribbon objeto que contém a hierarquia de controle. (Herdado de RibbonComponent.)
	RibbonUI	Infraestrutura. Obtém o IRibbonUI instância que é fornecida pelo aplicativo de Microsoft Office para o código de extensibilidade da faixa de opções. (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á associados esta RibbonComponent. (Herdado de RibbonComponent.)
	Visible	Obtém ou define um valor que indica se o grupo está visível.

Início

Métodos

	Nome	Descrição
	Dispose	Executa tarefas de definição de aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
	PerformDynamicLayout	Chamadas a Microsoft.Office.Core.IRibbonUI.InvalidateControl método do pai de controle se o RibbonComponent tem um pai dinâmico, como, por exemplo, um menu dinâmico, e o layout não for suspensa. (Herdado de RibbonComponent.)
	PerformLayout	Chamadas Microsoft.Office.Core.IRibbonUI.InvalidateControl se a RibbonComponent tem um pai e o layout não for suspensa. (Herdado de RibbonComponent.)
	ResumeLayout()	Reverte o efeito da SuspendLayout método. (Herdado de RibbonComponent.)
	ResumeLayout(Boolean)	Reverte o efeito da SuspendLayout método. (Herdado de RibbonComponent.)
	SuspendLayout	Impede que o aplicativo Microsoft Office o estado dos controles da faixa de opções de atualização. (Herdado de RibbonComponent.)

Início

Eventos

	Nome	Descrição
	DialogLauncherClick	Ocorre quando o usuário clica no ícone do lançador de diálogo da faixa de opções no grupo.
	Disposed	Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.)

Início

Comentários

Visual Studio cria um RibbonGroup objeto quando você arrasta um grupo de controle da Controles de faixa de opções do Office guia da Toolbox para o Designer de 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 é carregada. For more information, see Visão geral do modelo de objeto de faixa de opções.

Task	Member
Acessar os controles no grupo, adicionar controles ao grupo ou remover controles do grupo.	Use o Items propriedade.
Adicione um grupo a uma guia da faixa de opções.	Adicionar um RibbonGroup para o Groups coleção de na guia.
Especifique o local de um grupo em uma guia interna, relativa ao local de um grupo interno.	Use o Position propriedade.

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

Há duas maneiras para acessar o RibbonFactory objeto:

Usando o Factory propriedade da classe de faixa de opções. Use essa abordagem do código na sua classe de faixa de opções.
Usando o Globals.Factory.GetRibbonFactory método. Use essa abordagem do código fora de sua classe de faixa de opções.

Observação
Esta 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.

Usage

Esta documentação descreve a versão deste tipo que é usada em projetos do Office destinados ao .NET Framework 4. Em projetos destinados ao .NET Framework 3.5, este tipo poderá ter membros diferentes, e os exemplos de código fornecidos para o 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.