WP Get section

4D v20

WP Get section


WP Get section ( targetObj ) \| (wpDoc ; indiceSeccion ) -> Resultado

Parámetro	Tipo	Descripción
targetObj	Objeto	Rango o elemento
wpDoc	Objeto	Documento 4D Write Pro
indiceSeccion	Entero largo	Índice de sección
Resultado	Objeto	Sección 4D Write Pro

Descripción

El comando WP Get section devuelve la primera sección intersectada por el rango targetObj o elemento, o al indiceSeccion especificado del documento wpDoc.

Con la primera sintaxis (utilizando el parámetro targetObj), el comando devuelve la primera sección intersectada por el rango o el elemento. Puedes pasar en targetObj:
- un rango, o
- un elemento (tabla / fila / párrafo / cuerpo / caja de texto / encabezado / pie de página). No puede pasar una subsección, ni una imagen anclada (se devuelve un error en este caso).

Si el rango o elemento pertenece a un encabezado o a un pie de página, WP Get section devuelve la sección a la que está conectado el encabezado o pie de página. Si el rango o elemento es o pertenece a una caja de texto, WP Get section siempre devuelve la primera sección, excepto si está anclado a una sección (en cuyo caso se devuelve la sección).

Con la segunda sintaxis (utilizando el parámetro wpDoc), el comando devuelve la sección correspondiente a la sección indiceSeccion (el valor de indiceSeccion debe ser >=1).
Si no se define ninguna sección para el indiceSeccion especificado, el comando devuelve un objeto indefinido (no se devuelve ningún error).

Nota: utilice el comando WP Get subsection para obtener una subsección de una sección o de un rango.

Ejemplo

Desea obtener la referencia de la primera sección:

 C_OBJECT($section)

  // obtiene la primera sección

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

Ver también

WP Get sections
WP Get subsection