本文為機器翻譯文章。如需檢視英文版,請選取 [原文] 核取方塊。您也可以將滑鼠指標移到文字上,即可在快顯視窗顯示英文原文。
譯文
原文

PlainTextContentControl 介面

 

代表文件中的文字區塊。

命名空間:   Microsoft.Office.Tools.Word
組件:  Microsoft.Office.Tools.Word (於 Microsoft.Office.Tools.Word.dll)

[GuidAttribute("a8c46931-fa10-4760-8b46-0f2d881e269f")]
public interface PlainTextContentControl : ContentControlBase, 
	IBindableComponent, IComponent, IDisposable, ISupportInitialize

名稱描述
System_CAPS_pubpropertyApplication

取得 Microsoft.Office.Interop.Word.Application 表示 Microsoft Office Word 的目前執行個體。

System_CAPS_pubpropertyBindingContext

(繼承自 IBindableComponent。)

System_CAPS_pubpropertyContainer

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 (繼承自 ContentControlBase。)

System_CAPS_pubpropertyContainerComponent

此 API 支援 產品 基礎結構,而且不適合直接從程式碼使用。 (繼承自 ContentControlBase。)

System_CAPS_pubpropertyCreator

取得 32 位元整數,表示要在其中 PlainTextContentControl 所建立。

System_CAPS_pubpropertyDataBindings

(繼承自 IBindableComponent。)

System_CAPS_pubpropertyDefaultDataSourceUpdateMode

取得或設定預設 DataSourceUpdateModeContentControlBase(繼承自 ContentControlBase。)

System_CAPS_pubpropertyDefaultTextStyle

取得要用來格式化文字的字元樣式名稱 PlainTextContentControl

System_CAPS_pubpropertyID

取得識別內容控制項的唯一號碼。(繼承自 ContentControlBase。)

System_CAPS_pubpropertyInnerObject
System_CAPS_pubpropertyLockContentControl

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

System_CAPS_pubpropertyLockContents

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

System_CAPS_pubpropertyMultiLine

取得或設定值,指定是否 PlainTextContentControl 可包含分行符號。

System_CAPS_pubpropertyParent

取得 PlainTextContentControl 的父代 (Parent)。

System_CAPS_pubpropertyParentContentControl

取得父系內容控制項的 PlainTextContentControl ,巢狀方式置於另一個內容控制項。

System_CAPS_pubpropertyPlaceholderText

取得或設定顯示在文字 PlainTextContentControl 之前的文字變更的使用者動作或其他作業。

System_CAPS_pubpropertyRange

取得 Range,代表 PlainTextContentControl 的內容。

System_CAPS_pubpropertyShowingPlaceholderText

取得值,指定是否 PlainTextContentControl 顯示預留位置文字。

System_CAPS_pubpropertySite

(繼承自 IComponent。)

System_CAPS_pubpropertyTag

取得或設定字串,您要與 PlainTextContentControl

System_CAPS_pubpropertyTemporary

取得或設定值,指定是否 PlainTextContentControl 自動刪除文件中編輯控制項時。

System_CAPS_pubpropertyText

取得或設定文字 PlainTextContentControl

System_CAPS_pubpropertyTitle

取得或設定標題的 PlainTextContentControl

System_CAPS_pubpropertyXMLMapping

取得 XMLMapping,代表 PlainTextContentControl 與自訂 XML 組件中的項目之間的繫結。

名稱描述
System_CAPS_pubmethodBeginInit()

(繼承自 ISupportInitialize。)

System_CAPS_pubmethodCopy()

複製 PlainTextContentControl 從剪貼簿的文件。

System_CAPS_pubmethodCut()

移除 PlainTextContentControl 文件並將其新增到剪貼簿。

System_CAPS_pubmethodDelete(Boolean)

從文件中刪除動態建立的內容控制項,並從文件中的 ControlCollection 將它移除。(繼承自 ContentControlBase。)

