ListBox


#1 - Cours théorique

************************************************************
# PROPRIETES #1
************************************************************

' NB : item correspond àentrée.

[Appearance] ----------------- Renvoie ou détermine le style du contrôle( [0] Plat, [1] Effet 3D)
[BackColor] ------------------- Renvoie ou détermine la couleur de fond (Hex)
[BorderStyle] ------------------ Renvoie ou détermine le style du bord ( [0] Plat, [1] Effet 3D )
[Columns] --------------------- Renvoie ou détermine le nombre de colonnes ( [0] Pas de colonnes, déroulement vertical, [n(>0)] n colonnes, déroulement horizontal )
[Container] -------------------- Renvoie ou détermine l'élément oùest placéla ListBox (Form, Frame, etc...)
[DataChanged] ---------------- Renvoie si les items de départ ont étémodifiés
[DataField] --------------------- Dans le cadre d'une liaison avec une BDD par contrôle Data, renvoie ou détermine le champ que la ListBox doit lire
[DragIcon] --------------------- Renvoie ou détermine l'icône du curseur lors d'un Glisser-Déplacer (Drag &Drop)
[DragMode] -------------------- Renvoie ou détermine le mode du Drag ( [0] Manuel, [1] Automatique : un clic sur le contrôle suffit pour démarrer le Glisser-Déplacer )
[Enabled] ---------------------- Renvoie ou détermine si l'objet doit être actif
[Font] -------------------------- Renvoie ou détermine la police utilisée pour l'objet
[FontBold] --------------------- Renvoie ou détermine si le texte doit être affichéen gras
[FontItalic] --------------------- Renvoie ou détermine si le texte doit être affichéen italique
[FontSize] ---------------------- Renvoie ou détermine la taille de la police
[FontName] -------------------- Renvoie ou détermine le nom de la police
[FontStrikethru]---------------- Renvoie ou détermine si le texte doit être barré
[FontUnderline] ---------------- Renvoie ou détermine si le texte doit être souligné
[ForeColor] -------------------- Renvoie ou détermine la couleur de la police (Hex)
[Height] ------------------------ Renvoie ou détermine la hauteur de l'objet
[HideSelection] ---------------- Renvoie ou détermine si la sélection doit être conservée lorsque l'objet perd le focus
[hWnd] ------------------------- Renvoie l'handle du contrôle
[Index] ------------------------- Renvoie ou détermine le numéro identifiant la ListBox, lorsque plusieurs ListBox portent le même nom
[IntegralHeight] --------------- Renvoie ou détermine si la hauteur de la ListBox doit être modifiée lorsque le dernier item est coupé
[Left] --------------------------- Renvoie ou détermine les coordonnées X de l'objet : distance par rapport au bord gauche de la feuille
[List(x)] ------------------------ Renvoie ou détermine le texte de l'item n°x, sachant que le premier item a pour index x=0
[ListCount] --------------------- Renvoie le nombre d'items que contient la ListBox
[ListIndex] --------------------- Renvoie ou détermine l'index de l'item selectionné( [-1] Aucun item selectionné)
[MultiSelect] ------------------- Renvoie ou détermine si la sélection multiple est autorisée
[MouseIcon] ------------------- Détermine ou le chemin de l'icône du curseur de la souris (MousePointer doit avoir pour valeur 99 - Custom) ou renvoie l'identificateur de l'icône
[MousePointer] ---------------- Renvoie ou détermine le curseur de la souris parmi une liste quand il passe au dessus de l'objet ( [99] Autre icône )
[NewIndex] --------------------- Renvoie l'index du dernier item ajouté
[OLEDragMode] --------------- Renvoie ou détermine comment le Glisser-Déplacer crée doit être géré(OLE)
( [1] Manuel (géréavec l'aide des évènements), [2] Automatique)
[OLEDropMode] --------------- Renvoie ou détermine si l'objet peut recevoir un Glisser-Déplacer et comment (OLE)
( [0] Refusé, [1] Manuel (géréavec avec l'aide des évènements), [2] Automatique)
[Parent] ------------------------ Désigne la feuille (form) oùest placéle contrôle
[RightToLeft] ------------------ Pour certaines langues, renvoie ou détermine la direction du texte
[SelCount] -------------------- Renvoie le nombre d'items sélectionnés
[Selected(x)] ----------------- Renvoie ou détermine si l'item n°x doit être sélectionné
[Sorted] ----------------------- Renvoie ou détermine si les éléments de la ListBox doivent être classés alphabétiquement
[Style] ------------------------- Renvoie ou détermine le style du contrôle ( [0] Standard, [1] Checkbox)
[TabIndex] -------------------- Renvoie ou détermine le numéro indiquant l'ordre de tabulation possédépar l'objet (Touche Tab)
[TabStop] --------------------- Renvoie ou détermine si l'objet peut obtenir le focus par la touche Tab
[Tag] --------------------------- Permet de stocker une donnée invisible
[Text] -------------------------- Renvoie le texte de l'item sélectionné(List1.Text équivalent àList.List(List.ListIndex))
[ToolTipText] ------------------ Renvoie ou détermine le texte affichédynamiquement lorsque le curseur de la souris reste sur l'objet
[Top] --------------------------- Renvoie ou détermine les coordonnées Y de l'objet : distance par rapport au bord du haut de la feuille
[TopIndex] --------------------- Renvoie ou détermine l'index de l'item se trouvant àl'affichage en premier
[Visible] ------------------------ Renvoie ou détermine si le contrôle doit être visible sur la feuille
[Width] ------------------------ Renvoie ou détermine la largeur de l'objet

************************************************************
# METHODES #2
************************************************************

---------------------------
[ AddItem (Item, Index) ]
---------------------------
>Ajoute une entrée àla ListBox
>|Item| : Texte de l'item
>|Index| : Index de l'item (par défaut 0)

---------------------------
[ Clear ]
---------------------------
>Supprime toutes les entrées de la ListBox

---------------------------
[ Move (Left As Single, Top As Single, Width As Single, Height As Single) ]
---------------------------

>Déplace l'objet, modifie ses dimensions
>|Left| : Nouvelles coordonnées X de l'objet
>|Top| : Nouvelles coordonnées Y de l'objet
>|Width| : Nouvelle largeur de l'objet
>|Height| : Nouvelle hauteur de l'objet

---------------------------
[ Refresh ]
---------------------------
>Rafraîchit l'objet

---------------------------
[ RemoveItem (Index) ]
---------------------------
>Supprime un item de la ListBox
>|Index| : Index de l'item

---------------------------
[ SetFocus ]
---------------------------
>Donne le focus àl'objet

---------------------------
[ ZOrder (Position) ]
---------------------------
>Définit la position de l'objet par rapport aux autres objets en profondeur (Axe Z)
>|Position| : ( [0] au dessus des autres, [1] au dessous des autres )


************************************************************
# EVENEMENTS #3
************************************************************

---------------------------
[ Click() ]
---------------------------
>L'utilisateur clique sur le contrôle

---------------------------
[ DblClick() ]
---------------------------
>L'utilisateur double-clique sur le contrôle

---------------------------
[ DragDrop(Source As Control, X As Single, Y As Single) ]
---------------------------
>L'objet reçoit un Glisser-Déplacer (curseur relaché)
>|Source| : Désigne contrôle qui a lancéle Glisser-Déplacer
>|X| : Coordonnée X oùest le curseur (àpartir du bord gauche de l'objet)
>|Y| : Coordonnée Y oùest le curseur (àpartir du haut de l'objet)

---------------------------
[ DragOver(Source As Control, X As Single, Y As Single, State As Integer) ]
---------------------------
>L'objet reçoit ou émet un Glisser-Déplacer (curseur non relaché)
>|Source| : Désigne contrôle qui a lancéle Glisser-Déplacer
>|X| : Coordonnée X oùest le curseur (àpartir du bord gauche de l'objet)
>|Y| : Coordonnée Y oùest le curseur (àpartir du haut de l'objet)
>|State| : Information sur l'état sur Glisser-Déposer

---------------------------
[ GotFocus() ]
---------------------------
>L'objet reçoit le focus

---------------------------
[ ItemCheck(Item As Integer) ]
---------------------------
>Se produit lorsqu'un Item est coché/décoché
>! Uniquement lorsque la ListBox a pour valeur Style = 1-Checkbox !
>|Item| : Index de l'entrée

---------------------------
[ KeyDown(KeyCode As Integer, Shift As Integer) ]
---------------------------
>Touche pressée, clavier étendu compris
>|KeyCode| : Renvoie le code de la touche
>|Shift| : Indique si la touche Ctrl, ou Shift ou Alt sont enfoncées

---------------------------
[ Keypress(KeyAscii As Integer) ]
---------------------------
>Touche pressée
>|KeyCode| : Renvoie le code ANSI de la touche

---------------------------
[ KeyUp(KeyCode As Integer, Shift As Integer) ]
---------------------------
>Touche relachée, clavier étendu compris
>|KeyCode| : Renvoie le code de la touche
>|Shift| : Indique si la touche Ctrl, ou Shift ou Alt sont enfoncées

---------------------------
[ LostFocus() ]
---------------------------
>L'objet perd le focus

---------------------------
[ MouseDown(Button As Integer, Shift As Integer, X As Single, Y As Single) ]
---------------------------
>L'utilisateur appuie sur un bouton de la souris sur le contrôle
>|Button| : Renvoie le bouton de la souris qui a étécliqué
>( [1] Gauche [2] Droit [4] Milieu )
>|Shift| : Indique si la touche Ctrl, ou Shift ou Alt sont enfoncées
>|X| : Coordonnée X oùest le curseur (àpartir du bord gauche de l'objet)
>|Y| : Coordonnée Y oùest le curseur (àpartir du haut de l'objet)

---------------------------
[ MouseMove(Button As Integer, Shift As Integer, X As Single, Y As Single) ]
---------------------------
>Le curseur de la souris passe au dessus du contrôle
>|Button| : Renvoie le bouton de la souris qui a étécliqué
>( [1] Gauche [2] Droit [4] Milieu )
>|Shift| : Indique si la touche Ctrl, ou Shift ou Alt sont enfoncées
>|X| : Coordonnée X oùest le curseur (àpartir du bord gauche de l'objet)
>|Y| : Coordonnée Y oùest le curseur (àpartir du haut de l'objet)

---------------------------
[ MouseUp(Button As Integer, Shift As Integer, X As Single, Y As Single) ]
---------------------------
>L'utilisateur relâche sur un bouton de la souris ( appuyédepuis le contrôle )
>|Button| : Renvoie le bouton de la souris qui a étécliqué
>( [1] Gauche [2] Droit [4] Milieu )
>|Shift| : Indique si la touche Ctrl, ou Shift ou Alt sont enfoncées
>|X| : Coordonnée X oùest le curseur (àpartir du bord gauche de l'objet)
>|Y| : Coordonnée Y oùest le curseur (àpartir du haut de l'objet)

---------------------------
[ OLEDragDrop(Source As Control, X As Single, Y As Single) ]
---------------------------
>L'objet reçoit un Glisser-Déplacer (curseur relaché)
>|Source| : Désigne contrôle qui a lancéle Glisser-Déplacer
>|X| : Coordonnée X oùest le curseur (àpartir du bord gauche de l'objet)
>|Y| : Coordonnée Y oùest le curseur (àpartir du haut de l'objet)

---------------------------
[ OLEDragOver(Data As DataObject, Effect As Long, Button As Integer, Shift As Integer,
_X As Single, Y As Single, State As Integer) ]
---------------------------
>L'objet reçoit ou émet un Glisser-Déplacer (Si OLEDropMode = 1)
>|Data| : Désigne contrôle qui a lancéle Glisser-Déplacer
>|Effect| : Indique les conséquences produites par le Glisser-Déplacer
>|Button| : Renvoie le bouton de la souris qui a étécliqué
>( [1] Gauche [2] Droit [4] Milieu )
>|Shift| : Indique si la touche Ctrl, ou Shift ou Alt sont enfoncées
>|X| : Coordonnée X oùest le curseur (àpartir du bord gauche de l'objet)
>|Y| : Coordonnée Y oùest le curseur (àpartir du haut de l'objet)
>|State| : Information sur l'état sur Glisser-Déposer

---------------------------
[ Scroll() ]
---------------------------
>Une des barres de défilement est utilisée








(c) - CYBER@TOM ASSOCIATION 2000-2004