Functions > Window > Controls >

ControlListView

Envoie une commande à un contrôle ListView32.

ControlListView ( "title", "text", controlID, "command" [, option1 [, option2]] )

Paramètres

title Le titre/hWnd/class de la fenêtre à atteindre. Consultez Définition spéciale de titre.
text Le texte de la fenêtre à atteindre. Consultez Définition spéciale de texte.
controlID Le contrôle avec lequel interagir. Consultez Controls.
command La commande à envoyer au contrôle (Consultez ci-dessous).
option1 [optionnel] Paramètre additionnel requis par certaines commandes.
option2 [optionnel] Paramètre additionnel requis par certaines commandes.

Valeur de retour

Dépend de la commande comme le montre le tableau ci-dessous. En cas d'erreur (telle qu'une commande ou fenêtre/contrôle invalide), @error est mis à 1.

Commande, Option1, Option2 Operation
"DeSelect", From [, To] Annule la sélection d'un ou plusieurs éléments.
"FindItem", "string to find" [, SubItem] Retourne l'index de la chaîne recherchée. Retourne -1 si la chaîne n'est pas trouvée.
"GetItemCount" Retourne le nombre d'éléments de la liste.
"GetSelected" [, option] Retourne une chaîne contenant l'index des éléments sélectionnés. Si option=0 (défaut) seul l'index du premier élément sélectionné est retourné. Si option=1 alors tous les index sélectionnés sont retournés séparés par le caractère "|", par exemple: "0|3|4|10". Si aucun éléments n'est sélectionné, une chaine vide "" est retournée.
"GetSelectedCount" Retourne le nombre d'éléments qui sont sélectionnés.
"GetSubItemCount" Retourne le nombre de sous-éléments.
"GetText", Item, SubItem Retourne le texte d'un élément/sous élément donné.
"IsSelected", Item Retourne 1 si l'élément est sélectionné, sinon retourne 0.
"Select", From [, To] Sélectionne un ou plusieurs éléments.
"SelectAll" Sélectionne tous les éléments.
"SelectClear" Efface la sélection de tous les éléments.
"SelectInvert" Inverse la sélection en cours.
"ViewChange", "view" Change le type de vue en cours. Les types de vues possibles sont : "list", "details", "smallicons", "largeicons".


Dans une vue détaillée d'un contrôle ListView32, un élément correspond à une rangée et un sous-élément à une colonne.

Remarque

Certaines commandes peuvent échouer lors de l'utilisation d'un processus AutoIt 32-Bits pour lire un processus 64-bits. De même des commandes peuvent échouer lors de l'utilisation d'un processus AutoIt 64-Bits pour lire un processus 32-bits.

En relation

ControlCommand

Exemple

#include <MsgBoxConstants.au3>

ControlListView(@ProgramFilesDir & "\AutoIt3", "", "SysListView321", "SelectAll")
ControlListView(@ProgramFilesDir & "\AutoIt3", "", "SysListView321", "Deselect", 2, 5)
MsgBox($MB_SYSTEMMODAL, "", ControlListView(@ProgramFilesDir & "\AutoIt3", "", "SysListView321", "GetText", 9, 0))
MsgBox($MB_SYSTEMMODAL, "", ControlListView(@ProgramFilesDir & "\AutoIt3", "", "SysListView321", "FindItem", "14 KB", 1))
MsgBox($MB_SYSTEMMODAL, "", ControlListView(@ProgramFilesDir & "\AutoIt3", "", "SysListView321", "GetSelected", 1))