TXTextControl.ObjectNext Method

This method returns the identifier of the object that follows the specified object in a Text Control's internal list of objects.

Syntax

TXTextControl.ObjectNext ObjectId, ObjectGroup
Parameter Description
ObjectId

Specifies a valid object identifier. If this parameter is zero, the first object's identifier is returned.

ObjectGroup

This parameter specifies which kinds of objects are to be returned. It can be a sum of the values as described in Remarks. If this parameter is zero, the identifiers of all objects are returned.

Return Value

The method returns the next object's identifier. It returns zero when there is no following object.

Remarks

The settings for ObjectGroup can include:


Value Description
&H1 Returns only identifiers of objects positioned at a fixed geometrical position.
&H2 Returns only identifiers of objects that act as single characters.
&H4 Returns only identifiers of images.
&H8 Returns only identifiers of objects which are externally created by the application.
&H10 Returns only identifiers of OLE objects.
&H20 Returns only identifiers of text frames.
&H40 Returns only identifiers of objects that are anchored to a paragraph.
&H400 Returns only identifiers of signature fields.

Data Types

ObjectId:    Integer
ObjectGroup:    Integer
Return value:    Integer

See Also