WP SELECT

4D v16

WP SELECT


WP SELECT ( {* ;} wpArea {; faixaObjt}{; faixaInicio ; faixaFim} )

Parâmetro	Tipo	Descrição
*	Operador	Se especificado, wpArea é um formulário nome objeto (string). Se omitido, wpArea é um campo objeto ou variável
wpArea	String, Objeto	Nome de objeto de formulário (se * for especificado) ou 4D Write Pro variável objeto ou campo (se * for omitido)
faixaObjt	Objeto	FAixa do objeto a aplicar para criar uma seleção
faixaInicio	Inteiro longo	Início offset da faixa de texto
faixaFim	Inteiro longo	Final offset da faixa de texto

Descrição

O novo comando WP SELECT cria uma nova seleção de texto na área 4D Write Pro wpArea, baseado na faixaObj de um nova faixa definida por faixaInicio e faixaFinal.

Se passar o parâmetro opcional *, indica que wpArea é um nome de objeto de formulário (string). Se não passar este parâmetro, indica que wpArea é um campo objeto ou variável 4D Write Pro. Se houver uma área 4D Write Pro se passa no parâmetro wpArea, o comando não faz nada.

Para definir a faixa de seleção, pode passar uma faixa objeto existente em faixaObj, ou passar um par de limites faixaInicio / faixaFinal:

Primeira sintaxe: WP SELECT({* ;} wpArea ; faixaObj)
Um faixaObj é uma parte de um documento 4D Write Pro; que pode ser criado por distintos comandos: como WP Get range, , WP GET PARAGRAPHS, ou WP GET PICTURES.

Segunda sintaxe: WP SELECT({* ;} wpArea ; faixaInicio ; faixaFinal)
Neste caso em faixaInicio e faixaFinal passe os valores correspondentes a posição dos primeiros e últimos caracteres a selecionar no documento. Pode passar wk start text em faixaInicio para definir o começo do documento e wk end text em faixaFinal para definir o final do documento. Lembre que um documento 4D Write Pro não só contém texto visível mas também las etiquetas de formato incluidas na faixa.

Exemplo

O código abaixo:

 $range2:=WP Get range([SAMPLE]WP;wk start text;12)

 WP SELECT(*;"WParea";$range2)

... terá o mesmo resultado que:

WP SELECT(*;"WParea";wk start text;12)

Ver também

WP Get range