WP Get section

WP Get section ( alvoObj ) | (wpDoc ; índiceSeção ) -> Resultado

Parâmetro	Tipo		Descrição
alvoObj	Object	→	Range ou elemento de referência
wpDoc	Object	→	Documento 4D Write pro
índiceSeção	Integer	→	Índice da seção
Resultado	Object	←	Seção 4D Write Pro

Descrição

O comando WP Get section devolve a primeira seção intersectada pela range alvoObj ou elemento, ou ao indiceSeção especificado do documento wpDoc.

• Com a primeira sintaxe (utilizando o parâmetro alvoObj), o comando devolve a primeira seção intersectada pela range ou o elemento. Pode passar em targetObj:
  • uma range (gama ou faixa de seleção de elementos) ou
  • uma referência de elemento (tabela / fila / parágrafo / corpo / cabeçalho / rodapé). Não se pode passar uma referência de subseção, nem uma imagem ancorada (se devolve um erro nesse caso).
    Se a range ou a referência do elemento pertencer a uma caixa de texto, WP Get section sempre devolve a primeira seção, exceto se estiver ancorado a uma seção (nesse caso a seção é devolvida).
• Com a segunda sintaxe (utilizando o parâmetro wpDoc), o comando devolve a seção correspondente à seção indiceSeção (o valor de indiceSeção deve ser >=1).
  Se não for definida nenhuma seção para o indiceSeção especificado, o comando devolve um objeto indefinido (não se devolve nenhum erro).

Nota: utilize o comando WP Get subsection para obter uma subseção de uma seção ou de uma range.

Exemplo

Se quiser obtera primeira seção:

 var $section : Object
  // obtém a primeira seção
 $section:=WP Get section(wpDoc;1)

Ver também

WP Get sections
WP Get subsection