TXTextControl.TXTextControl.FieldNext Method

This method returns the identifier of the marked text field that follows the specified field in the Text Control's current text. It can be used to find the next field in the text or to enumerate all fields. In a list of linked Text Controls the search is performed in all controls.

Syntax

TXTextControl.FieldNext FieldId, FieldGroup
Parameter Description
FieldId

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

FieldGroup

This parameter can be the sum of one or more constants used to seperate fields with certain attributes. Valid values are described in the following list. If FieldGroup is zero, the method enumerates all fields.


Value Description
0 Returns the identifiers of all fields.
&H1 Returns only identifiers of fields which are both changeable and deleteable.
&H2 Returns only identifiers of fields which are unchangeable.
&H4 Returns only identifiers of fields which are undeleteable.
&H100 Returns only identifiers of fields which have the type txFieldLinkTarget.
&H200 Returns only identifiers of fields which have the type txFieldExternalLink.
&H400 Returns only identifiers of fields which have the type txFieldInternalLink.
&H800 Returns only identifiers of fields which have the type txFieldPageNumber.
&H1000 Returns only identifiers of fields which have the type txFieldHighlight.
&H2000 Returns only identifiers of fields which have the type txFieldTopic.
&H8000 Returns only identifiers of fields which have the type txFieldMSWord.
&H10000 Returns only identifiers of fields which have the type txFieldHighEdit.
&H20000 Returns only identifiers of fields which have the type txFieldAllPages.

Data Types

FieldId:    Integer
FieldGroup:    Long
Return value:    Integer

See Also