4D Doc Center : WR GET CURSOR POSITION

Home

4D Write v14

WR GET CURSOR POSITION


WR GET CURSOR POSITION ( area ; page ; column ; line ; position )

Parameter	Type	Description
area	Longint	4D Write area
page	Longint	Number of the page where the selection is
column	Longint	Number of the column where the selection is
line	Longint	Number of the line in the column
position	Longint	Position of the selection in the current line

Description

The WR GET CURSOR POSITION command returns the position of the selection in the 4D Write area referenced by area.

page: page is between the number of the first page and the number of the last page of the document. These numbers take into account the custom page numbering, if any.
column: This value is between 1 and the total number of columns.
line: This value is between 1 and the total number of lines in the column.
position: This value is between 1 and the total number of characters in the line.

If the selection contains several characters, the position of the first character is returned.
You can later go back to this location, using the WR SET CURSOR POSITION command with the same parameters.
You can use WR Get frame to determine which area the cursor is in.

Example

You want the user to be able to insert a logo in the header of the document, without losing the current position of the cursor in the text. To do this, attach the following method to the insertion button:

 C_LONGINT($frame;$Col;$Line;$Pos)

 C_REAL($PictWidth;$PictHeight;$OrigWidth;$OrigHeight;$HeadTopMargin)

  `Which frame of the document is the cursor in?

 $frame:=WR Get frame(Area)

  `Getting current cursor position

 WR GET CURSOR POSITION(Area;$Page;$Col;$Line;$Pos)

  `Switching the current area to the header of the document

 WR SET FRAME(Area;wr right header)

  `Loading the record that contains the logo to include

 ALL RECORDS([Interface])

  `Inserting the logo

 WR INSERT PICTURE(Area;[Interface]Logo;0)

  `Selecting the logo and getting its size

 WR SELECT(Area;4;1)

 WR GET PICTURE SIZE(Area;$PictWidth;$PictHeight;$OrigWidth;$OrigHeight)

  `The height of the header must fit the picture

 $HeadTopMargin:=WR Get doc property(Area;wr header top margin)

 WR SET DOC PROPERTY(Area;wr text top margin;$HeadTopMargin+$PictHeight)

 WR SET DOC PROPERTY(Area;wr header bottom margin;$PictHeight)

  `Then going back to the frame the cursor was in

 WR SET FRAME(Area;$frame)

  `Putting the cursor back in its original position

 WR SET CURSOR POSITION(Area;$Page;$Col;$Line;$Pos)