WP GET ATTRIBUTES

Home

4D v17

WP GET ATTRIBUTES


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

Parameter	Type	Description
targetObj	Object	Range or element reference or 4D Write Pro document
attribName	Text	Name of attribute to get
attribValue	Text, Number, Longint array, Real array, 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 reference, 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 reference (header / footer / body / table / paragraph / anchored or inline picture), 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.

Example

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

 $range:=WP Get selection(*;"WParea")

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