PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • Présentation
  • Initialiser un champ Liste image
  • Initialiser un élément
  • Remplir un champ Liste image
  • Sélectionner un élément dans un champ Liste image
  • Se positionner sur le dernier élément du champ Liste image
  • Récupérer l'élément sélectionné dans le champ Liste image
  • Récupérer l'indice de l'élément sélectionné
  • Récupérer la valeur de l'élément sélectionné
  • Propriétés spécifiques à la gestion des champs Liste image
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Manipuler un champ Liste Image par programmation (syntaxe objet)
Présentation
WINDEV permet de manipuler un champ Liste Image directement par programmation. Il suffit d'utiliser directement la variable du champ Liste Image dans le code. Cette variable est de type numérique.
La variable du champ Liste Image :
  • correspond au nom du champ Liste Image.
  • est initialisée avec l'indice de l'élément sélectionné dans le champ Liste image.
Remarque : Pour manipuler un élément d'un champ Liste image auquel aucune rubrique mémorisée n'est associée, il suffit d'utiliser la notation suivante :
<Nom de la Liste Image> [ <Indice de l'élément>]
Initialiser un champ Liste image

Initialiser un élément

Pour initialiser un élément d'un champ Liste image, utilisez la fonction <Liste>.Ajoute.
LSI_ListeImage1.Ajoute("Soleil", "C:\IMG\Soleil.JPG")
LSI_ListeImage1.Ajoute(Photo)

Remplir un champ Liste image

Pour initialiser un champ Liste image, il suffit d'utiliser une boucle d'itération pour initialiser tous les éléments du champ.
Indice est un entier
POUR Indice = <Position Début> A <Position Fin>
<Nom Liste Image>.Ajoute(<Valeur>, <Image>)
FIN
i est un entier
POUR i = 1 À 52
LSI_ListeImage1.Ajoute(NOM[i], Image[i])
FIN
Sélectionner un élément dans un champ Liste image
Pour sélectionner l'élément de la ligne <Indice>, utilisez :
  • soit l'affectation directe :
    <Nom Liste Image> = Indice
  • soit la fonction <Liste>.SelectPlus :
    <Nom Liste Image>.SelectPlus(<Indice>)

Se positionner sur le dernier élément du champ Liste image

Pour se positionner sur le dernier élément du champ Liste image, utilisez :
Récupérer l'élément sélectionné dans le champ Liste image

Récupérer l'indice de l'élément sélectionné

Pour récupérer l'indice de l'élément sélectionné, utilisez :
  • soit la lecture directe de l'élément :
    Indice = <Nom Liste Image>
  • soit la fonction <Liste>.Select :
    Indice = <Nom Liste Image>.Select()
Remarque : Pour les Champs Liste image multi-sélection, la fonction <Liste>.Select permet de récupérer les éléments sélectionnés.
// Récupérer les éléments d'un champ Liste Image multi-sélection
Rang est un entier = 0  // numéro de la sélection
Indice est un entier = 0  // indice de l'élément sélectionné
BOUCLE
Rang = Rang + 1
Indice = LSI_ListeImage1.Select(Rang)
SI Indice = -1 ALORS SORTIR
FIN

Récupérer la valeur de l'élément sélectionné

Pour récupérer la valeur de l'élément sélectionné, utilisez une des syntaxes suivants :
  • Syntaxe 1 :
    Indice est un entier = <Nom Liste Image>
    <Variable> = <Nom Liste Image>[Indice]
  • Syntaxe 2 :
    <Variable> = <Nom Liste Image>[<Nom Liste Image>]
  • Syntaxe 3 : Propriété ..ValeurAffichée
    <Variable> = <Nom Liste Image>..ValeurAffichée

    Attention : La valeur mémorisée en programmation peut être différente de la valeur affichée. Pour connaître la valeur mémorisée correspondant à une des lignes du champ Liste image, utilisez la propriété ..ValeurMémorisée.
Propriétés spécifiques à la gestion des champs Liste image
Les propriétés suivantes sont spécifiques à la gestion des champs Liste image :
Tout type de Liste image
MémoirePermet de savoir si le champ spécifié est un champ Liste image mémoire ou fichier.
ModeListeImageChange le mode d'affichage du champ Liste image (mode liste image, mode liste classique, mode panorama).
OccurrencePermet de connaître le nombre de lignes présentes dans un champ Liste image.
OrientationVerticalePermet de connaître et de modifier l'orientation d'un champ Liste image.
TypeRemplissagePermet de connaître le type de remplissage (fichier, mémoire, variable) d'un champ Liste image.
ValeurAffichéePermet de connaître la valeur de la ligne en cours ou d'une ligne spécifique du champ Liste image.
VidePermet de savoir si un champ Liste image est vide.
Liste image mémoire uniquement
TriéePermet de savoir si un champ Liste image mémoire est triée et de trier un champ Liste image mémoire (Tri réalisé en fonction des libellés des éléments).
Liste image Fichier uniquement
FichierParcouruPermet de connaître et de modifier le fichier ou la requête utilisé pour l'affichage des enregistrements dans les listes image fichier.
ParcoursAutoPermet de savoir si le parcours d'un champ Liste image fichier est automatique ou programmé.
RubriqueAffichéePermet de connaître ou de modifier la rubrique correspondant au libellé affiché dans un champ Liste image.
RubriqueAffichéeImagePermet de connaître ou de modifier la rubrique correspondant à l'image affichée dans un champ Liste image.
RubriqueMémoriséePermet de connaître ou de modifier la rubrique mémorisée d'un champ Liste image.
RubriqueParcouruePermet de connaître et de modifier la rubrique utilisée pour le parcours automatique des champs Liste image.

Pour connaître la liste complète des propriétés du WLangage pouvant être utilisées avec un champ de type Liste Image, consultez Propriétés associées au champ Liste Image.
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire