4D Doc Center : WR SELECT

Home

4D Write v14

WR SELECT


WR SELECT ( area ; type ; begin ; end )

Parameter	Type	Description
area	Longint	4D Write area
type	Integer	Type to select
begin	Longint	First character
end	Longint	Last character. Optional for certain values of type

Description

The WR SELECT command selects text defined by type, begin, and end. WR SELECT does not change the current selection if the value searched for does not exist.

Set the type parameter using one of the following constants, found in the "WR Select type" theme:

Constant	Type	Value	Comment
wr select characters	Longint	0	Selects the characters located between begin and end. In this case, this is the same as using WR SET SELECTION.
wr select expression	Longint	1	Selects the reference whose rank in the document is defined by begin. end must be omitted.
wr select paragraphs	Longint	2	Selects the paragraphs located between begin and end.
wr select ruler	Longint	3	Selects the paragraphs that use the Xth ruler (whose rank in the document starts at the beginning of the text). end must be omitted.
wr select picture	Longint	4	Selects the picture whose rank in the document is defined by begin. end must be omitted.
wr select style	Longint	5	Selects the words that use the Xth style (whose rank in the document starts at the beginning of the text). end must be omitted.
wr select word	Longint	6	Selects the word in which the insertion point is located.
wr select page break	Longint	7	Selects the page breaks whose rank in the document is defined by begin. end must be omitted.
wr select column break	Longint	8	Selects the column breaks whose rank in the document is defined by begin. end must be omitted.
wr select hyphen	Longint	9	Selects the hyphen whose rank in the document is defined by begin. end must be omitted.
wr select page number	Longint	10	Selects the page number whose rank in the document is defined by begin. end must be omitted. The selection only carries over to page numbers inserted into the body of text.
wr select date and time	Longint	11	Selects the date and time variable whose rank in the document is defined by begin. end must be omitted. The selection only carries over to the dates or times automatically updated and inserted into the body of text.
wr select hyperlink	Longint	12	Selects the hyperlink whose rank in the document is defined by begin. end must be omitted.
wr select HTML expression	Longint	13	Selects the HTML expression whose rank in the document is defined by begin. end must be omitted.
wr select RTF expression	Longint	14	Selects the RTF expression whose rank in the document is defined by begin. end must be omitted.

Example 1

The following example executes different functions based on the presence or the absence of a Page break:

  `Setting the selection

 WR SET SELECTION(area;0;0)

  `Try to select the first page break

 WR SELECT(area;wr select page break;1)

  `Retrieving the limits of the new selection

 WR GET SELECTION(area;$vlbegin;$vlend)

 If(($vlbegin=0)&($vlend=0))

  `There is no page break

 Else

  `Do something with the page break

 End if

Example 2

The following example selects the references in the 4D Write area referenced by area and applies to them a style that makes them easy to spot:

 NbObjects:=WR Count(area;4)

  `Counting the number of references

 For(i;1;NbObjects)

    WR SELECT(area;wr select expression;i)

  `Selecting each reference

    WR GET REFERENCE(area;TableNo;FieldNo;vName;vType)

    WR SET TEXT PROPERTY(area;wr bold;1)

    WR SET TEXT PROPERTY(area;wr text color;wr blue)

  `Applying Blue and Bold to the selection

 End for