DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Conditions d'utilisation
  • Se positionner sur la dernière ligne du champ Table ou Table hiérarchique
  • Équivalence avec la fonction TableSelectPlus
  • Cas particulier : Champ Table avec ascenseur à rebond
  • Evénement "Sélection d'une ligne"
  • Champ Table fichier de plus de 10 000 lignes
  • Sélecteur de ligne
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Sélectionne une ligne dans un champ Table ou Table hiérarchique. La ligne sélectionnée correspond à la ligne en cours sur laquelle le bandeau de sélection est affiché.
Exemple
// Sélection de la ligne 5 dans le champ "TABLE_TableProduit"
TableSelectPlus(TABLE_TableProduit, 5)
// Sélection des lignes 5 et 7
// dans le champ Table multisélection "TABLE_TableProduit"
TableSelectPlus(TABLE_TableProduit, 5, 7)
Syntaxe
TableSelectPlus(<Champ Table> [, <Indice 1> [... [, <Indice N>]]])
<Champ Table> : Nom de champ
Nom du champ à manipuler. Ce champ peut correspondre à :
  • un champ Table.
  • un champ Table hiérarchique.
Si ce paramètre correspond à une chaîne vide (""), le champ manipulé est le champ auquel le traitement en cours appartient.
<Indice 1> : Entier optionnel
Indice de la première ligne à sélectionner.
Si les paramètres <Indice 1> et <Indice N> ne sont pas précisés, toutes les lignes du champ sont sélectionnées.
Si les paramètres <Indice 1> et <Indice N> correspondent à des lignes déjà sélectionnées, la fonction TableSelectPlus est sans effet. L'indice d'une ligne sélectionnée peut être obtenu avec la fonction TableSelect.
Si ce paramètre correspond à -1, la ligne "en cours" (celle qui a le focus) est sélectionnée.
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP Si le champ est un champ Table "Serveur", un seul indice peut être spécifié.
<Indice N> : Entier optionnel
Indice de la Nième ligne à sélectionner.
Si les paramètres <Indice 1> et <Indice N> ne sont pas précisés, toutes les lignes du champ spécifié sont sélectionnées.
Si les paramètres <Indice 1> et <Indice N> correspondent à des lignes déjà sélectionnées, la fonction TableSelectPlus est sans effet. L'indice d'une ligne sélectionnée peut être obtenu avec la fonction TableSelect.
WEBDEV - Code ServeurWEBDEV - Code NavigateurPHP Si le champ est un champ Table "Serveur", un seul indice peut être spécifié.
Remarques

Conditions d'utilisation

La fonction TableSelectPlus peut être utilisée indifféremment sur :
  • un champ Table ou Table hiérarchique fichier.
  • un champ Table ou Table hiérarchique par programmation.
  • un champ monosélection ou multisélection.
    WEBDEV - Code ServeurPHP Rappel : La multisélection n'est pas disponible sur les champs Table en mode "Serveur".
WEBDEV - Code ServeurPHP Cette fonction est disponible pour les champs Table en mode "Serveur + AJAX", les champs Table en mode "Serveur" et les champs Table hiérarchique.
WEBDEV - Code Navigateur Cette fonction est disponible uniquement pour les champs Table en mode "Navigateur".
WEBDEV - Code Navigateur Le champ Table hiérarchique n'est pas disponible.

Se positionner sur la dernière ligne du champ Table ou Table hiérarchique

Pour se positionner sur la dernière ligne d'un champ Table ou Table hiérarchique, les syntaxes suivantes sont possibles :
  • Fonction TableSelectPlus :
    TableSelectPlus(<Champ Table>, <Champ Table>.Occurrence)
  • Propriété Occurrence :
    <Champ Table> = <Champ Table>.Occurrence
  • Fonction TableOccurrence :
    <Champ Table> = TableOccurrence(<Champ Table>)

Équivalence avec la fonction TableSelectPlus

Dans le cas d'un champ Table ou Table hiérarchique monosélection (sans rubrique mémorisée), les deux syntaxes suivantes sont équivalentes :
TableSelectPlus(<Champ Table>, <Indice>)

<Champ Table> = <Indice>

Cas particulier : Champ Table avec ascenseur à rebond

La sélection d'une ligne non visible dans le champ Table ne donne pas le focus à la ligne sélectionnée.
Remarque : Il est conseillé d'utiliser un champ Table avec un ascenseur proportionnel.

Evénement "Sélection d'une ligne"

L'événement "Sélection d'une ligne" n'est pas exécuté lors de l'appel de la fonction TableSelectPlus.

Champ Table fichier de plus de 10 000 lignes

Dans un champ Table fichier de plus de 10 000 lignes, pour des raisons de performances, le positionnement dans le champ Table est approximatif.
Pour un positionnement exact, il est nécessaire de :
  1. Faire une recherche avec la fonction HLitRecherche.
  2. Utiliser la fonction TableAffiche avec la constante taCourantBandeau.

Sélecteur de ligne

Lorsque le style du champ Table contient un sélecteur de ligne, la flèche à gauche est positionnée sur :
  • la dernière ligne sélectionnée lorsque la sélection multiple est faite à la souris ou au clavier,
  • la ligne à laquelle le "focus" est donné en affectant le champ Table. Par exemple :
    // Positionne le sélecteur de ligne sur la 3ème ligne
    // Et sélectionne les lignes 3, 4 et 5
    TABLE_ListeClients = 3
    TableSelectPlus(TABLE_ListeClients, 3, 4, 5)
Composante : wd300obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 14/06/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale