Funktionreferenz


_GUICtrlListBox_FindInText

Beschreibung anzeigen in

Sucht nach einem Item, welches den bestimmten Text irgendwo in seinem Text enthält

#include <GuiListBox.au3>
_GUICtrlListBox_FindInText ( $hWnd, $sText [, $iStart = -1 [, $bWrapOK = True]] )

Parameter

$hWnd Control-ID / Handle des Controls
$sText zu suchender Text
$iStart [optional] 0-basierender Index des Items, von wo die Suche beginnen soll oder -1 um vom Anfang zu beginnen.
Das bestimmte Item wird bei der Suche ausgeschlossen.
$bWrapOK [optional] Falls True, wird die Suche mit beim ersten Item fortgesetzt, falls nichts passendes gefunden wurde

Rückgabewert

Erfolg: Der 0-basierende Index des Items
Fehler: -1

Bemerkungen

Die Suche berücksichtigt die Groß- und Kleinschreibung nicht.

- - - - - - - - Erklärung der Controls - - - - - - - -

Verwandte Funktionen

_GUICtrlListBox_FindString, _GUICtrlListBox_SelectString

Beispiel

#include <GUIConstantsEx.au3>
#include <GuiListBox.au3>

Example()

Func Example()
    Local $iIndex, $idListBox

    ; Erstellt eine GUI
    GUICreate("ListBox: Suche eine Textstelle, im Text", 400, 296)
    $idListBox = GUICtrlCreateList("", 2, 2, 396, 296)

    GUISetState(@SW_SHOW)

    ; Fügt Strings hinzu
    _GUICtrlListBox_BeginUpdate($idListBox)
    For $iI = 1 To 9
        _GUICtrlListBox_AddString($idListBox, StringFormat("%03d : Zufallstring", Random(1, 100, 1)))
    Next
    _GUICtrlListBox_InsertString($idListBox, "eXaCt tExT", 3)
    _GUICtrlListBox_EndUpdate($idListBox)

    ; Sucht nach einem Item
    $iIndex = _GUICtrlListBox_FindInText($idListBox, "exa")
    _GUICtrlListBox_SetCurSel($idListBox, $iIndex)

    ; Die Schleife wiederholt sich, bis der Benutzer die Beenden-Aktion der GUI auslöst.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
    GUIDelete()
EndFunc   ;==>Example