DocumentBase.SelectContentControlsByTitle メソッド
指定したタイトルを持っている文書内のすべてのコンテンツ コントロールを返します。
名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word.v4.0.Utilities (Microsoft.Office.Tools.Word.v4.0.Utilities.dll 内)
構文
'宣言
Public Function SelectContentControlsByTitle ( _
title As String _
) As ContentControls
public ContentControls SelectContentControlsByTitle(
string title
)
パラメーター
- title
型 : System.String
返されるコンテンツ コントロールのタイトル。
戻り値
型 : Microsoft.Office.Interop.Word.ContentControls
指定したタイトルを持っているコンテンツ コントロールを格納する ContentControls コレクション。
例
次のコード例では、文書に 2 つの段落を追加し、新しい段落にそれぞれ 1 つのコントロール (RichTextContentControl と ComboBoxContentControl) を追加します。各コントロールに、Tag プロパティと Title プロパティを設定します。次に、SelectContentControlsByTitle メソッドを呼び出し、タイトルが Customer Title に等しいネイティブなコンテンツ コントロールのコレクションを取得します。そして、返されたコレクションの各コントロールのプレースホルダー テキストを変更します。この場合は、返されたコレクションに含まれているのは ComboBoxContentControl だけです。この例を使用するには、これをドキュメント レベルのプロジェクトの ThisDocument クラスから実行します。
Private Sub ContentControlsTitle()
Dim par1 As Word.Paragraph = Me.Paragraphs.Add()
Dim richTextControl As Microsoft.Office.Tools.Word.RichTextContentControl _
= Me.Controls.AddRichTextContentControl(par1.Range, "richTextControl")
richTextControl.Tag = "Customer"
richTextControl.Title = "Customer Name"
Dim par2 As Word.Paragraph = Me.Paragraphs.Add()
Dim comboBoxControl As Microsoft.Office.Tools.Word.ComboBoxContentControl _
= Me.Controls.AddComboBoxContentControl(par2.Range, "comboBoxControl")
comboBoxControl.Tag = "Customer"
comboBoxControl.Title = "Customer Title"
Dim myControls As Word.ContentControls = _
Me.SelectContentControlsByTitle("Customer Title")
For Each ctrl As Word.ContentControl In myControls
ctrl.SetPlaceholderText(Text:="Select a title.")
Next
End Sub
private void ContentControlsTitle()
{
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.ContentControls myControls =
this.SelectContentControlsByTitle("Customer Title");
foreach (Word.ContentControl ctrl in myControls)
{
ctrl.SetPlaceholderText(null, null, "Select a title.");
}
}
.NET Framework セキュリティ
- 直前の呼び出し元に対する完全な信頼。このメンバーは、部分的に信頼されているコードから使用することはできません。詳細については、「部分信頼コードからのライブラリの使用」を参照してください。