|
|
|
|
|
|
|
|
|
|
version 6.0
CHANGER ELEMENT (liste; réfElément; textElément; nouvelRéf{; sous-liste; déployée})
| Paramètre | Type | Description | |
| liste | RéfListe |  | Numéro de référence de liste |
| réfElément | Numérique | | Numéro de référence d'élément ou |
| 0 pour le dernier élément ajouté à la liste | |||
| textElément | Alpha | | Nouveau libellé d'élément |
| nouvelRéf | Numérique | | Nouveau numéro de référence d'élément |
| sous_Liste | RéfListe | | Nouvelle sous-liste rattachée à l'élément ou |
| 0 = pas de sous-liste (détacher sous-liste courante) | |||
| ou -1 = pas de changement | |||
| déployée | Booléen | | Indique si la sous-liste doit être déployée/contractée |
Description
La commande CHANGER ELEMENT modifie l'élément dont vous avez passé le numéro de référence dans réfElément de la liste dont vous avez passé le numéro de référence dans liste.
Si le numéro de référence d'élément ne correspond à aucun élément de la liste, la commande ne fait rien. Vous pouvez passer 0 dans réfElément afin de demander la modification du dernier élément ajouté à la liste (à l'aide de AJOUTER A LISTE).
Si vous travaillez avec les numéros de référence des éléments, assurez-vous d'utiliser des numéros uniques, sinon vous ne pourrez pas différencier les éléments. Pour plus d'informations sur ce point, reportez-vous à la description de la commande AJOUTER A LISTE.
Vous pouvez passer le nouveau libellé de l'élément dans le paramètre textElément. Si vous souhaitez changer le numéro de référence de l'élément, passez la nouvelle valeur dans le paramètre nouvelRéf, sinon passez la même valeur que dans réfElément.
Si vous voulez associer une sous-liste à l'élément, passez le numéro de référence de la sous-liste dans le paramètre sous_Liste. Dans ce cas, vous devez également spécifier si la nouvelle sous-liste devra apparaître déployée ou contractée en passant respectivement Vrai ou Faux dans le paramètre déployée.
Si vous voulez dissocier de l'élément une sous-liste qui lui est actuellement rattachée, passez 0 (zéro) dans sous_Liste. Dans ce cas, il est conseillé d'avoir préalablement obtenu le numéro de référence de cette liste à l'aide de la commande INFORMATION ELEMENT, afin de pouvoir effacer la sous-liste avec la commande SUPPRIMER LISTE si vous n'en avez plus besoin.
Si vous ne souhaitez pas modifier les propriétés de sous-liste de l'élément, passez -1 dans le paramètre sous_Liste.
Exemples
(1) Nous supposons que hList est une liste dont les éléments ont des numéros de référence uniques. La méthode objet suivante d'un bouton ajoute une sous-liste à l'élément actuellement sélectionné dans la liste hList :
$vlItemPos:=Element selectionne(hList) Si ($vlItemPos>0) INFORMATION ELEMENT(hList;$vlItemPos;$vlItemRef;$vsItemText;$hSouslist;$vbExpanded) $vbNouvSousList:=Non(Liste existante($hSouslist)) Si ($vbNouvSousList) $hSouslist:=Nouvelle liste Fin de si vlUniqueRef:=vlUniqueRef+1 AJOUTER A LISTE($hSousList;"Nouvel élément";vlUniqueRef) Si ($vbNouvSousList) CHANGER ELEMENT(hList;$vlItemRef;$vsItemText;$vlItemRef;$hSouslist;Vrai) Fin de si SELECTIONNER ELEMENT PAR REFERENCE(hList;vlUniqueRef) REDESSINER LISTE(hList) Fin de si
(2) Reportez-vous à l'exemple de la commande INFORMATION ELEMENT.
(3) Reportez-vous à l'exemple de la commande AJOUTER A LISTE.
Référence
CHANGER PROPRIETES ELEMENT, INFORMATION ELEMENT, LIRE PROPRIETES ELEMENT.
|
|
|
|
|
|
|
|
|
|