FindText message [Revelation On-Line Wiki]

This page is read only. You can view the source, but not change it. Ask your administrator if you think this is wrong.
====== FindText message ======


 
==== Description ====
 
Used to search for text within an Edit Box control
 
==== Applies To ====
 
Edit Box Control
 
==== Syntax ====
 
position = Send_Message(CtrlEntID, "FINDTEXT", range, text, findflags)
 
==== Parameters ====
 
Parameters are as follows:
 
^Parameter^Description^
||Range|An @FM-delimited array of startpos:@FM:length, where startpos is starting position, and length is the length of the selection.|
||Text|the string to search on.|
||Findflags|an @FM-delimited array of search options\\ \\ __Position__ __Description__\\ 1 - Search direction.  If true will search up.  If false will search down.\\ 2 - Case Sensitive.  If true, the search will be case sensitive.  If false, the search will be case insensitive.\\ 3 - Whole Word method.  If true, will search on the whole word.  If false, will not search on whole word.|


==== Return value ====

Returns an @FM-delimited array of the Starting Position of the found text and the Length of the found text.

 
==== Example ====
 
<code>
RangeToSearch = ""

RangeToSearch<1> = selstart + sellen

RangeToSearch<2> = len(text) ; * Length of text to search

FindFlags = ""

FindFlags<1> = 0 ; * true=search up, false=search down

FindFlags<2> = 0 ; * true=case sensitive, False=case insensitive

FindFlags<3> = 0 ; * true=whole word, false=not whole word

Position = Send_Message(CtrlEntID, 'FINDTEXT', RangeToSearch, TextToFind, FindFlags)
</code>