GroupContentControl Classe (sistema de 2007)

Artigo
08/25/2010

Representa um protegido região de um documento que os usuários não é possível edição ou excluir.

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

Sintaxe

<DefaultBindingPropertyAttribute("Text")> _
<PermissionSetAttribute(SecurityAction.Demand, Name := "FullTrust")> _
Public NotInheritable Class GroupContentControl _
    Inherits ContentControlBase _
    Implements ISupportInitializeControl, ISupportInitialize

Dim instance As GroupContentControl

[DefaultBindingPropertyAttribute("Text")]
[PermissionSetAttribute(SecurityAction.Demand, Name = "FullTrust")]
public sealed class GroupContentControl : ContentControlBase, 
    ISupportInitializeControl, ISupportInitialize

Comentários

Use um GroupContentControl Para definir uma área protegida de um documento que os usuários não é possível edição ou excluir. A GroupContentControl pode conter quaisquer itens de documento, sistema autônomo texto, tabelas, gráficos e até mesmo Outros controles de conteúdo. A GroupContentControl não fornece nenhuma interface do usuário que esteja visível para o usuário. Para obter mais informações sobre como usar um GroupContentControl para proteger uma parte de um documento, consulte Os controles de conteúdo e Como: Proteger partes de documentos, usando controles de conteúdo.

Controles de conteúdo

The GroupContentControl é um dos oito tipos de controles de conteúdo que você pode usar para documentos de design e modelos no Microsoft Office palavra. Conteúdo controles possuem uma interface de usuário (UI) que tem controlada entrada como um formulário.Você pode usar controles de conteúdo para impedir que os usuários editem seções protegidas do documento ou modelo e você também pode BIND controles de conteúdo a uma fonte de dados.Para obter mais informações, consulte Os controles de conteúdo.

Exemplos

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

Esta versão é para uma personalização em nível de documento.Para usar esse código, cole-o no ThisDocument classe em seu projeto e a telefonar a AddGroupControlAtSelection método a partir do ThisDocument_Startup método.

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

PrivateSub 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")
EndSub

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

privatevoid 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 no nível de aplicativo.Para usar esse código, cole-o no ThisAddIn classe em seu projeto e a telefonar a AddGroupControlAtSelection método a partir do ThisAddIn_Startup método.

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

PrivateSub AddGroupControlAtSelection()
    IfMe.Application.ActiveDocument IsNothingThenReturnEndIfDim vstoDoc As Document = Me.Application.ActiveDocument.GetVstoObject()
    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")
EndSub

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

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

    Document vstoDoc = this.Application.ActiveDocument.GetVstoObject();
    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");
}

Hierarquia de herança

System.Object
  Microsoft.VisualStudio.Tools.Office.RemoteComponent
    Microsoft.VisualStudio.Tools.Office.RemoteBindableComponent
      Microsoft.Office.Tools.Word.ContentControlBase
        Microsoft.Office.Tools.Word.GroupContentControl

Acesso thread-safe

Quaisquer membros static (Shared no Visual Basic) públicos deste tipo são thread-safe. Não há garantia de que qualquer membro de instância seja thread-safe.