WP SELECT
WP SELECT ( {{* ;} wpArea;} {wpArea} {; 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 | Text, Object | → | Nome de objeto formulário (se * for especificado) ou objeto variável ou campo 4D Write Pro (se * for omitido) |
| wpArea | Object | → | Nome de objeto de formulário (se * for especificado) ou 4D Write Pro variável objeto ou campo (se * for omitido) |
| faixaInicio | Integer | → | Início offset da faixa de texto |
| faixaFim | Integer | → | Final offset da faixa de texto |
Esse comando não é seguro para thread e não pode ser usado em código adequado.
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.
Nota: este comando só pode ser utilizada se wpArea estiver associada com um objeto de formulário (ou seja, se mostra no formulário).
Para definir a faixa de seleção, pode passar uma faixa objeto existente em faixaObj, ou passar um par de limites faixaInicio / faixaFinal:
- WP SELECT({* ;} wpArea ; faixaObj)
Um faixaObj pode ser: - uma faixa, ou
- uma referência de elemento (tabela / fila / parágrafo / imagem ancorada ou em linha / cabeçalho / rodapé/seção/subseção) ou
- um documento 4D Write Pro (só o elemento corpo utilizado)
- WP SELECT({* ;} wpArea ; startRange ; endRange)
WP SELECT( alvoObj {; startRange ; endRange} )
- onde alvoObj pode ser:
- uma range (faixa ou seleção de objetos), ou
- uma referência de elemento (tabela/linha/parágrafo/imagem ancorada ou inline/corpo/cabeçalho/rodapé/seção/subseção)
- onde faixaInicio e faixaFinal estão permitidas para as referências de elemento a seguir: corpo/cabeçalho/rodapé/seção/subseção.
- 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 range
Exemplo
O código abaixo:
$range:=WP Text range([SAMPLE]WP;wk start text;12)
WP SELECT(*;"WParea";$range)
... terá o mesmo resultado que:
WP SELECT(*;"WParea";wk start text;12)