4D Write Pro ¡sigue ofreciendo más y más capacidades de programación! Digamos que quieres cambiar mediante programación el estilo de una tabla, párrafo o imagen en un documento existente de 4D Write Pro. Con 4D v17, ¡es posible! Ahora puede acceder a cualquier elemento o parte de un documento, mediante programación. Estas partes, llamadas elementos, serán devueltas como una colección gracias a la función WP Get elements o como un solo elemento con la función WP Get element by ID función.
colección de elementos
El comando WP Get elements devuelve una colección de elementos de cualquier tipo (párrafos, tablas, imágenes, etc. Si se pasa un rango o una referencia de tipo, el comando devuelve una colección que contiene sólo elementos del tipo correspondiente (a menos que se especifique en el segundo parámetro). En caso contrario, el comando devuelve una colección que contiene todos los elementos disponibles, sin importar su tipo.
Por ejemplo:
- Si el primer parámetro es un rango de un tipo específico (un rango de párrafos, por ejemplo), entonces los elementos devueltos serán también párrafos.
- Si el primer parámetro no es específico (un documento completo o un rango heterogéneo) entonces los elementos devueltos pueden ser filtrados con un parámetro final (opcional).
// Returns all elements of the document
$allElements:=WP Get elements(wpDoc)
// Returns all table elements of the document
$allTables :=WP Get elements(wpDoc;wk type table)
// Returns all paragraphs of the range
$paragraphCol :=WP Get elements($paragraphRange)
// Returns all paragraphs of the table range
$paragraphCol:=WP Get elements($tableRange;wk type paragraph)
// Returns all the tables of the given range
$someTableCol:=WP Get elements($customRange;wk type table)
Una vez creada, la colección puede ser analizada. Cada elemento es un objeto que puede utilizarse como parámetro del comando, WP SET ATTRIBUTES.
Elemento único
El comando WP Get element by ID permite acceder a un solo elemento. En los documentos de 4D Write Pro, algunos elementos tienen IDs por defecto (como las imágenes y las tablas). Cuando existen, estos IDs pueden ser modificados, y cuando no existen, pueden ser creados. Sabiendo esto, el comportamiento del comando es bastante fácil de entender, ¡devuelve un único elemento para un ID dado!
Una vez obtenido el elemento, puede manipularlo como se muestra a continuación:
$element:=WP Get element by ID(myDoc; "Tabla1"))
WP SET ATTRIBUTES ($element;wk border style;wk solid)
WP SET ATTRIBUTES ($element;wk border width; "4px")
WP SET ATTRIBUTES ($element;wk border color; "azul"