Interface GroupContentControl

Artigo
05/21/2013

Representa uma região protegida de um documento que os usuários não podem editar ou excluir.

Namespace: Microsoft.Office.Tools.Word
Assembly: Microsoft.Office.Tools.Word (em Microsoft.Office.Tools.Word.dll)

Sintaxe

'Declaração
<GuidAttribute("1fc77d35-6978-4dbc-a615-9ed8a8f728f5")> _
Public Interface GroupContentControl _
    Inherits ContentControlBase, IBindableComponent, IComponent, IDisposable,  _
    ISupportInitialize

[GuidAttribute("1fc77d35-6978-4dbc-a615-9ed8a8f728f5")]
public interface GroupContentControl : ContentControlBase, 
    IBindableComponent, IComponent, IDisposable, ISupportInitialize

O tipo GroupContentControl expõe os membros a seguir.

Propriedades

	Nome	Descrição
	Application	Obtém Microsoft.Office.Interop.Word.Application que representa a instância atual do Microsoft Office Word.
	BindingContext	Obtém ou define uma coleção dos gerenciadores de moeda para o IBindableComponent. (Herdado de IBindableComponent.)
	Container	Infraestrutura. (Herdado de ContentControlBase.)
	ContainerComponent	Infraestrutura. (Herdado de ContentControlBase.)
	Creator	Obtém um inteiro de 32 bits que indica o aplicativo no qual GroupContentControl foi criado.
	DataBindings	Obtém a coleção de objetos de ligação de dados para este IBindableComponent. (Herdado de IBindableComponent.)
	DefaultDataSourceUpdateMode	Obtém ou define DataSourceUpdateMode padrão para ContentControlBase. (Herdado de ContentControlBase.)
	ID	Obtém um número exclusivo que identifica o controle de conteúdo. (Herdado de ContentControlBase.)
	InnerObject	Obtém o objeto subjacente de Microsoft.Office.Interop.Word.ContentControl para Microsoft.Office.Tools.Word.ContentControlBase. (Herdado de ContentControlBase.)
	LockContentControl	Obtém ou define um valor que especifica se GroupContentControl pode ser excluído do documento.
	Parent	Obtém o pai de GroupContentControl.
	ParentContentControl	Obtém o controle pai de conteúdo de GroupContentControl que está aninhado em outro controle de conteúdo.
	Range	Obtém Range que representa o conteúdo de GroupContentControl.
	Site	Obtém ou define o ISite associados a IComponent. (Herdado de IComponent.)
	Tag	Obtém ou define uma cadeia de caracteres que você deseja associar com GroupContentControl.
	Text	Obtém o texto em GroupContentControl.
	Title	Obtém ou define o título de GroupContentControl.

Superior

Métodos

	Nome	Descrição
	BeginInit	Sinaliza o objeto que a inicialização está iniciando. (Herdado de ISupportInitialize.)
	Copy	Copia GroupContentControl do documento para a área de transferência.
	Cut	Remove GroupContentControl de documento e o adiciona à área de transferência.
	Delete	Exclui um controle de conteúdo dinamicamente criado do documento e remova-o de ControlCollection no documento. (Herdado de ContentControlBase.)
	Dispose	Executa tarefas definido pelo aplicativo associadas liberando, liberando ou redefinindo recursos não gerenciados. (Herdado de IDisposable.)
	EndInit	Sinaliza o objeto que a inicialização for concluída. (Herdado de ISupportInitialize.)

Superior

Eventos

	Nome	Descrição
	Added	Ocorre após o controle de conteúdo é adicionado ao documento. (Herdado de ContentControlBase.)
	BindingContextChanged	Ocorre quando o valor da propriedade de BindingContext de ContentControlBase alterar. (Herdado de ContentControlBase.)
	ContentUpdating	Ocorre antes que o Microsoft Office Word atualiza o texto no controle de conteúdo, se o controle de conteúdo está associado a uma parte personalizado XML. (Herdado de ContentControlBase.)
	Deleting	Ocorre antes que o controle de conteúdo é excluído do documento. (Herdado de ContentControlBase.)
	Disposed	Representa o método que manipula o Disposed o evento de um componente. (Herdado de IComponent.)
	Entering	Ocorre quando o usuário clica no controle do conteúdo, ou quando o cursor é movido no controle de conteúdo programaticamente. (Herdado de ContentControlBase.)
	Exiting	Ocorre quando o usuário clica a fora do controle do conteúdo, ou quando o cursor é movida fora do controle de conteúdo programaticamente. (Herdado de ContentControlBase.)
	StoreUpdating	Ocorre antes que o Microsoft Office Word atualiza dados em uma parte personalizado XML que está associada ao controle de conteúdo (isto é, após o texto nas alterações de controle de conteúdo). (Herdado de ContentControlBase.)
	Validated	Ocorre quando o controle de conteúdo é validado com êxito. (Herdado de ContentControlBase.)
	Validating	Ocorre quando o conteúdo do controle de conteúdo são validados. (Herdado de ContentControlBase.)

