Partager via

ControlCollection.AddContentControl Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Office.Tools.Word
Assemblys:
Microsoft.Office.Tools.Word.dll, Microsoft.Office.Tools.Word.v4.0.Utilities.dll

Surcharges

AddContentControl(ContentControl, String)

Ajoute un nouveau ContentControl basé sur un contrôle de contenu natif du document.
AddContentControl(String, WdContentControlType)

Ajoute un nouveau ContentControl du type spécifié à la sélection actuelle dans le document.
AddContentControl(Range, String, WdContentControlType)

Ajoute un nouveau ContentControl du type spécifié à la plage spécifiée dans le document.

AddContentControl(ContentControl, String)

Ajoute un nouveau ContentControl basé sur un contrôle de contenu natif du document.

public:
 Microsoft::Office::Tools::Word::ContentControl ^ AddContentControl(Microsoft::Office::Interop::Word::ContentControl ^ contentControl, System::String ^ name);
public Microsoft.Office.Tools.Word.ContentControl AddContentControl (Microsoft.Office.Interop.Word.ContentControl contentControl, string name);
abstract member AddContentControl : Microsoft.Office.Interop.Word.ContentControl * string -> Microsoft.Office.Tools.Word.ContentControl
Public Function AddContentControl (contentControl As ContentControl, name As String) As ContentControl

Paramètres

contentControl
ContentControl

Microsoft.Office.Interop.Word.ContentControl qui est la base du nouveau contrôle.

name
String

Nom du nouveau contrôle.

Retours

ContentControl

ContentControl qui a été ajouté au document.

Exceptions

ArgumentNullException

contentControl est null.-or- name est ou n’a null aucune longueur.

ControlNameAlreadyExistsException

Un contrôle du même nom se trouve déjà dans la ControlCollection.

ArgumentException

contentControln’est pas une galerie de blocs de construction (autrement dit, microsoft.Office.Interop.Word. La propriété ContentControl.Type de n’a contentControl pas la valeur Microsoft.Office.Interop.Word. WdContentControlType.wdContentControlRichText).

Remarques

Utilisez cette méthode pour ajouter un nouveau ContentControl qui est basé sur un contrôle de contenu natif dans le document au moment de l’exécution. Cela est utile lorsque vous créez un au moment de ContentControl l’exécution et que vous souhaitez recréer le même contrôle la prochaine fois que le document est ouvert. Pour plus d'informations, consultez Adding Controls to Office Documents at Run Time.

S’applique à

AddContentControl(String, WdContentControlType)

Ajoute un nouveau ContentControl du type spécifié à la sélection actuelle dans le document.

public:
 Microsoft::Office::Tools::Word::ContentControl ^ AddContentControl(System::String ^ name, Microsoft::Office::Interop::Word::WdContentControlType contentControlType);
public Microsoft.Office.Tools.Word.ContentControl AddContentControl (string name, Microsoft.Office.Interop.Word.WdContentControlType contentControlType);
abstract member AddContentControl : string * Microsoft.Office.Interop.Word.WdContentControlType -> Microsoft.Office.Tools.Word.ContentControl
Public Function AddContentControl (name As String, contentControlType As WdContentControlType) As ContentControl

Paramètres

name
String

Nom du nouveau contrôle.

contentControlType
WdContentControlType

Une des valeurs Microsoft.Office.Interop.Word.WdContentControlType qui spécifie le type sous-jacent du nouveau contrôle de contenu.

Retours

ContentControl

ContentControl qui a été ajouté au document.

Exceptions

ArgumentNullException

name a la valeur null ou est de longueur nulle.

ControlNameAlreadyExistsException

Un contrôle du même nom se trouve déjà dans la ControlCollection.

Remarques

Utilisez cette méthode pour ajouter un nouveau ContentControl à la sélection actuelle dans le document au moment de l’exécution. Pour plus d'informations, consultez Adding Controls to Office Documents at Run Time.

S’applique à

AddContentControl(Range, String, WdContentControlType)

Ajoute un nouveau ContentControl du type spécifié à la plage spécifiée dans le document.

public:
 Microsoft::Office::Tools::Word::ContentControl ^ AddContentControl(Microsoft::Office::Interop::Word::Range ^ range, System::String ^ name, Microsoft::Office::Interop::Word::WdContentControlType contentControlType);
public Microsoft.Office.Tools.Word.ContentControl AddContentControl (Microsoft.Office.Interop.Word.Range range, string name, Microsoft.Office.Interop.Word.WdContentControlType contentControlType);
abstract member AddContentControl : Microsoft.Office.Interop.Word.Range * string * Microsoft.Office.Interop.Word.WdContentControlType -> Microsoft.Office.Tools.Word.ContentControl
Public Function AddContentControl (range As Range, name As String, contentControlType As WdContentControlType) As ContentControl

Paramètres

range
Range

Range qui indique les limites du nouveau contrôle.

name
String

Nom du nouveau contrôle.

contentControlType
WdContentControlType

Une des valeurs Microsoft.Office.Interop.Word.WdContentControlType qui spécifie le type sous-jacent du nouveau contrôle de contenu.

Retours

ContentControl

ContentControl qui a été ajouté au document.

Exceptions

ArgumentNullException

name a la valeur null ou est de longueur nulle.

ControlNameAlreadyExistsException

Un contrôle du même nom se trouve déjà dans la ControlCollection.

Remarques

Utilisez cette méthode pour ajouter un nouveau ContentControl à une plage spécifiée dans le document au moment de l’exécution. Pour plus d'informations, consultez Adding Controls to Office Documents at Run Time.

S’applique à