4D Doc Center : ch_SELECTIONNER

4D Chart v13

ch_SELECTIONNER


ch_SELECTIONNER ( zone ; cible ; action )

Paramètre	Type	Description
zone	Entier long	Zone 4D Chart
cible	Entier long	Cible de la commande -1 = Tout, 0 = Objets sélectionné, >0 = ID de l’objet
action	Entier	Sélectionner ou désélectionner l’objet ? 0 = Désélectionner, 1 = Sélectionner, 2 = Inverser

Description

La commande ch_SELECTIONNER sélectionne ou désélectionne les objets désignés par cible et zone.

Si cible est égal à -1, tous les objets contenus dans le document sont affectés.
Si cible est égal à 0, les objets sélectionnés sont affectés.
Si cible est supérieur à 0, il doit être égal à l’identifiant d’un objet spécifique et ce dernier est affecté. Si l’objet n’existe pas, la commande est inopérante.

Le(s) objet(s) décrit(s) par cible sont sélectionnés ou désélectionnés selon la valeur du paramètre action. Ils sont désélectionnés si action est égal à 0, et sélectionnés si action est égal à 1. Et si action est égal à 2, les objets sélectionnés sont désélectionnés, et réciproquement.

Les objets hors du domaine de cible ne sont pas affectés. Autrement dit, ceux qui sont déjà sélectionnés dans zone et ne sont pas spécifiés dans cible, restent sélectionnés.

Exemple

L’exemple suivant désélectionne tous les objets dans le document puis sélectionne l’objet dont le numéro d’identifiant est égal à 1.

 ch_SELECTIONNER(Zone;-1;0)

 ch_SELECTIONNER(Zone;1;1)