Newton Developer Technical Information: Newton Programmer's Guide: 2.1 OS Addendum /

Chapter 3 - Word Processing Views / Word Processing View Reference

Protos / protoTXViewFinder

FindString

protoTXViewFinder:FindString(object, str, startOffset, options)

Searches for matching text in the data object returned by a call to the *protoTXView:*Externalize method.

object

A data object returned from the *Externalize method.

str

The string to find.

startOffset

The offset at which the search should start, expressed as a number of characters from the start of the data.

options

Must be nil.

return value

The offset of the matching string in the object, or nil if no match is found.

DISCUSSION

The FindString method searches in a word-processing data object for a sequence of characters that matches str. The search is not case sensitive. The search begins at startOffset from the beginning of the object and continues until a match is made or the end of the text is reached.

The FindString returns nil.

Note

This method works the same as the *protoTXView:FindString method, except that the protoTXViewFinder version has an additional parameter: object.