CHANGER PROPRIETES ELEMENT

version 2004 (Modifiée)

CHANGER PROPRIETES ELEMENT (liste; réfElément | *; saisissable; styles; icône{; couleur})

La commande CHANGER PROPRIETES ELEMENT modifie l'élément désigné par le paramètre réfElément de la liste dont vous avez passé le numéro de référence dans liste.

Vous pouvez passer un numéro de référence dans réfElément. Si ce numéro ne correspond à aucun élément de la liste, la commande ne fait rien.

Vous pouvez également passer 0 dans réfElément afin de demander la modification du dernier élément ajouté à la liste (à l'aide de AJOUTER A LISTE).

Vous pouvez enfin passer * dans réfElément : dans ce cas, la commande s'appliquera à l'élément courant de la liste. Si plusieurs éléments sont sélectionnés manuellement, l'élément courant est celui qui a été sélectionné en dernier. Si aucun élément n'est sélectionné, la commande ne fait rien.

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.

Note : Pour changer le libellé d'un élément ou de ses sous-listes, utilisez la commande CHANGER ELEMENT.

Si vous souhaitez que l'élément soit saisissable, passez Vrai dans le paramètre saisissable, sinon passez Faux.

Important : Pour qu'un élément soit saisissable, il doit appartenir à une liste elle-même saisissable. Pour déclarer une liste saisissable, utilisez la commande CHOIX SAISISSABLE. La commande CHANGER PROPRIETES ELEMENT vous permet de déclarer un élément individuel saisissable ou non. La modification de la propriété saisissable au niveau de la liste ne change pas la propriété saisissable individuelle de chaque élément. Un élément ne peut être saisissable que si la liste et l'élément le sont.

Vous pouvez définir le style de l'élément dans le paramètre styles. Vous passez une ou une combinaison des constantes prédéfinies suivantes (thème Styles de caractères) :

Note : Sous Windows, seuls les styles Standard ou une combinaison de Gras, Italique et Souligné sont disponibles. En outre, les styles Condensé et Ombré ne sont plus pris en charge et sont conservés pour des raisons de compatibilité uniquement.

Si vous souhaitez associer une icône à l'élément, passez une des valeurs numériques suivantes dans le paramètre icône :

• N, où N est le numéro d'une ressource Mac OS 'cicn'

• Utiliser ressource PICT+N, où N est le numéro d'une ressource Mac OS 'PICT'.

• Utiliser réf image+N, où N est le numéro de référence d'une image stockée dans la bibliothèque d'images de 4D, en mode Structure.

• Si vous ne souhaitez pas associer d'image à l'élément, passez 0 (zéro) dans icône.

Note : Utiliser ressource PICT et Utiliser réf image sont des constantes prédéfinies placées dans le thème Listes hiérarchiques.

Le paramètre couleur (facultatif) permet de modifier la couleur du texte de l'élément. La couleur doit être définie sous forme de couleur RVB, c'est-à-dire un entier long de 4 octets au format 0x00RRVVBB. Pour plus d'informations sur ce format, reportez-vous à la description de la commande FIXER COULEURS RVB. Passez -1 dans le paramètre couleur pour rétablir la couleur d'origine de l'élément.

(1) Reportez-vous à l'exemple de la commande AJOUTER A LISTE.

(2) L'exemple suivant passe le texte de l'élément courant de liste en gras et en rouge vif :

   CHANGER PROPRIETES ELEMENT(liste;*;Vrai;Gras;0;0x00FF0000)
   REDESSINER LISTE(liste)

CHANGER ELEMENT, LIRE PROPRIETES ELEMENT.