Trabajar con SDT de control de contenido
En Microsoft Word, puede crear un formulario comenzando con una plantilla y agregando controles de contenido, incluidas casillas de verificación, cuadros de texto, selectores de fechas y listas desplegables. En Aspose.Words, una etiqueta de documento estructurado o un control de contenido de cualquier documento cargado en Aspose.Words se importa como un nodo StructuredDocumentTag. Las etiquetas de documentos estructuradas (SDT o control de contenido) permiten incorporar en un documento la semántica definida por el cliente, así como su comportamiento y apariencia. StructuredDocumentTag puede aparecer en un documento en los siguientes lugares:
- Nivel de bloque: entre párrafos y tablas, como hijo de un nodo Body, HeaderFooter, Comment, Footnote o Shape
- Nivel de fila: entre filas de una tabla, como hijo de un nodo Table
- Nivel de celda: entre celdas de una fila de la tabla, como elemento secundario de un nodo Row
- Nivel en línea: entre el contenido en línea interno, como hijo de un Paragraph
- Anidado dentro de otro StructuredDocumentTag
Insertar controles de contenido en un documento
En esta versión de Aspose.Words se pueden crear los siguientes tipos de SDT o control de contenido:
- Casilla de verificación
- La lista desplegable
- Caja combo
- Fecha
- Galería de bloques de construcción
- Grupo
- Imagen
- Texto rico
- Texto sin formato
El siguiente ejemplo de código demuestra cómo crear un control de contenido de tipo casilla de verificación.
El siguiente ejemplo de código demuestra cómo crear un control de contenido de tipo cuadro de texto enriquecido.
El siguiente ejemplo de código demuestra cómo crear un control de contenido del tipo cuadro combinado.
Cómo actualizar los controles de contenido
Esta sección explica cómo actualizar los valores de SDT o control de contenido mediante programación.
El siguiente ejemplo de código muestra cómo establecer el estado actual de la casilla de verificación:
El siguiente ejemplo de código muestra cómo modificar controles de contenido de tipo cuadro de texto sin formato, lista desplegable e imagen:
Vincular el control de contenido a partes XML personalizadas
Puede vincular controles de contenido con datos XML (parte XML personalizada) en documentos de Word.
El siguiente ejemplo de código muestra cómo vincular el control de contenido a partes XML personalizadas:
Mapeo XML del rango de etiquetas de documentos estructurados
Puede obtener la asignación de este rango de etiquetas de documento estructurado a datos XML en una parte XML personalizada del documento actual utilizando la propiedad StructuredDocumentTagRangeStart.xml_mapping. Sin embargo, el método set_mapping se puede utilizar para asignar un rango de etiquetas de documento estructurado a datos XML.
El siguiente ejemplo de código muestra cómo configurar la asignación XML:
Borrar el contenido de un control de contenido
Puede borrar el contenido de un control de contenido mostrando un marcador de posición. El método StructuredDocumentTag.clear borra el contenido de esta etiqueta de documento estructurado y muestra un marcador de posición si está definido. Sin embargo, no es posible borrar el contenido de un control de contenido si tiene revisiones. Si un control de contenido no tiene marcador de posición, se insertan cinco espacios como en MS Word (excepto secciones repetidas, elementos de sección repetidos, grupos, casillas de verificación y citas). Si un control de contenido se asigna a XML personalizado, el nodo XML al que se hace referencia se borra.
El siguiente ejemplo de código muestra cómo borrar el contenido del control de contenido:
Cambiar el fondo del control de contenido y los colores del borde
La propiedad StructuredDocumentTag.color le permite obtener o establecer el color del control de contenido. El color afecta el control de contenido en dos situaciones:
- MS Word resalta el fondo del control de contenido cuando el mouse se mueve sobre el control de contenido. Esto ayuda a identificar el control de contenido. El color del resaltado es un poco más “suave” que el color. Por ejemplo, MS Word resalta el fondo con color rosa, cuando color es rojo.
- Cuando interactúa (edición, selección, etc.) con el control de contenido, el borde del control de contenido se colorea con el color.
El siguiente ejemplo de código muestra cómo cambiar el color del control de contenido:
Cómo configurar el estilo para dar formato al texto escrito en el control de contenido
Si desea establecer el estilo de control de contenido, puede utilizar las propiedades StructuredDocumentTag.style o StructuredDocumentTag.style_name. Cuando escribe el texto en el control de contenido del documento de salida, el texto escrito tendrá el estilo “Cita”.
El siguiente ejemplo de código muestra cómo configurar el estilo de control de contenido:
Trabajar con control de contenido de sección repetida
El control de contenido de la sección repetida permite repetir el contenido contenido en ella. Con Aspose.Words, se pueden crear los nodos de etiquetas de documentos estructurados de la sección repetida y los tipos de elementos de sección repetida y, para este propósito, el tipo de enumeración SdtType proporciona propiedad REPEATING_SECTION_ITEM.
El siguiente ejemplo de código muestra cómo vincular un control de contenido de sección repetida a una tabla: