WP DELETE SUBSECTION

Home

4D v20 R7


WP DELETE SUBSECTION ( wpSection ; subSectionType )

Parameter	Type	Description
wpSection	Object	4D Write Pro section
subSectionType	Longint	Subsection type (wk first page, wk left page, or wk right page)


WP DELETE SUBSECTION ( subSection )

Parameter	Type	Description
subSection	Object	4D Write Pro subsection

Description

The WP DELETE SUBSECTION command removes the subSectionType subsection elements from the wpSection 4D Write Pro section, or it directly removes the passed subSection. Subsection elements include headers, footers, columns, anchored pictures, etc. (see Defining a section). Note that the body of the document is left untouched.

In wpSection, pass the section from which you want to remove the subsection elements. The section can be obtained using the WP Get sections or WP Get section commands.

The subSectionType parameter specifes the subsection to delete. You can pass one of the following constants:

Constant	Type	Value
wk first page	Longint	1
wk left page	Longint	2
wk right page	Longint	3

Note: Deleting a left page or right page subsection will automatically delete the opposite subsection. For example, if you delete a right page subsection, the left page subsection is automatically deleted.

If the subSectionType does not exist, the command does nothing (no error is generated).

Note: When a subsection is deleted, the header and footer are removed, as well as anchored pictures and textboxes but the body remains untouched.

Example 1

You want to delete the first page subsection of the first section:

 C_OBJECT($section;$subsection)

  // get first section

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

  // Delete the subsection

 WP DELETE SUBSECTION($section;wk first page)

Example 2

You want to delete the right page subsection of section 3:

 $subSection:=WP Get subsection(WP Get section($document;3);wk right page)

 WP DELETE SUBSECTION($subSection)