WP Get subsection

4D v20 R7

WP Get subsection


WP Get subsection ( targetObj ) \| (wpSection ; subSectionType ) -> Resultado

Parâmetro	Tipo	Descrição
targetObj	Objeto	Range ou elemento
wpSection	Objeto	Seção 4D Write Pro
subSectionType	Inteiro longo	Tipo de subseção (wk first page, wk left page, ou wk right page)
Resultado	Objeto	Subseção

Descrição

O comando WP Get subsection devolve uma primeira subseção intersectada pela range ou elemento targetObj, ou à subseção especificada subSectionType da seção wpSection.

Com a primeira sintaxe (utilizando o parâmetro targetObj), o comando devolve a primeira subseção que intersecta a range ou o elemento. Se nenhuma subseção intersecta a range ou o elemento, se devolve um objeto null, pode passar em targetObj:
- uma range, ou
- uma referência de elemento (tabela / fila / parágrafo / corpo / cabeçalho / rodapé).
Se a range ou elemento pertencer a um cabeçalho ou rodapé, WP Get subsection retorna a subseção a qual o cabeçalho ou rodapé é anexado. Se o cabeçalho ou rodapé não for anexado a uma subseção, um objeto null é retornado.
Se a range ou elemento pertencer a uma imagem ancorada, um erro é retornado.

Com a segunda sintaxe (utilizando os parâmetros wpSection e subSectionType), o comando devolve um objeto wpSubSection (filho de wpSection) do tipo subSectionType. Passe uma das constantes abaixo no parâmetro subSectionType:

Constante	Tipo	Valor
wk first page	Inteiro longo	1
wk left page	Inteiro longo	2
wk right page	Inteiro longo	3

Se não for definido subSectionType para a wpSection especificada, o comando devolve um objeto indefinido (não é devolvido nenhum erro).

Exemplo

Se quiser aplicar um fundo azul nas páginas da esquerda:

 C_OBJECT($section;$subsection)

  //Recupera a referência na primeira seção

 $section:=WP Get section(wpDoc;1)

  //Recupera a referência na subseção esquerda da primeira seção

 $subsection:=WP Get subsection($section;wk left page)

 

  //Se a subseção existir, configure o fundo em azul

 If($subsection#Null)

    WP SET ATTRIBUTES($subsection;wk background color;"#87CEEB")

 Else

    ALERT("Por favor, crie subseções esquerda e direita")

 End if

Ver também

WP DELETE SUBSECTION
WP Get section
WP New subsection