Saltar para o conteúdo principal
Versão: Próximo

ST INSERT URL

ST INSERT URL ( {* ;} objeto ; textoURL ; enderecoURL {; inicioSel {; fimSel}} )

ParâmetroTipoDescrição
*OperadorSe especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é um campo ou uma variável
objetoanyNome de objeto (se * for especificado) ou
Campo ou variável (se * for omitido)
textoURLTextTexto visível do URL
enderecoURLTextEndereço do URL
inicioSelIntegerInicio da seleção
fimSelIntegerFim da seleção

Esse comando não é seguro para thread e não pode ser usado em código adequado.

Descrição

O comando ST INSERT URL insere um link URL no campo ou a variável de texto com estilo designada pelo parâmetro objeto .

Se passar o parâmetro opcional * indica que o parâmetro objeto é um nome de objeto (cadeia). Se omitir o parâmetro *, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, se passar uma referência de campo ou variável (variável ou campo objeto unicamente).

No parâmetro textoURL, passe o texto visível do URL, como deve aparecer no objeto. Por exemplo, podem ser usadas etiquetas de texto como "Web Site 4D" ou "Siga este link para obter mais informação." Também pode utilizar o endereço mesmo, por exemplo "http://www.4d.com".

No parâmetro enderecoURL, passe o endereço completa a qual deseja conectar a página do navegador, por exemplo "http://www.4D.com".

Os parámetros opcionais inicioSel e fimSel designam uma seleção de texto em objeto. Os valores inicioSel e fimSel expressam uma seleção de texto plano, sem ter em conta etiquetas de estilo que podem estar presentes no texto.

  • Se passar inicioSel, textoURL é inserido na localização especificada.
  • Se omitir inicioSel e fimSel, textoURL é inserido na localização do cursor.
  • Se passar inicioSel e fimSel, ST INSERT URL substitui o texto nesta seleção por textoURL. Se o valor de fimSel é maior que o número total de caracteres no objeto, todos os caracteres entre inicioSel e o final do texto são substituídos por textoURL.

4D oferece constantes pré definidas para que possa designar automaticamente os limites de seleção nos parâmetros inicioSel e fimSel. Estas constantes se encontram no tema "Texto multi estilo":

ConstanteTipoValorComentário
ST End highlightInteiro longo-1001Designa o último caractere da seleção atual de texto no objeto (*)
ST End textInteiro longo0Designa o último caractere do texto contido no objeto
ST Start highlightInteiro longo-1000Designa o primeiro caractere da seleção atual de texto no objeto (*)
ST Start textInteiro longo1Designa o primeiro caractere do texto contido no objeto

(*) Deve passar um nome de objeto em objeto para poder utilizar esta constante. Se passar uma referência a um campo ou variável, o comando se aplica a todo o texto do objeto.

Nota: se inicioSel é maior que fimSel (exceto quando fimSel é 0) , o comando não faz nada e a variável OK toma o valor 0.

Uma vez inserido o link, é ativo: o uso de Ctrl+clique (Windows) ou Comando+clique (OS X) abre uma página do navegador por padrão no endereço especificado no parâmetro enderecoURL.

Exemplo

Você deseja inserir um link ao web site de 4D para substituir o texto selecionado no objeto:

 vTitle:="4D Web Site"
 vURL:="http://www.4d.com/"
 ST INSERT URL(*;"myText";vTitle;vURL;ST Start highlight;ST End highlight)

Ver também

ST GET URL
ST INSERT EXPRESSION