WP DELETE SECTION

4D v20 R7

WP DELETE SECTION


WP DELETE SECTION ( wpDoc ; indexNumber {; count} )

Parâmetro	Tipo	Descrição
wpDoc	Objeto	documento 4D Write Pro
indexNumber	Inteiro	Indice da seção a ser apagada
count	Inteiro	Número de seções a apagar


WP DELETE SECTION ( section )

Parâmetro	Tipo	Descrição
section	Objeto	seção 4D Write Pro

Descrição

O comando WP DELETE SECTION elimina o objeto seccion passado ou elimina uma ou mais seções começando por numIndex e dependendo do contar passado. Quando se elimina uma seção, também é eliminado tudo associado com ela, incluindo o cabeçalho, o rodapé, a parte do corpo, as imagens ancoradas, as caixas de texto e as quebras de seção final (seja uma quebra de seção ou quebra de seção contínua).

Um erro é produzido se o comando WP DELETE SECTION solicita eliminar todas as seções ou se o documento só contiver uma seção.

WP DELETE SECTION volta a indexar o atributo anchorSection das caixas de texto e as imagens para ajustas a ancoragem a suas seções após os câmbios. Por exemplo, se um documento tiver quatro seções e for eliminada a segunda, as seções 3 e 4 passarão a ser as seções 2 e 3 e as caixas de texto e as imagens que antes estavam ancoradas às seções 3 e 4 passarão a estar nas seções 2 e 3.

Nota: se uma imagem ou caixa de texto estiver ancorada a uma página (por exemplo a página 20) e esta página já não existir depois de eliminar uma seção, a imagem (ou caixa de texto) permanecerá no documento e voltará a aparecer na página 20 se está página voltar a existir mais adiante.

Exemplo

Para remover a primeira seção do documento:

 wpDoc:=WP Import document(“test.wp”)

  // remover apenas seção 1 (sem erro a não ser que haja apenas uma seção no documento)

 WP DELETE SECTION(wpDoc;1)

Para remover seção 5 do documento:

 wpDoc:=WP Import document(“test.wp”)

  // remove só a seção 5

 WP DELETE SECTION(wpDoc;5)

Para remover as seções 5, 6 e 7 do documento:

 wpDoc:=WP Import document(“test.wp”)

 WP DELETE SECTION(wpDoc;5;3)

Para remover todas as seções a partir da seção 5:

 wpDoc:=WP Import document(“test.wp”)

  // remove todas as seções a partir da seção 5 (sem erro a não ser que a seção 5 não exista)

 WP DELETE SECTION(wpDoc;5;MAXLONG)

Pare recuperar e remover a seção 5

 wpDoc:=WP Import document(“test.wp”

  // obtém seção 5

 $section:=WP Get section(wpDoc, 5)

  // remove $section

 WP DELETE SECTION($section)