RichTextContentControl Classe (sistema de 2007)

Artigo
08/25/2010

Representa um bloco de texto ou outros tipos de conteúdo em um documento.

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 RichTextContentControl _
    Inherits ContentControlBase _
    Implements ISupportInitializeControl, ISupportInitialize

Dim instance As RichTextContentControl

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

Comentários

A RichTextContentControl pode conter texto, assim sistema autônomo muitos outros tipos de conteúdo, incluindo tabelas, imagens ou outro controles de conteúdo. Você pode aplicar uma combinação de estilos e formatação ao texto em um RichTextContentControl.

Para criar uma região de documento só pode conter texto, use um PlainTextContentControl.

Controles de conteúdo

The RichTextContentControl é 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 RichTextContentControl para o início do documento.

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 AddRichTextControlAtSelection método a partir do ThisDocument_Startup método.

Dim richTextControl1 As Microsoft.Office.Tools.Word.RichTextContentControl

PrivateSub AddRichTextControlAtSelection()
    Me.Paragraphs(1).Range.InsertParagraphBefore()
    Me.Paragraphs(1).Range.Select()
    richTextControl1 = Me.Controls.AddRichTextContentControl("richTextControl1")
    richTextControl1.PlaceholderText = "Enter your first name"EndSub

private Microsoft.Office.Tools.Word.RichTextContentControl richTextControl1;

privatevoid AddRichTextControlAtSelection()
{
    this.Paragraphs[1].Range.InsertParagraphBefore();
    this.Paragraphs[1].Range.Select();

    richTextControl1 = this.Controls.AddRichTextContentControl("richTextControl1");
    richTextControl1.PlaceholderText = "Enter your first name";
}

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 AddRichTextControlAtSelection método a partir do ThisAddIn_Startup método.

Dim richTextControl1 As Microsoft.Office.Tools.Word.RichTextContentControl

PrivateSub AddRichTextControlAtSelection()
    IfMe.Application.ActiveDocument IsNothingThenReturnEndIfDim vstoDoc As Document = Me.Application.ActiveDocument.GetVstoObject()
    vstoDoc.Paragraphs(1).Range.InsertParagraphBefore()
    vstoDoc.Paragraphs(1).Range.Select()
    richTextControl1 = vstoDoc.Controls.AddRichTextContentControl("richTextControl1")
    richTextControl1.PlaceholderText = "Enter your first name"EndSub

private Microsoft.Office.Tools.Word.RichTextContentControl richTextControl1;

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

    Document vstoDoc = this.Application.ActiveDocument.GetVstoObject();
    vstoDoc.Paragraphs[1].Range.InsertParagraphBefore();
    vstoDoc.Paragraphs[1].Range.Select();

    richTextControl1 = vstoDoc.Controls.AddRichTextContentControl("richTextControl1");
    richTextControl1.PlaceholderText = "Enter your first name";
}

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.RichTextContentControl

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.