Superior

Comentários

Use GroupContentControl para definir uma região protegida de um documento que os usuários não podem editar ou excluir.GroupContentControl pode conter todos os itens de documento, como texto, as tabelas, gráficos, e até mesmo outros controles de conteúdo.GroupContentControl não fornece nenhuma interface do usuário que é visível para o usuário.Para obter mais informações sobre como usar GroupContentControl para proteger uma parte de um documento, consulte Controles de conteúdo e Como: proteger partes de documentos usando os controles de conteúdo.

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.

Conteúdo controles

GroupContentControl é um de oito tipos de controles de conteúdo que você pode usar para criar documentos e modelos no Microsoft Office Word.Os controles de conteúdo têm uma interface de usuário (UI) controle que a entrada como um formulário.Você pode usar controles de conteúdo para impedir que usuários das seções protegidas edição de documento ou modelo, e você também pode associar controles de conteúdo a uma fonte de dados.Para obter mais informações, consulte Controles de conteúdo.

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.

Exemplos

O exemplo de código a seguir adiciona um novo parágrafo para o início do documento, e cria GroupContentControl que contém esse novo parágrafo.GroupContentControl impede que os usuários editem texto no parágrafo.

Esta é uma versão para personalização da nível.Para usar este código, cole na classe de ThisDocument em seu projeto, e chame o método de AddGroupControlAtSelection do método de ThisDocument_Startup .

Dim groupControl1 As Microsoft.Office.Tools.Word.GroupContentControl

Private Sub AddGroupControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Text = "You cannot edit or change the formatting of text " & _
            "in this paragraph, because this paragraph is in a GroupContentControl."
    Me.Paragraphs(1).Range.Select()
    groupControl1 = Me.Controls.AddGroupContentControl("groupControl1")
End Sub

private Microsoft.Office.Tools.Word.GroupContentControl groupControl1;

private void AddGroupControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    Word.Range range1 = this.Paragraphs[1].Range;
    range1.Text = "You cannot edit or change the formatting of text " +
        "in this paragraph, because this paragraph is in a GroupContentControl.";
    range1.Select();

    groupControl1 = this.Controls.AddGroupContentControl("groupControl1");
}

Esta versão é para um suplemento ao aplicativo.Para usar este código, cole na classe de ThisAddIn em seu projeto, e chame o método de AddGroupControlAtSelection do método de ThisAddIn_Startup .

Dim groupControl1 As Microsoft.Office.Tools.Word.GroupContentControl

Private Sub AddGroupControlAtSelection()
    If Me.Application.ActiveDocument Is Nothing Then
        Return
    End If

    Dim vstoDoc As Document = Globals.Factory.GetVstoObject(Me.Application.ActiveDocument)
    vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
    vstoDoc.Paragraphs(1).Range.Text = "You cannot edit or change the formatting of text " & _
            "in this paragraph, because this paragraph is in a GroupContentControl."
    vstoDoc.Paragraphs(1).Range.Select()
    groupControl1 = vstoDoc.Controls.AddGroupContentControl("groupControl1")
End Sub

private Microsoft.Office.Tools.Word.GroupContentControl groupControl1;

private void AddGroupControlAtSelection()
{
    if (this.Application.ActiveDocument == null)
        return;

    Document vstoDoc = Globals.Factory.GetVstoObject(this.Application.ActiveDocument);
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    Word.Range range1 = vstoDoc.Paragraphs[1].Range;
    range1.Text = "You cannot edit or change the formatting of text " +
        "in this paragraph, because this paragraph is in a GroupContentControl.";
    range1.Select();

    groupControl1 = vstoDoc.Controls.AddGroupContentControl("groupControl1");
}