WP SET TEXT

4D v17

WP SET TEXT


WP SET TEXT ( wpRange ; novoTexto ; posiçaoTexto {; alcanceRange} )

Parâmetro	Tipo	Descrição
wpRange	Objeto	Objeto Range
novoTexto	Texto	Texto a inserir
posiçaoTexto	Número	Inserir posição (substituir, antes, depois)
alcanceRange	Número	Inclui ou exclui o conteúdo inserido dentro da range

Descrição

O comando WP SET TEXT insere o texto passado no parâmetro novoTexto como texto sem formato em um documento 4D Write Pro em uma posição específica designada pelos parâmetros wpRango e posiçãoTexto.

No parâmetro wpRange, passe um objeto range para designar a posção onde vai inserir o texto. A faixa range pode ser um local explícito no documento 4D Write Pro ou podem se basear na seleção de um usuário.

O parâmetro novoTexto contém o texto a inserir dentro de wpRange. WP SET TEXT insere só texto sem formato, exatamente como está escrito, mas sem etiquetas de estilo.

No parâmetro posicaoTexto, o local de texto inserido pode ser especificado passando um dos seletores abaixo:

Constante	Comentário
wk append	Insere conteúdos ao final da faixa e atualiza a faixa para conter tanto os conteúdos anteriores quanto os inseridos.
wk prepend	Conteúdos inseridos no início da faixa e atualiza a faixa para conter os conteúdos anteriores e os inseridos
wk replace	Substituir e atualizar conteúdos da faixa; a nova faixa contèm os conteúdos inseridos.

O parâmetro opcional alcanceRange permite a inclusão ou exclusão do texto inserido em wpRango depois da execução de WP SET TEXT ao passar um dos seletores abaixo:

Constante	Comentário
wk exclude from range	Insere conteùdos ao fim da faixa e atualiza a faixa para menter apenas conteúdos anteriores.
wk include in range	Insere conteúdos ao início da faixa e atualiza a faixa para manter apenas conteúdos anteriores

Exemplo

Se quiser agregar texto a este documento:

Antes do texto existente:

 $range:=WP Create range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk prepend)

  //escreve " Hello world! The quick brown fox jumps over the lazy dog."

Depois do texto existente:

 $range:=WP Create range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk append)

  //escreve "The quick brown fox jumps over the lazy dog. Hello world!"

Substitui o texto existente:

 $range:=WP Create range(myDoc;wk start text;wk end text)

 WP SET TEXT($range;" Hello world!";wk replace)

  //escreve " Hello world!"

Ver também

WP Get text