UDF > GUI > GuiComboBox >

_GUICtrlComboBox_SelectString

Recherche dans la zone de liste d'une ComboBox un élément qui commence par la chaîne donnée

#include <GuiComboBox.au3>
_GUICtrlComboBox_SelectString ( $hWnd, $sText [, $iIndex = -1] )

Paramètres

$hWnd ID/handle du contrôle
$sText String qui contient les caractères à rechercher
$iIndex [optionnel] Spécifie l'index, à partir de 0, de l'élément qui précède le premier élément à rechercher

Valeur de retour

Succès: Retourne l'index de l'élément sélectionné.
Échec: -1.

Remarques

Lorsque la recherche atteint la fin de la liste, elle continue à partir du haut de la liste jusqu'à l'élément spécifié par le paramètre wParam.

Si $iIndex vaut -1, la liste complète est concernée par la recherche depuis le début.
Une chaîne est sélectionnée que si les caractères du point de départ correspondent aux caractères de la chaîne donnée

Si un élément de correspondance est trouvée, il est sélectionné et copié dans le contrôle d'édition.

En relation

_GUICtrlComboBox_FindString, _GUICtrlComboBox_FindStringExact, _GUICtrlComboBoxEx_FindStringExact

Exemple

#include <GuiComboBox.au3>
#include <GUIConstantsEx.au3>
#include <MsgBoxConstants.au3>
#include <WindowsConstants.au3>

Example()

Func Example()
    Local $idCombo

    ; Crée une GUI
    GUICreate("ComboBox Select String", 400, 296)
    $idCombo = GUICtrlCreateCombo("", 2, 2, 396, 296, BitOR($CBS_SIMPLE, $CBS_DISABLENOSCROLL, $WS_VSCROLL))
    GUISetState(@SW_SHOW)

    ; Ajoute des fichiers
    _GUICtrlComboBox_BeginUpdate($idCombo)
    _GUICtrlComboBox_AddDir($idCombo, @WindowsDir & "\*.exe")
    ; Ajoute une chaîne
    _GUICtrlComboBox_AddString($idCombo, "This string has been added")
    ; Ajoute des fichiers
    _GUICtrlComboBox_AddDir($idCombo, "", $DDL_DRIVES, False)
    _GUICtrlComboBox_EndUpdate($idCombo)

    ; Sélectionne une chaîne
    _GUICtrlComboBox_SelectString($idCombo, "This")

    ; Boucle jusqu'à ce que l'utilisateur quitte
    Do
    Until GUIGetMsg() = $GUI_EVENT_CLOSE
    GUIDelete()
EndFunc   ;==>Example