Position deposer

4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant

version 2004.2 (Modifiée)


Position deposer {(numColonne)} Numérique

ParamètreTypeDescription
numColonneEntier longNuméro de colonne de list box ou
-1 si le déposer a lieu après la dernière colonne
RésultatNumériqueNuméro (tableau/list box) ou position (liste) de l'élément
de destination ou -1 si le déposer a lieu après le dernier
élément de tableau ou de liste

Description

Position deposer permet de connaître l'emplacement, dans un objet de destination "complexe", auquel un objet a été (glissé et) déposé. Généralement, vous utiliserez Position deposer pendant le traitement d'un événement glisser-déposer qui s'est produit dans un tableau, une list box ou une liste hiérarchique.

Si l'objet de destination est un tableau, la fonction retourne un numéro d'élément.

Si l'objet de destination est une list box, la fonction retourne un numéro de ligne. Dans ce cas, la fonction retourne également dans le paramètre facultatif numColonne le numéro de la colonne sur laquelle le déposer a eu lieu.

Si l'objet de destination est une liste hiérarchique, la fonction retourne une position d'élément.

Dans tous les cas, la fonction retourne -1 si l'objet source a été déposé après le dernier élément de l'objet de destination.

Si vous appelez Position deposer pendant le traitement d'un événement qui n'est pas de type glisser-déposer dans un tableau, une list box ou une liste, la fonction retourne également -1.

Rappel : Pour qu'un objet de formulaire accepte des données déposées, la propriété Déposable doit lui avoir été assignée. De plus, sa méthode objet doit être appelée par l'événement Sur glisser et/ou Sur déposer si vous voulez pouvoir gérer ce type d'événement.

Exemples

(1) Reportez-vous aux exemples de la commande PROPRIETES GLISSER DEPOSER.

(2) Dans l'exemple suivant, une liste de sommes doit être ventilée par mois et par personne. L'opération s'effectue par glisser-déposer depuis une zone de défilement :

La méthode objet de la list box contient le code suivant :

   Au cas ou 
   :(Evenement formulaire=Sur glisser )
      PROPRIETES GLISSER DEPOSER($source;$lignetab;$numprocess)
      Si ($source=Pointeur vers("ZD1")) `Si le déposer provient bien de la zone de défilement
         $0:=0
      Sinon
         $0:=-1 `On refuse le déposer
      Fin de si 
   :(Evenement formulaire=Sur déposer )
      PROPRIETES GLISSER DEPOSER($source;$lignetab;$numprocess)
      $numligne:=Position deposer($numcol)
      Si ($numcol=1)
         BEEP
      Sinon 
         Au cas ou  `Addition des valeurs déposées
         : ($numcol=2)
            Jean{$numligne}:=Jean{$numligne}+ZD1{$lignetab}
         : ($numcol=3)
            Marc{$numligne}:=Marc{$numligne}+ZD1{$lignetab}
         : ($numcol=4)
            Pierre{$numligne}:=Pierre{$numligne}+ZD1{$lignetab}
         Fin de cas 
         SUPPRIMER LIGNES(ZD1;$lignetab) `Mise à jour de la zone
      Fin de si 
   Fin de cas 

Référence

Présentation du Glisser-Déposer, PROPRIETES GLISSER DEPOSER.


4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant