Skip to main content
Version: 20 R7 BETA

WP Get links

WP Get links ( targetObj ) -> Function result

ParameterTypeDescription
targetObjObjectRange or element or 4D Write Pro document
Function resultCollectionCollection of links

Description

The WP Get links command returns the collection of all links defined in targetObj.

In the targetObj parameter, you can pass:

  • a range, or
  • an element (table / row / paragraph / body / header / footer / section / subsection / text box), or
  • a 4D Write Pro document

Returned value

WP Get links returns a collection of link objects, each of them containing one or more of the following properties:

PropertyTypeDescriptionAvailable for
[ ].urlTextLink's target contentsurl links
[ ].methodTextLink's method namemethod links
[ ].parameterText | NumberUser parameter value passed to the linkmethod links (if used)
[ ].bookmarkTextBookmark name for the linkbookmark links
[ ].rangeObjectRange of the link's label. See Range handling commandsall links

Example

You want to change the color of all url link labels in a 4D Write Pro document:

 var $links : Collection
 var $link : Object
 
 $links:=WP Get links(myDoc)
 
 For each($link;$links)
    If($link.url#Null) //it's a url link
       WP SET ATTRIBUTES($link.range;wk text color;"red")
    End if
 End for each

See also

Blog: Links in 4D Write Pro documents
WP Get formulas
WP SET LINK