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

DocumentBase.SelectContentControlsByTag 方法 (String)

 

傳回文件中具有特定標記 (Tag) 的所有內容控制項。

命名空間:   Microsoft.Office.Tools.Word
組件:  Microsoft.Office.Tools.Word.v4.0.Utilities (在 Microsoft.Office.Tools.Word.v4.0.Utilities.dll 中)

public ContentControls SelectContentControlsByTag(
	string tag
)

參數

tag

要傳回之內容控制項的標記。

傳回值

Type: Microsoft.Office.Interop.Word.ContentControls

ContentControls 集合,包含具有指定之標記的內容控制項。

下列程式碼範例會在此文件中加入三個段落,然後在每個新段落中各加入一個控制項:RichTextContentControlComboBoxContentControlDropDownListContentControl這個範例會設定每個控制項的 Tag 和 Title 屬性。接下來,程式碼會呼叫 SelectContentControlsByTag 方法,取得標籤值等於 Customer 之原生內容控制項的集合,然後在訊息方塊中顯示所傳回集合之各個控制項的標題。若要使用這個範例,請在文件層級專案中的 ThisDocument 類別執行。

private void ContentControlsTag()
{
    Word.Paragraph par1 = this.Paragraphs.Add(ref missing);
    Microsoft.Office.Tools.Word.RichTextContentControl richTextControl =
        this.Controls.AddRichTextContentControl(par1.Range, 
        "richTextControl");
    richTextControl.Tag = "Customer";
    richTextControl.Title = "Customer Name";

    Word.Paragraph par2 = this.Paragraphs.Add(ref missing);
    Microsoft.Office.Tools.Word.ComboBoxContentControl comboBoxControl =
        this.Controls.AddComboBoxContentControl(par2.Range, 
        "comboBoxControl");
    comboBoxControl.Tag = "Customer";
    comboBoxControl.Title = "Customer Title";

    Word.Paragraph par3 = this.Paragraphs.Add(ref missing);
    Microsoft.Office.Tools.Word.DropDownListContentControl 
        dropDownListControl = this.Controls.AddDropDownListContentControl(
        par3.Range, "dropDownListControl");
    dropDownListControl.Tag = "Products";
    dropDownListControl.Title = "List of Products";

    Word.ContentControls relatedControls = 
        this.SelectContentControlsByTag("Customer");
    MessageBox.Show("Displaying all controls with a Tag value of" + 
        " 'Customer'. Click OK to continue.");
    foreach (Word.ContentControl ctrl in relatedControls)
    {
        MessageBox.Show("Control title: " + ctrl.Title);
    }
}
回到頁首
顯示: