WP GET ATTRIBUTES

Home

4D v20

WP GET ATTRIBUTES


WP GET ATTRIBUTES ( targetObj ; attribName ; attribValue {; attribName2 ; attribValue2 ; ... ; attribNameN ; attribValueN} )

Parameter	Type	Description
targetObj	Object	Range or element or 4D Write Pro document
attribName	Text	Name of attribute to get
attribValue	Text, Number, Array, Collection, Picture, Date	Current value of attribute for the target

Description

The WP GET ATTRIBUTES command returns the value of any attribute in a 4D Write Pro range, header, body, footer, table, or document. This command gives you access to any kind of 4D Write Pro internal attributes: character, paragraph, document, table, or image.

In targetObj, you can pass:

a range, or
an element (header / footer / body / table / paragraph / anchored or inline picture / section / subsection / style sheet), or
a 4D Write Pro document

For a comprehensive list of attributes to pass in attribName, as well as their scope and values, please refer to the 4D Write Pro Attributes section.

If there are different values for the same attribute in the element passed as a parameter, the command returns:

for numerical values, wk mixed
for an array, an empty array (tab stops, color if attribValue is defined as array), with an exception for wk text shadow offset for which the array value will always contain 2 entries which may be set separately to wk mixed if either horizontal offset or vertical offset (or both) are mixed.
for string values, an empty string
for picture values, an empty picture.

Note: If targetObj contains a paragraph and a character style sheets, the paragraph style sheet name is returned.

Example

You want to get the background color of the selected area:

 $range:=WP Selection range(*;"WParea")

 WP GET ATTRIBUTES($range;wk background color;$bcol)