4D v16
Acceder a contenidos de documentos por programación
- Referencia 4D Write Pro
-
- Lenguaje 4D Write Pro
-
- Objetos 4D Write Pro
- Utilizar los comandos del tema Objeto (Formularios)
- Utilizar los comandos del tema Texto con estilo
- Acceder a contenidos de documentos por programación
- Constantes 4D Write Pro
- WP SET ATTRIBUTES
- WP CREATE BOOKMARKNew
- WP DELETE BOOKMARKNew
- WP EXPORT DOCUMENT
- WP EXPORT VARIABLE
- WP GET ATTRIBUTES
- WP Get bookmark rangeNew
- WP GET BOOKMARKSNew
- WP Get page countNew
- WP Get paragraphs
- WP Get pictures
- WP Get range
- WP Get selection
- WP Import document
- WP INSERT BREAKNew
- WP INSERT DOCUMENTNew
- WP INSERT PICTURENew
- WP Is font style supported
- WP NewUpd
- WP PRINTUpd
- WP RESET ATTRIBUTES
- WP SELECT
- WP USE PAGE SETUP
- Atributos 4D Write Pro
Acceder a contenidos de documentos por programación
4D Write Pro ofrece un conjunto completo de comandos que permiten modificar los atributos de texto e imagen en sus documentos. Gracias a estas funcionalidades, los desarrolladores 4D pueden diseñar sus propias interfaces de usuario (utilizando botones, menús, casillas de verificación, etc.) para documentos 4D Write Pro. Los comandos se pueden aplicar a documentos completos o a partes específicas (rangos), ya sea basado en las selecciones del usuario o valores personalizados. Las propiedades disponibles incluyen unidades, márgenes, rellenos, fondo, configuración de párrafo, colores, fuentes, estilos de fuente, así como también propiedades de imagen del documento.
Por ejemplo, el objeto de la librería Área 4D Write Pro hace un amplio uso de estas funcionalidades para ofrecer una interfaz 4D Write Pro sofisticada:
Varios comandos están dedicados a la gestión de las selecciones en los documentos. Dado que el texto seleccionado puede contener etiquetas (invisibles) de formato, 4D Write Pro trabaja con objetos llamados rangos. Un rango es un objeto que representa una porción de un documento 4D Write.
- WP Get range( wpArea ; inicioRango ; finRango ) -> objRango: devuelve un nuevo rango correspondiente a los límites que pasan como parámetros.
- ( {*;} wpArea ) -> objRango: devuelve un nuevo rango que corresponde a la selección usuario actual.
- WP Get pictures( objRango ) -> objRango: devuelve un nuevo rango que contiene sólo las imágenes.
- WP Get paragraphs( objRango ) -> objRango: devuelve un nuevo rango que contiene sólo los párrafos.
- WP SELECT( {*;} wpArea {; objRango}{; inicioRango ; finRango } ): selecciona el texto correspondiente al rango.
4D Write Pro le permite crear y trabajar con referencias dinámicas para intervalos, llamados marcadores. Un marcador es una referencia con nombre asociada a un rango específico en un documento 4D Write Pro.
Los marcadores son dinámicos, lo que significa que si el usuario mueve, añade o elimina del texto el marcador, el rango asociado se actualizará automáticamente y el marcador seguirá haciendo referencia al mismo contenido dentro del documento. Por ejemplo:
- Se crea un marcador llamado "MyBM" que hace referencia al texto "Hola mundo" en la página 20 del documento.
- Luego, inserta 50 páginas al principio del documento.
- Usted aún podrá acceder automáticamente al mismo texto "Hola mundo", ahora en la página 70 del documento, mediante el marcador "MyBM".
Un documento puede contener un número ilimitado de marcadores. Varios marcadores pueden hacer referencia al mismo rango, y los rangos de marcadores pueden ser intercalados. Sin embargo, cada nombre de marcador debe ser único en el documento. Los marcadores no se importan cuando se utiliza el comando MissingRef o WP New (los marcadores en el documento de destino no pueden ser sobrescritos).
Una vez creado, un marcador se almacena dentro del documento. Se guarda con el documento y puede ser manejado por diferentes comandos. También se puede utilizar para hacer referencia a partes de un documento plantilla. Estas piezas pueden ensamblarse de forma automática con los datos de la base para producir documentos de salida dinámicos tales como facturas o catálogos.
Varios comandos permiten crear, eliminar y utilizar marcadores:
- WP CREATE BOOKMARK para crear un nuevo marcador de un rango,
- para obtener todos los marcadores definidos en un documento,
- WP Get bookmark range para recuperar un rango de un marcador existente,
- WP DELETE BOOKMARK para eliminar un marcador.
Los siguientes nuevos comandos permiten leer o definir los atributos en el documento:
- WP SET ATTRIBUTES( objRango | wpDoc ; nomAtrib ; valorAtrib {; nomAtrib2 ; valorAtrib2 ; ... ; nomAtribN ; valorAtribN} ): define uno o más pares atributo/valor en el documento o rango.
- WP GET ATTRIBUTES( objRango | wpDoc ; nomAtrib ; attribValue {; nomAtrib2 ; valorAtrib2 ; ... ; nomAtribN ; valorAtribN} ): obtiene el valor actual de los atributos en el documento o rango.
- WP RESET ATTRIBUTES( objRango ; nomAtrib {; nomAtrib 2 ; ... ;nomAtribN } ): reinicializa los valores de los atributos en el documento o rango.
Los atributos se detallan en la sección Atributos 4D Write Pro .
Este comando le permite obtener información sobre el soporte de estilo para un rango:
- WP Is font style supported ( objRango ; wpFuenteEstilo) -> true o false: le permite saber si un rango soporta un determinado estilo (útil para diseñar una interfaz).
Producto: 4D
Tema: Lenguaje 4D Write Pro
Modificado: 4D v16
Referencia 4D Write Pro ( 4D v16)
