Ligações em documentos 4D Write Pro

Como programador ou utilizador final, sabe como as hiperligações podem ser convenientes. Sem eles, seria necessário conhecer o URL de cada página na Internet! Eles permitem-lhe transformar o seu texto ou imagens em links para permitir transições fáceis de um local(por exemplo, um documento 4D Write Pro) para outro (tipicamente um website).

E se as hiperligações pudessem oferecer mais? E se pudessem lançar a execução de código 4D ou simplesmente mover o cursor para uma área diferente no mesmo documento? Eles podem!

Podem inserir ligações nos seus documentos com o comando WP Set attribute, mas apenas URLs. O novo comando WP SET LINK também lhe permite definir URLs (mais fácil), mas também lhe dá a possibilidade de invocar um método da sua aplicação (com parâmetros!) ou marcadores de destino do seu documento!

QUATRO tipos de ligações

• Os primeiros tipos de ligação funcionam de forma semelhante a WP Set attributes ($range;wk link url…) excepto que o parâmetro é agora um objecto em vez de uma corda.

$link:=New object("url"; "www/4d.com")
WP SET LINK ($target;$link)

• O segundo tipo de ligação permite criar ligações que, quando clicadas, executarão um Método 4D. O método pode mesmo receber um texto ou um parâmetro numérico. Basta ter a certeza que o método é definido como “permitido” com o comando SET ALLOWED METHODS.

$link:=New object("método"; "myAlert"; "parâmetro"; "Hello world!")
WP SET LINK ($target;$link)

• O terceiro tipo de ligação permite definir ligações a documentos externos (em disco). Os documentos devem ser documentos 4D Write ou 4D Write Pro para poderem ser importados. Eles substituirão o documento actual.

$link:=New object("url"; "HelloWorld.4WP")
WP SET LINK ($range;$link)

• O quarto tipo de ligação é novo: Uma ligação pode ser definida para um marcador de página. É claro que o marcador de página já deve ter sido criado no seu documento. Quando a ligação é clicada, o cursor “saltará” automaticamente para o marcador de página!

$link:=New object("bookmark"; "capítulo Um")
WP SET LINK ($target;$link)

Já reparou que o primeiro parâmetro é um alvo? Pode ser um intervalo ou qualquer outro objecto válido do seu documento (como um parágrafo ou qualquer elemento como uma fotografia). Isto tornará a sua programação muito mais fácil de escrever e manter!

Agora que as ligações foram estabelecidas, vamos obtê-las!

Como pode adivinhar, o novo comando WP SET LINK vem com um irmão: WP Get links.

Numa única chamada, este comando devolve uma colecção de todas as ligações de um documento. Cada ligação desta colecção é um objecto com uma descrição da ligação nos seus atributos.

Os atributos são:

link.url (para ligações URL)
link .bookmark (para ligações de marcadores de páginas)
link .method (para ligações de método)
link .parameter (se houver)
link .range (informações tais como.start, .end, etc.)

Abaixo está um IDH para demonstrar todas estas possibilidades :

Exemplo de base de dados

Mais detalhes podem ser encontrados no centro doc