UDF > GUI > GuiListView >


_GUICtrlListView_GetISearchString

Obtient la chaîne de recherche incrémentale du contrôle

#include <GuiListView.au3>
_GUICtrlListView_GetISearchString ( $hWnd )

Paramètre

$hWnd ID/handle du contrôle

Valeur de retour

Retourne une chaîne de recherche incrémentale ou une chaîne vide si aucune chaîne de recherche existe.

Remarques

La chaîne de recherche incrémentale est la séquence de caractères que l'utilisateur tape alors que la ListView a le focus d'entrée.
Chaque fois que l'utilisateur tape un caractère, le système ajoute le caractère à la chaîne de recherche, puis cherche un élément correspondant.
Si le système trouve une correspondance, il sélectionne l'élément et, si nécessaire, le fait défiler dans la partie visible.

Un délai limite est associé à chaque caractère que l'utilisateur tape.
Si le délai limite s'écoule avant que l'utilisateur tape un autre caractère, la chaîne de recherche incrémentale est remise à zéro.

Exemple

#include <GUIConstantsEx.au3>
#include <GuiImageList.au3>
#include <GuiListView.au3>
#include <MsgBoxConstants.au3>

Example()

Func Example()
    Local $hImage, $idListview

    GUICreate("ListView Get ISearch", 400, 300)

    $idListview = GUICtrlCreateListView("", 2, 2, 394, 268)
    GUICtrlSetStyle($idListview, $LVS_ICON)
    GUISetState(@SW_SHOW)

    ; Charge les images
    $hImage = _GUIImageList_Create()
    _GUIImageList_Add($hImage, _GUICtrlListView_CreateSolidBitMap($idListview, 0xFF0000, 16, 16))
    _GUICtrlListView_SetImageList($idListview, $hImage, 0)

    _GUICtrlListView_BeginUpdate($idListview)
    For $x = 1 To 10
        _GUICtrlListView_InsertItem($idListview, "Item " & $x, -1, 0)
    Next
    _GUICtrlListView_EndUpdate($idListview)

    Send("Item 1")

    ; Obtient la chaîne de recherche incrémentale
    MsgBox($MB_SYSTEMMODAL, "Information", "Incremental Search String: " & _GUICtrlListView_GetISearchString($idListview))

    ; Boucle jusqu'à ce que l'utilisateur quitte.
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE

    GUIDelete()
EndFunc   ;==>Example