ONLINE HELP
 WINDEVWEBDEV AND WINDEV MOBILE

Help / WLanguage / WLanguage functions / Controls, pages and windows / Search functions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReports and QueriesUser code (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Browser code
WINDEV Mobile
AndroidAndroid Widget iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Others
Stored procedures
Finds and selects the first element corresponding to the sought text in a window or control.
Example
// Whenever EDT_SRCH is modified
// Finds and highlights all occurrences
// Highlights the 1st occurrence in blue and displays it if necessary
IF ControlFindTextFirst(MyWindow.Name, EDT_SRCH, 0, iLightBlue) = 0 THEN
BTN_Next.State = Grayed
Info("Text not found")
ELSE
BTN_Next.State = Active
END
Syntax
<Result> = ControlFindTextFirst(<Element> , <Searched text> [, <Search options> [, <Highlighting of first element> [, <Highlighting of elements found>]]])
<Result>: Integer
  • Number of occurrences found in the control or window.
  • 0 if no element contains the searched text.
<Element>: Window name or control name
Name of element where the search will be performed. This element can correspond to:
  • a window name. The search is performed in the caption of controls, the text of buttons, the text of edit controls, the text of table rows, ... The search is performed in all the visible controls that have no invisible parent.
  • a control name. If this element corresponds to a Ribbon control, the search is performed in all ribbon controls.
<Searched text>: Character string
  • Text that must be found in the specified element.
  • "" (empty string) to cancel the search.
<Search options>: Optional Integer constant
Indicates the search options:
IgnoreCaseCase and accent insensitive search (ignores uppercase/lowercase differences)
WholeWordSearches for a whole word (between punctuation characters or spaces)
0Search while taking the case into account (uppercase/lowercase characters) on a text "contained in".

No option is selected by default: the search is sensitive to the case and it is performed on incomplete words.
<Highlighting of first element>: Integer or constant (optional)
Color used to highlight the first element found. This color can correspond to:
Remark: The color used by default is dark blue.
<Highlighting of elements found>: Integer or constant (optional)
Color used to highlight the occurrences found. This color can correspond to:
Remark: The color used by default is light yellow.
Remarks
  • A single search can be performed at a given time in a control or in a window.
  • The call to ControlFindTextFirst cancels a possible previous call to ControlFindHighlight.
  • The search is not performed in the following controls:
    • HTML control and edit control in HTML format.
    • ActiveX control.
    • Zone not displayed in the Looper controls, List Box controls, Table controls.
    • List, table or popup displayed by the combo boxes.
Component: wd290obj.dll
Minimum version required
  • Version 18
This page is also available for…
Comments
Click [Add] to post a comment

Last update: 05/26/2022

Send a report | Local help