Structure LVFINDINFOA (commctrl.h)
Contient les informations utilisées lors de la recherche d’un élément list-view. Cette structure est identique à LV_FINDINFO, mais a été renommée pour s’adapter aux conventions de nommage standard.
Syntaxe
typedef struct tagLVFINDINFOA {
UINT flags;
LPCSTR psz;
LPARAM lParam;
POINT pt;
UINT vkDirection;
} LVFINDINFOA, *LPFINDINFOA;
Membres
flags
Type : UINT
Type de recherche à effectuer. Ce membre peut être défini sur une ou plusieurs des valeurs suivantes :
Valeur | Signification |
---|---|
|
Recherche une correspondance entre le membre lParam de cette structure et le membre lParam de la structure LVITEM d’un élément. |
|
Vérifie si le texte de l’élément commence par la chaîne pointée vers le membre psz . Cette valeur implique l’utilisation de LVFI_STRING. |
|
Recherche en fonction du texte de l’élément. Sauf si des valeurs supplémentaires sont spécifiées, le texte de l’élément correspondant doit correspondre exactement à la chaîne pointée par le membre psz . Toutefois, la recherche ne respecte pas la casse. |
|
Windows Vista et versions ultérieures. Équivalent à LVFI_PARTIAL. |
|
Continue la recherche au début si aucune correspondance n’est trouvée. Si cet indicateur est utilisé seul, il est supposé qu’une recherche de chaîne est souhaitée. |
|
Recherche l’élément le plus proche de la position spécifiée dans le membre pt , dans le sens spécifié par le membre vkDirection . Cet indicateur est pris en charge uniquement par les modes icône grande et petite icône. Si LVFI_NEARESTXY est spécifié, tous les autres indicateurs sont ignorés. |
psz
Type : LPCTSTR
Adresse d’une chaîne terminée par null à comparer avec le texte de l’élément. Elle n’est valide que si LVFI_STRING ou LVFI_PARTIAL est défini dans le membre indicateurs .
lParam
Type : LPARAM
Valeur à comparer avec le membre lParam de la structure LVITEM d’un élément de liste. Elle est valide uniquement si LVFI_PARAM est défini dans le membre indicateurs .
pt
Type : POINT
Structure POINT avec la position de recherche initiale. Elle est valide uniquement si LVFI_NEARESTXY est défini dans le membre indicateurs .
vkDirection
Type : UINT
Code de clé virtuelle qui spécifie le sens de la recherche. Les codes suivants sont pris en charge :
- VK_LEFT
- VK_RIGHT
- VK_UP
- VK_DOWN
- VK_HOME
- VK_END
- VK_PRIOR
- VK_NEXT
Notes
Notes
L’en-tête commctrl.h définit LVFINDINFO comme un alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.
Spécifications
Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows Server 2003 [applications de bureau uniquement] |
En-tête | commctrl.h |