QMedia Text media commands |

### QM_SearchText

QM_SearchText(movieRef; searchText; searchFlags; sampleTime; textOffset; trackID):error
| movieRef | Longint | Movie reference
| searchText | String255 | Search string
| searchFlags | Longint | Search flags
| sampleTime | Longint | Text sample time
| textOffset | Longint | Text offset
| trackID | Longint | Text track ID
| error | Longint | Error result

Searches the text tracks of a movie.

Parameter movieRef is the reference to the movie instance. The movie reference must have been previously obtained with a call to QM_NewMovieFromFile.

The text to search for is specified by the searchText parameter.

Parameter searchFlags is a set of flags controlling various search options. The searchFlags parameter can be constructed by combining (with addition or bitwise "or") any of the following constants.

qm_SearchEdgeOK | 0x00000001 | It is OK to find text at the specified sample time
qm_SearchCaseSensitive | 0x00000002 | Search is case sensitive
qm_SearchReverseSearch | 0x00000004 | Search from the specified sample time backwards
qm_SearchWrapAround | 0x00000008 | Wrap around when reaching the beginning or end of movie
qm_SearchUseOffset | 0x00000010 | Begin search at the specified offset into the text sample rather than the edge
qm_SearchDontGoToFoundTime | 0x00010000 | Don't go to the found time
qm_SearchDontHiliteFoundText | 0x00020000 | Don't highlight the found text
qm_SearchOneTrackOnly | 0x00040000 | Search only the specified track
qm_SearchEnabledTracksOnly | 0x00080000 | Search only the enabled tracks

Parameter sampleTime specifies the point in the movie where the search will begin. If the search completes successfully, sampleTime receives the time of the found text sample, otherwise it is set to -1.

Parameter textOffset is the offset in the text sample specified by sampleTime where the search will begin. If qm_searchUseOffset is not specified in searchFlags, textOffset is ignored. If the search completes successfully, textOffset receives the offset of the found text in the found text sample.

Parameter trackID is the ID of the text track to search. If qm_searchOneTrackOnly is not specified in searchFlags, trackID is ignored. If the search completes successfully, trackID receives the ID of the track where the text was found.

Example

`C_LONGINT($currTime;$flags;$err)` `` `$err:=QM_GetCurrentTime ($movie;$currTime)` `$flags:=qm_SearchEdgeOK | qm_searchCaseSensitive` `` `$err:=QM_SearchText ($movie;"search text";$flags;$currTime)` ``

QMedia © Escape OE
Generated by QDoc 2.8 on Thu, Nov 24, 2011 18:42:44