DR Get text

version 6.0

DR Get text (area; scope) Text

Parameter	Type		Description
area	Longint		4D Draw area
scope	Longint		-3=Selected characters
			-1=All
			0=Selected
			>0=Object ID
Function result	Text		Text of the objects in area

The command DR Get text returns the text of the objects in area described by scope.

• If scope equals -3, the function returns the highlighted text of the selected object. If the insertion point is between characters, DR Get text returns an empty string.

• If scope equals -1, the function returns the text for the first text object in the document.

• If scope equals 0, the function returns the text of the first selected text object.

• If scope is greater than 0, it must be equal to a specific text object's ID; the function returns that object's text. If the object does not exist, DR Get text returns "*****" and DR Error returns error number 2.

See the example for DR SET HIGHLIGHT.

DR SET TEXT.