Interface RibbonGroup

Artigo
05/21/2013

Representa um grupo de controles em um guia de fita.

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 lançador da caixa de diálogo de fita que está associado com o 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 de grupo.
	Label	Obtém ou define o texto que é exibido pelo rótulo de grupo.
	Name	Obtém ou define o nome do RibbonComponent. (Herdado de RibbonComponent.)
	Parent	Obtém RibbonComponent que representa o pai deste RibbonComponent. (Herdado de RibbonComponent.)
	Position	Obtém ou define a posição de um grupo sobre um guia interno, relativo a um grupo interno na guia.
	Ribbon	Obtém o objeto de nível superior de Ribbon que contém a hierarquia de controle. (Herdado de RibbonComponent.)
	RibbonUI	Infraestrutura. Obtém a instância de IRibbonUI que é fornecida pelo aplicativo do Microsoft Office para o código de extensibilidade de fita. (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ão associados com esse RibbonComponent. (Herdado de RibbonComponent.)
	Visible	Obtém ou define um valor que indica se o grupo é visível.

Superior

Métodos

	Nome	Descrição
	Dispose	Executa tarefas definido pelo aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
	PerformDynamicLayout	Chama o método de Microsoft.Office.Core.IRibbonUI.InvalidateControl do controle pai se RibbonComponent tem um pai dinâmico, como um menu dinâmico, e layout não está suspenso. (Herdado de RibbonComponent.)
	PerformLayout	Chama Microsoft.Office.Core.IRibbonUI.InvalidateControl se RibbonComponent tem um pai e o layout não está suspenso. (Herdado de RibbonComponent.)
	ResumeLayout()	Inverte o efeito de método de SuspendLayout . (Herdado de RibbonComponent.)
	ResumeLayout(Boolean)	Inverte o efeito de método de SuspendLayout . (Herdado de RibbonComponent.)
	SuspendLayout	Impede que o aplicativo do Microsoft Office atualizar o estado de controles em fita. (Herdado de RibbonComponent.)

Superior

Eventos

	Nome	Descrição
	DialogLauncherClick	Ocorre quando o usuário clique no ícone iniciadora da caixa de diálogo de fita no grupo.
	Disposed	Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.)

Superior

Comentários

O Visual Studio cria um objeto de RibbonGroup quando você arrasta um controle de Grupo de tabulação Controles de fita do Office de Caixa de Ferramentas no designer de fita.

Tarefas comuns

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

Tarefa	Membro
Acessar os controles no grupo, adicionar controles ao grupo, ou remova os controles de grupo.	Use a propriedade Items.
Adicione um grupo como uma guia de fita.	Adicione RibbonGroup à coleção de Groups de tabulação.
Especifique o local de um grupo em uma guia interno, relativo ao local de um grupo interno.	Use a propriedade Position.

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

Há duas maneiras para acessar o objeto de RibbonFactory :

Usando a propriedade de Factory fita de classe.Utilize esta abordagem de código em sua classe de fita.
Usando o método Globals.Factory.GetRibbonFactory .Utilize esta abordagem de código fora da classe de fita.

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 Visual Studio Tools for Office visão geral sobre o tempo de execução.

Uso

Essa documentação descreve a versão desse tipo que é usada apenas nos projetos do Office direcionados ao .NET Framework 4 e ao .NET Framework 4.5. 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. 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.