ControlCollection.AddContentControl メソッド (ContentControl, String)

[アーティクル]
08/09/2011

文書内のネイティブなコンテンツコントロールに基づく新しい ContentControl を追加します。

名前空間: Microsoft.Office.Tools.Word
アセンブリ: Microsoft.Office.Tools.Word (Microsoft.Office.Tools.Word.dll 内)

構文

'宣言
Function AddContentControl ( _
    contentControl As ContentControl, _
    name As String _
) As ContentControl

ContentControl AddContentControl(
    ContentControl contentControl,
    string name
)

パラメーター

contentControl
型: Microsoft.Office.Interop.Word.ContentControl
新しいコントロールの基礎となる Microsoft.Office.Interop.Word.ContentControl。

name
型: System.String
新しいコントロール名。

戻り値

型: Microsoft.Office.Tools.Word.ContentControl
文書に追加された ContentControl。

例外

例外	条件
ArgumentNullException	contentControl は nullnull 参照 (Visual Basic では Nothing) なので、または name が nullnull 参照 (Visual Basic では Nothing) であるか、または長さが 0 である場合。
ControlNameAlreadyExistsException	同じ名前のコントロールが既に ControlCollection に存在する場合。
ArgumentException	contentControl は文書パーツギャラリーではありません (contentControl の Microsoft.Office.Interop.Word.ContentControl.Type プロパティに値 Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText が設定されていません)。

ArgumentNullException

contentControl は nullnull 参照 (Visual Basic では Nothing) なので、

または

name が nullnull 参照 (Visual Basic では Nothing) であるか、または長さが 0 である場合。

ControlNameAlreadyExistsException

同じ名前のコントロールが既に ControlCollection に存在する場合。

ArgumentException

contentControl は文書パーツギャラリーではありません (contentControl の Microsoft.Office.Interop.Word.ContentControl.Type プロパティに値 Microsoft.Office.Interop.Word.WdContentControlType.wdContentControlRichText が設定されていません)。

解説

このメソッドを使用して、実行時に文書内に既に存在するネイティブなコンテンツコントロールに基づく新しい ContentControl を追加します。これは、実行時に ContentControl を作成し、この次に文書を開くときに同じコントロールを再作成する場合に便利です。詳細については、「実行時の Office ドキュメントへのコントロールの追加」を参照してください。