RichTextContentControl 介面

定義

代表文件中的文字區塊或其他類型的內容。

[System.Runtime.InteropServices.Guid("fe02ce7e-9ae7-444f-a5f8-af588716d06b")]
public interface RichTextContentControl : IDisposable, Microsoft.Office.Tools.Word.ContentControlBase, System.ComponentModel.IComponent, System.ComponentModel.ISupportInitialize, System.Windows.Forms.IBindableComponent
屬性
實作

範例

下列程式碼範例會將新的新增 RichTextContentControl 至檔的開頭。

這個版本適用于檔層級自訂。 若要使用此程式碼,請將它貼入 ThisDocument 專案中的類別,並 AddRichTextControlAtSelection 從方法呼叫方法 ThisDocument_Startup

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

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

    richTextControl1 = this.Controls.AddRichTextContentControl("richTextControl1");
    richTextControl1.PlaceholderText = "Enter your first name";
}
Dim richTextControl1 As Microsoft.Office.Tools.Word.RichTextContentControl

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

這個版本適用于應用層級增益集。 若要使用此程式碼,請將它貼入 ThisAddIn 專案中的類別,並 AddRichTextControlAtSelection 從方法呼叫方法 ThisAddIn_Startup

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

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

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

    richTextControl1 = vstoDoc.Controls.AddRichTextContentControl("richTextControl1");
    richTextControl1.PlaceholderText = "Enter your first name";
}
Dim richTextControl1 As Microsoft.Office.Tools.Word.RichTextContentControl

Private Sub AddRichTextControlAtSelection()
    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.Select()
    richTextControl1 = vstoDoc.Controls.AddRichTextContentControl("richTextControl1")
    richTextControl1.PlaceholderText = "Enter your first name"
End Sub

備註

RichTextContentControl可以包含文字以及許多其他類型的內容,包括資料表、圖片或其他內容控制項。 您可以將格式化和樣式的組合套用至中的文字 RichTextContentControl

若要建立只能包含文字的檔區域,請使用 PlainTextContentControl

注意

這個介面是由 Visual Studio Tools for Office Runtime 實作, 並不能實作於您的程式碼中。 如需詳細資訊,請參閱 Visual Studio Tools for Office Runtime Overview

內容控制項

RichTextContentControl是八種類型內容控制項的其中一種,您可以用來在 Microsoft Office Word 中設計檔和範本。 內容控制項具有使用者介面 (UI) ,其具有類似表單的控制輸入。 您可以使用內容控制項來防止使用者編輯檔或範本的受保護區段,而且您也可以將內容控制項系結至資料來源。 如需詳細資訊,請參閱 Content Controls

使用量

本文件說明此類型的版本,其會用在目標為 .NET Framework 4 或更新版本的 Office 專案中。 在以 .NET Framework 3.5 為目標的專案中,此類型可能會有不同的成員,而為此類型提供的程式碼範例可能無法運作。 如需此類型在以 .NET Framework 3.5 為目標專案中的相關文件,請參閱下列 Visual Studio 2008 文件中的參考章節:http://go.microsoft.com/fwlink/?LinkId=160658

屬性

Application

取得 Application,代表 Microsoft Office Word 目前的執行個體。

Container (繼承來源 ContentControlBase)
ContainerComponent (繼承來源 ContentControlBase)
Creator

取得 32 位元整數,表示在其中建立 RichTextContentControl 的應用程式。

DefaultDataSourceUpdateMode

取得或設定 DataSourceUpdateMode 的預設 ContentControlBase

(繼承來源 ContentControlBase)
DefaultTextStyle

取得要用來格式化 RichTextContentControl 中之文字的字元樣式名稱。

ID

取得識別內容控制項的唯一號碼。

(繼承來源 ContentControlBase)
InnerObject

取得 ContentControlBase 的基礎 ContentControl 物件。

(繼承來源 ContentControlBase)
LockContentControl

取得或設定值,指定是否可從文件刪除 RichTextContentControl

LockContents

取得或設定值,指定是否可以編輯 RichTextContentControl 的內容。

Parent

取得 RichTextContentControl 的父代 (Parent)。

ParentContentControl

取得以巢狀方式置於另一個內容控制項中之 RichTextContentControl 的父內容控制項。

PlaceholderText

取得或設定 RichTextContentControl 中顯示的文字,直到該文字被使用者動作或其他作業變更為止。

Range

取得 Range,代表 RichTextContentControl 的內容。

ShowingPlaceholderText

取得值,這個值表示 RichTextContentControl 目前是否顯示預留位置文字。

Tag

取得或設定要與 RichTextContentControl 產生關聯的字串。

Temporary

取得或設定值,這個值指定編輯 RichTextContentControl 控制項時,是否會從文件中自動刪除此控制項。

Text

取得或設定 RichTextContentControl 中的文字。

Title

取得或設定 RichTextContentControl 的標題。

方法

Copy()

RichTextContentControl 從文件複製到 [剪貼簿]。

Cut()

從文件移除 RichTextContentControl 並將它加入至 [剪貼簿]。

Delete(Boolean)

從文件中刪除動態建立的內容控制項,並從文件中的 ControlCollection 將它移除。

(繼承來源 ContentControlBase)
SetPlaceholderText(BuildingBlock, Range, String)

顯示 BuildingBlockRange 或字串中的文字,做為 RichTextContentControl 中的預留位置文字。

事件

Added

在內容控制項加入至文件之後發生。

(繼承來源 ContentControlBase)
BindingContextChanged

BindingContextContentControlBase 屬性值變更時發生。

(繼承來源 ContentControlBase)
ContentUpdating

如果內容控制項已繫結至自訂 XML 組件,只在 Microsoft Office Word 更新內容控制項中的文字之前發生。

(繼承來源 ContentControlBase)
Deleting

只在內容控制項從文件中刪除之前發生。

(繼承來源 ContentControlBase)
Entering

當使用者在內容控制項中按一下或以程式設計方式將游標移至內容控制項時發生。

(繼承來源 ContentControlBase)
Exiting

當使用者在內容控制項外部按一下或以程式設計方式將游標移至內容控制項外部時發生。

(繼承來源 ContentControlBase)
StoreUpdating

就在 Microsoft Office Word 更新繫結至內容控制項的自訂 XML 組件資料之前 (也就是內容控制項中的文字變更之後)。

(繼承來源 ContentControlBase)
Validated

在成功驗證內容控制項時發生。

(繼承來源 ContentControlBase)
Validating

驗證內容控制項的內容時發生。

(繼承來源 ContentControlBase)

適用於