System_CAPS_pubmethodDispose()

(繼承自 IDisposable。)

System_CAPS_pubmethodEndInit()

(繼承自 ISupportInitialize。)

System_CAPS_pubmethodSetPlaceholderText(BuildingBlock, Range, String)

顯示在文字 BuildingBlock, 、 Range, ,或字串做為預留位置文字 PlainTextContentControl

名稱描述
System_CAPS_pubeventAdded

內容控制項加入至文件之後,就會發生。(繼承自 ContentControlBase。)

System_CAPS_pubeventBindingContextChanged

發生時的值 BindingContext 屬性 ContentControlBase 變更。(繼承自 ContentControlBase。)

System_CAPS_pubeventContentUpdating

如果內容控制項繫結至自訂 XML 組件,會發生之前在 Microsoft Office Word 更新內容控制項中的文字。(繼承自 ContentControlBase。)

System_CAPS_pubeventDeleting

從文件刪除內容控制項之前發生。(繼承自 ContentControlBase。)

System_CAPS_pubeventDisposed

(繼承自 IComponent。)

System_CAPS_pubeventEntering

發生於使用者按下內容控制項,或以程式設計方式將游標移至內容控制項。(繼承自 ContentControlBase。)

System_CAPS_pubeventExiting

發生於當使用者按一下內容控制項外部或以程式設計方式將游標移至內容控制項外部。(繼承自 ContentControlBase。)

System_CAPS_pubeventStoreUpdating

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

System_CAPS_pubeventValidated

在成功驗證內容控制項時發生。(繼承自 ContentControlBase。)

System_CAPS_pubeventValidating

發生於驗證內容控制項的內容。(繼承自 ContentControlBase。)

A T:Microsoft.Office.Tools.Word.PlainTextContentControl can contain only text. You can format the text in a T:Microsoft.Office.Tools.Word.PlainTextContentControl, but all of the text in the control automatically has the same formatting. For example, if you italicize one word of a sentence that is in a T:Microsoft.Office.Tools.Word.PlainTextContentControl, all the text inside the control is italicized.

To access the text in a T:Microsoft.Office.Tools.Word.PlainTextContentControl, use the P:Microsoft.Office.Tools.Word.PlainTextContentControl.Text property. By default, a T:Microsoft.Office.Tools.Word.PlainTextContentControl cannot contain line breaks. To change this behavior, use the P:Microsoft.Office.Tools.Word.PlainTextContentControl.MultiLine property.

To create a document region that can contain text and many other types of content, including tables, pictures, or other content controls, use a T:Microsoft.Office.Tools.Word.RichTextContentControl.

System_CAPS_note注意

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

The T:Microsoft.Office.Tools.Word.PlainTextContentControl is one of eight types of content controls that you can use to design documents and templates in Microsoft Office Word. Content controls have a user interface (UI) that has controlled input like a form. You can use content controls to prevent users from editing protected sections of the document or template, and you can also bind content controls to a data source. For more information, see Content Controls.

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

The following code example adds a new T:Microsoft.Office.Tools.Word.PlainTextContentControl to the beginning of the document.

This version is for a document-level customization. To use this code, paste it into the ThisDocument class in your project, and call the AddTextControlAtSelection method from the ThisDocument_Startup method.

private Microsoft.Office.Tools.Word.PlainTextContentControl textControl1;

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

    textControl1 = this.Controls.AddPlainTextContentControl("textControl1");
    textControl1.PlaceholderText = "Enter your first name";
}

This version is for an application-level add-in. To use this code, paste it into the ThisAddIn class in your project, and call the AddTextControlAtSelection method from the ThisAddIn_Startup method.

private Microsoft.Office.Tools.Word.PlainTextContentControl textControl1;

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

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

    textControl1 = vstoDoc.Controls.AddPlainTextContentControl("textControl1");
    textControl1.PlaceholderText = "Enter your first name";
}
回到頁首
顯示: