ControlCollection.AddContentControl Método
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Sobrecargas
AddContentControl(ContentControl, String) |
Agrega un nuevo objeto ContentControl basado en un control de contenido nativo del documento. |
AddContentControl(String, WdContentControlType) |
Agrega un nuevo control ContentControl del tipo especificado en la selección actual del documento. |
AddContentControl(Range, String, WdContentControlType) |
Agrega un nuevo control ContentControl del tipo especificado en el intervalo establecido del documento. |
AddContentControl(ContentControl, String)
Agrega un nuevo objeto ContentControl basado en un control de contenido nativo del documento.
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
Parámetros
- contentControl
- ContentControl
El objeto Microsoft.Office.Interop.Word.ContentControl
que es la base del nuevo control.
- name
- String
El nombre del nuevo control.
Devoluciones
El objeto ContentControl que se agregó al documento.
Excepciones
contentControl
es null
.-o- name
es null
o tiene una longitud cero.
Un control con el mismo nombre ya se encuentra en el objeto ControlCollection.
contentControl
no es una galería de bloques de creación (es decir, Microsoft.Office.Interop.Word. La propiedad ContentControl.Type de contentControl
no tiene el valor Microsoft.Office.Interop.Word. WdContentControlType.wdContentControlRichText).
Comentarios
Utilice este método para agregar un nuevo ContentControl elemento basado en un control de contenido nativo en el documento en tiempo de ejecución. Esto resulta útil al crear un objeto ContentControl en tiempo de ejecución y desea volver a crear el mismo control la próxima vez que se abra el documento. Para obtener más información, consulta Adding Controls to Office Documents at Run Time.
Se aplica a
AddContentControl(String, WdContentControlType)
Agrega un nuevo control ContentControl del tipo especificado en la selección actual del documento.
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
Parámetros
- name
- String
El nombre del nuevo control.
- contentControlType
- WdContentControlType
Uno de los valores de Microsoft.Office.Interop.Word.WdContentControlType
que especifica el tipo subyacente del nuevo control de contenido.
Devoluciones
El objeto ContentControl que se agregó al documento.
Excepciones
name
es null
o tiene una longitud cero.
Un control con el mismo nombre ya se encuentra en el objeto ControlCollection.
Comentarios
Use este método para agregar un nuevo ContentControl en la selección actual del documento en tiempo de ejecución. Para obtener más información, consulta Adding Controls to Office Documents at Run Time.
Se aplica a
AddContentControl(Range, String, WdContentControlType)
Agrega un nuevo control ContentControl del tipo especificado en el intervalo establecido del documento.
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
Parámetros
- name
- String
El nombre del nuevo control.
- contentControlType
- WdContentControlType
Uno de los valores de Microsoft.Office.Interop.Word.WdContentControlType
que especifica el tipo subyacente del nuevo control de contenido.
Devoluciones
El objeto ContentControl que se agregó al documento.
Excepciones
name
es null
o tiene una longitud cero.
Un control con el mismo nombre ya se encuentra en el objeto ControlCollection.
Comentarios
Use este método para agregar un nuevo ContentControl en un intervalo especificado en el documento en tiempo de ejecución. Para obtener más información, consulta Adding Controls to Office Documents at Run Time.