[[ags|{{:contents.gif}}]] [[scripting|{{:up.gif}}]] [[label|{{:back.gif}}]] [[slider|{{:forward.gif}}]] ---- =====Fonctions et propriétés des listes (GUI List Box)===== ====AddItem==== // (Anciennement ListBoxAdd, désormais obsolète) // \\ \\ ListBox.AddItem(string nouvelleLigne) Ajoute NOUVELLELIGNE à la liste spécifiée. La ligne sera ajoutée à la fin de la liste.\\ \\ ** NOTE: ** Les listes ont une limite de 200 lignes. Si vous essayez d'en ajouter plus que ça, cette fonction retournera //false// et la ligne ne sera pas ajoutée.\\ \\ Exemple : String entree = txtEntreeJoueur.Text; lstChoix.AddItem(entree); récupérera l'entrée de l'utilisateur et l'ajoutera à la liste.\\ \\ // Voir aussi : // [[ListBox#Clear|ListBox.Clear]], [[ListBox#FillDirList|ListBox.FillDirList]], [[ListBox#InsertItemAt|ListBox.InsertItemAt]], [[ListBox#Items|ListBox.Items]], [[ListBox#RemoveItem|ListBox.RemoveItem]]\\ \\ ---- ====Clear==== // (Anciennement ListBoxClear, désormais obsolète) // \\ \\ ListBox.Clear() Supprime toutes les lignes de la liste spécifiée.\\ \\ Exemple : lstCarnet.Clear(); supprimera toutes les lignes de la liste // lstCarnet // .\\ \\ // Voir aussi : // [[ListBox#AddItem|ListBox.AddItem]]\\ \\ ---- ====FillDirList==== // (Anciennement ListBoxDirList, désormais obsolète) // \\ \\ ListBox.FillDirList(string filemask) Remplit la liste avec une série des noms de fichiers correspondant à FILEMASK dans le répertoire courant. Ceci peut être utile si vous avez plusieurs fichiers de donnée et que le joueur peut choisir lequel charger.\\ \\ FILEMASK correspond à une expression de recherche DOS/Windows standard telle que "*.dat" ou "data*.*".\\ \\ Cette commande supporte le mot-clé $SAVEGAMEDIR$, qui vous permet d'accéder aux fichiers du répertoire de sauvegardes. Ceci est spécialement important depuis le passage à Windows Vista, où vous ne pouvez potentiellement pas accéder au dossier principal du jeu.\\ \\ Exemple : lstPartiesSauvees.FillDirList("agssave.*"); remplira la liste avec les parties sauvegardées. Notez que vous utiliseriez plutôt FillSaveGameList pour cette de tâche.\\ \\ // Voir aussi : // [[ListBox#AddItem|ListBox.AddItem]], [[ListBox#Clear|ListBox.Clear]], [[ListBox#FillSaveGameList|ListBox.FillSaveGameList]]\\ \\ ---- ====FillSaveGameList==== // (Anciennement ListBoxSaveGameList, désormais obsolète) // \\ \\ ListBox.FillSaveGameList() Remplit la liste spécifiée avec les parties sauvegardées, triées correctement de la plus récente (en haut) à la moins récente (en bas).\\ \\ La propriété [[ListBox#SaveGameSlots|SaveGameSlots]] est mise à jour pour contenir le numéro du bloc de sauvegarde de chaque index dans la liste, vous pouvez donc faire : int index = lstPartiesSauvees.SelectedIndex; RestoreGameSlot(lstPartiesSauvees.SaveGameSlots[index]); ** NOTE : ** La liste de parties sauvegardées ne gère que 50 parties. Si ListBox.ItemCount retourne 50 et que vous avez un dialogue de sauvegarde, vous pourrez demander à l'utilisateur de choisir de remplacer un fichier existant plutôt que créer une nouvelle sauvegarde.\\ \\ Exemple : lstPartiesSauvees.FillSaveGameList(); will fill listbox // lstPartiesSauvees // with the list of the saved games.\\ \\ // Voir aussi : // [[ListBox#FillDirList|ListBox.FillDirList]], [[ListBox#ItemCount|ListBox.ItemCount]], [[ListBox#SaveGameSlots|ListBox.SaveGameSlots]], [[ListBox#SelectedIndex|ListBox.SelectedIndex]]\\ \\ ---- ====GetItemAtLocation==== ListBox.GetItemAtLocation(int x, int y) Détermine quelle ligne dans la liste est aux coordonnées (X,Y). Ceci vous permet de trouver quelle ligne la souris survole, par exemple.\\ \\ Retourne le numéro de la ligne (où la première vaut 0), ou -1 si les coordonnées spécifiées ne correspondent à aucune ligne ou son hors de la liste.\\ \\ Exemple : int index = lstOptions.GetItemAtLocation(mouse.x, mouse.y); if (index < 0) { Display("La souris ne survole aucune ligne !"); } else { String ligneSelectionnee = lstOptions.Items[index]; Display("La souris survole la ligne '%s'.", selectedItem); } affichera le texte de la ligne que la souris survole actuellement.\\ \\ // Voir aussi : // [[ListBox#SelectedIndex|ListBox.SelectedIndex]]\\ \\ ---- ====InsertItemAt==== ListBox.InsertItemAt(int index, string nouvelleLigne) Insère NOUVELLELIGNE dans la liste spécifiée. La ligne sera insérée **avant** celle dont l'index est spécifié.\\ \\ Les indices des listes vont de 0 (première ligne) à ItemCount - 1 (dernière ligne). La nouvelle ligne sera insérée avant l'index que vous spécifiez.\\ \\ ** NOTE : ** Les listes ont une limite de 200 lignes. Si vous essayez d'en ajouter davantage, cette fonction retournera //false// et la ligne ne sera pas ajoutée.\\ \\ Exemple : lstChoices.AddItem("Première ligne"); lstChoices.AddItem("Deuxième ligne"); lstChoices.InsertItemAt(1, "Troisième ligne"); insérera la Troisième Ligne entre la Première (index 0) et la Seconde (index 1).\\ \\ // Voir aussi : // [[ListBox#AddItem|ListBox.AddItem]], [[ListBox#RemoveItem|ListBox.RemoveItem]]\\ \\ ---- ====RemoveItem==== // (Anciennement ListBoxRemove, désormais obsolète) // \\ \\ ListBox.RemoveItem(int ligne) Supprime la LIGNE de la liste spécifiée. LIGNE correspond à l'index de la ligne à supprimer dans la liste, en commençant à 0 pour la première.\\ \\ Si vous voulez supprimer toutes les lignes de la liste, utilisez [[ListBox#Clear|ListBox.Clear]] à la place.\\ \\ ** NOTE : ** Appeler cette fonction fait que les autres lignes dans la liste sont renumérotés, assurez-vous donc de ne pas garder d'anciennes références par ListBox.SelectedIndex et les autres fonctions lorsque vous utilisez cette commandes.\\ \\ Exemple : lstTest.AddItem("Première ligne"); lstTest.AddItem("Deuxième ligne"); lstTest.RemoveItem(0); la liste ne contiendra plus que "Deuxième ligne".\\ \\ // Voir aussi : // [[ListBox#Clear|ListBox.Clear]], [[ListBox#FillDirList|ListBox.FillDirList]]\\ \\ ---- ====ScrollDown==== ListBox.ScrollDown() Fait défiler la liste d'un cran vers le bas. Si elle se trouve déjà tout en bas, rien ne se passe.\\ \\ Exemple : lstTest.ScrollDown(); fait défiler la liste //lstTest// d'un cran vers le bas.\\ \\ // Voir aussi : // [[ListBox#ScrollUp|ListBox.ScrollUp]]\\ \\ ---- ====ScrollUp==== ListBox.ScrollUp() Fait défiler la liste d'un cran vers le haut. Si elle se trouve déjà tout en haut, rien ne se passe.\\ \\ Exemple : lstTest.ScrollUp(); fait défiler la liste //lstTest// d'un cran vers le haut.\\ \\ // Voir aussi : // [[ListBox#ScrollDown|ListBox.ScrollDown]]\\ \\ ---- ====Font==== FontType ListBox.Font Retourne/Définit la police utilisée par la liste spécifiée.\\ \\ Exemple : lstPartiesSauvees.Font = eFontSpeech; fera utiliser la police "Speech" à la liste // lstPartiesSauvees //.\\ \\ // Voir aussi : // [[Label#Font|Label.Font]], [[TextBox#TextBox.Text|TextBox.Text]]\\ \\ ---- ====HideBorder==== bool ListBox.HideBorder Retourne/Définit si les bordures de la liste sont cachées.\\ \\ Notez que cacher les bordures a pour effet implicite de cacher également les flèches de défilement de la liste.\\ \\ Exemple : lstPartiesSauvees.HideBorder = true; cachera les bordures entourant la liste des Parties Sauvées.\\ \\ // Voir aussi : // [[ListBox#HideScrollArrows|ListBox.HideScrollArrows]]\\ \\ ---- ====HideScrollArrows==== bool ListBox.HideScrollArrows Retourne/Définit si les flèches de défilement sont cachées ou non.\\ \\ Vu que l'apparence des flèches de défilement n'est pas personnalisable, vous pourriez vouloir utiliser cette propriété pour les cacher afin de proposer vos propres flèches à l'aide de boutons de GUI.\\ \\ ** NOTE : ** Si le réglage "Hide Border" ("//Cacher Bordures//") de la liste est activé, alors les flèches seront assi cachées, puisque "Hide Border" contient "Hide Scroll Arrows" ("//Cacher Flèches Défilement//"). Vous n'avez besoin d'utiliser cette propriété que si vous voulez que les bordures soient visibles, mais pas les flèches.\\ \\ Exemple : lstPartiesSauvees.HideScrollArrows = true; cachera les flèches de défilement pré-fournies de la liste.\\ \\ // Voir aussi : // [[ListBox#HideBorder|ListBox.HideBorder]]\\ \\ ---- ====ItemCount==== // (Anciennement ListBoxGetNumItems, désormais obsolète) // \\ \\ readonly int ListBox.ItemCount Retourne le nombre de lignes dans la liste spécifiée. Les indices de ligne vont de 0 à (nombreLignes - 1).\\ \\ Cette propriété est en lecture seule. Pour changer le nombre de ligne, utilisez les méthodes AddItem et RemoveItem.\\ \\ Exemple : int sauvegardes = lstPartiesSauvees.ItemCount; donnera le nombre de parties sauvées comme valeur à la variable int SAUVEGARDES.\\ \\ // Voir aussi : // [[ListBox#Items|ListBox.Items]]\\ \\ ---- ====Items==== // (Anciennement ListBoxGetItemText, désormais obsolète) // // (Anciennement ListBox.GetItemText, désormais obsolète) // // (Anciennement ListBox.SetItemText, désormais obsolète) // \\ \\ String ListBox.Items[index] Retourne/Définit le texte de la ligne INDEX de la liste.\\ \\ Les lignes des listes sont numérotées à partir de 0, la première ligne a donc l'indice 0, la seconde l'indice 1, etc. La plus haute valeur possible vaut ItemCount mois 1.\\ \\ Si vous voulez ajouter une nouvelle ligne à la liste, utilisez la méthode [[ListBox#AddItem|ListBox.AddItem]].\\ \\ Exemple : String texteLigneSelectionnee = lstOptions.Items[lstOptions.SelectedIndex]; récupérera le texte de la ligne sélectionnée dans la liste.\\ \\ // Voir aussi : // [[ListBox#SelectedIndex|ListBox.SelectedIndex]], [[ListBox#ItemCount|ListBox.ItemCount]], [[ListBox#AddItem|ListBox.AddItem]]\\ \\ ---- ====RowCount==== readonly int ListBox.RowCount Retourne le nombre de lignes qui peuvent être affichées dans la liste. Cela dépend de la taille de la liste et **ne dépend pas** du nombre de lignes qui sont véritablement contenues dans la liste.\\ \\ Cette propriété est en lecture seule. Pour changer le nombre de lignes affichées, ajustez la taille de la liste.\\ \\ Exemple : Display("Vous pouvez actuellement voir %d lignes dans la liste", lstPartiesSauvees.RowCount); affichera le nombre de lignes que la liste Parties Sauvées peut afficher simultanément.\\ \\ // Voir aussi : // [[ListBox#ItemCount|ListBox.ItemCount]], [[ListBox#ScrollDown|ListBox.ScrollDown]], [[ListBox#ScrollUp|ListBox.ScrollUp]]\\ \\ ---- ====SaveGameSlots==== // (Anciennement global array savegameindex, désormais obsolète) // \\ \\ readonly int ListBox.SaveGameSlots[]; Contient le bloc de sauvegarde correspondant pour chaque ligne dans la liste.\\ \\ Cela est nécessaire puisque la commande FillSaveGameList trie la liste des parties sauvées pour placer la plus récente en premier. Ainsi, vous pouvez utiliser le tableau pour faire correspondre chaque ligne à la sauvegarde correspondante.\\ \\ ** NOTE : ** Vous devez utiliser la commande FillSaveGameList pour remplir ce tableau.\\ \\ Exemple : int index = lstPartiesSauvees.SelectedIndex; RestoreGameSlot(lstPartiesSauvees.SaveGameSlots[index]); chargera la sauvegarde actuellement sélectionnée dans la liste, en supposant que FillSaveGameList a été utilisé plus tôt.\\ \\ // Voir aussi : // [[ListBox#FillSaveGameList|ListBox.FillSaveGameList]], [[ListBox#SelectedIndex|ListBox.SelectedIndex]]\\ \\ ---- ====SelectedIndex==== // (Anciennement ListBoxGetSelected, désormais obsolète) // // (Anciennement ListBoxSetSelected, désormais obsolète) // \\ \\ int ListBox.SelectedIndex Retourne/Définit l'indice de la liste de la ligne actuellement sélectionnée. La première ligne est 0, la seconde 1, etc. Si aucune ligne n'est sélectionnée, cette propriété vaut -1.\\ \\ Vous pouvez lui donner la valeur -1 pour dé-sélectionner les lignes.\\ \\ Exemple : String texteSelectionne = lstOptions.Items[lstOptions.SelectedIndex]; retournera le texte de la ligne sélectionnée dans la liste.\\ \\ ---- ====TopItem==== // (Anciennement ListBoxSetTopItem, désormais obsolète) // \\ \\ int ListBox.TopItem Retourne/Définit la ligne du haut dans la liste. La ligne du haut est la première ligne visible dans la liste, qui varie donc lorsque vous la faîtes défiler vers le haut ou vers le bas.\\ \\ Les valeurs pour TopItem commencent à 0 pour la première ligne de la liste.\\ \\ Exemple : lstPartiesSauvees.TopItem = 0; fera automatiquement défiler la liste // lstPartiesSauvees // tout en haut. {{tag>français}}