Como desarrollador o usuario final, sabes lo prácticos que pueden ser los hipervínculos. Sin ellos, tendría que conocer la URL de cada página de Internet. Le permiten convertir su texto o imágenes en enlaces para permitir transiciones fáciles de un lugar(por ejemplo, un documento de 4D Write Pro) a otro (normalmente un sitio web).
¿Y si los enlaces pudieran ofrecer más? ¿Y si pudieran lanzar la ejecución de código 4D o simplemente mover el cursor a un área diferente en el mismo documento? ¡Pueden hacerlo!
Puedes insertar enlaces en tus documentos con el comando WP Set attribute, pero sólo URLs. ¡El nuevo comando WP SET LINK le permite establecer URLs también (más fácil), pero también le da la posibilidad de invocar un método desde su aplicación (¡con parámetros!) o apuntar a marcadores desde su documento!
CUATRO tipos de enlaces
- El primer tipo de enlace funciona de forma similar a WP Set attributes ($range;wk link url…) excepto que el parámetro es ahora un objeto en lugar de una cadena.
$link:=New object("url"; "www/4d.com") (
WP SET LINK$target;$link)
- El segundo tipo de enlace permite crear enlaces que, al ser pulsados, ejecutarán un método 4D. El método puede incluso recibir un parámetro de texto o numérico. Sólo tiene que asegurarse de que el método está configurado como » permitido » con el comando SET ALLOWED METHODS.
$link:=New object("método"; "miAlerta"; "parámetro"; "¡Hola mundo!")
WP SET LINK ($target;$link)
- El tercer tipo de enlace permite definir enlaces a documentos externos (en disco). Los documentos deben ser documentos 4D Write o 4D Write Pro para poder ser importados. Sustituirán al documento actual.
$link:=New object("url"; "HelloWorld.4WP) (
WP SET LINK$range;$link )
- El cuarto tipo de enlace es nuevo: se puede establecer un enlace a un marcador. Por supuesto, el marcador debe haber sido creado en su documento. Cuando se haga clic en el enlace, el cursor «saltará» automáticamente al marcador.
$link:=New object("bookmark"; "chapterOne") (
WP SET LINK$target;$link)
¿Se ha dado cuenta de que el primer parámetro es un objetivo? Puede ser un rango o cualquier otro objeto válido de tu documento (como un párrafo o cualquier elemento como una imagen). Esto hará que su programación sea mucho más fácil de escribir y mantener.
Ahora que los enlaces han sido establecidos, ¡vamos a obtenerlos!
Como puede adivinar, el nuevo comando WP SET LINK viene con un hermano: WP Get links.
En una sola llamada, este comando devuelve una colección de todos los enlaces de un documento. Cada enlace de esta colección es un objeto con una descripción del enlace en sus atributos.
Los atributos son:
link.url (para enlaces URL)
link .bookmark (para enlaces de marcadores)
link .method (para enlaces de métodos)
link .parameter (si lo hay)
link .range (información como.start,.end, etc.)
A continuación se muestra un IDH para demostrar todas estas posibilidades :
Se pueden encontrar más detalles en el centro de documentación.