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
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)