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"
  • Sélection au niveau de la cellule
  • 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"
TABLE_TableProduit.SelectPlus(5)
// Sélection des lignes 5 et 7 
// dans le champ Table multisélection "TABLE_TableProduit"
TABLE_TableProduit.SelectPlus(5, 7)
Syntaxe
<Champ Table>.SelectPlus([<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.
<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 <Table>.SelectPlus est sans effet. L'indice d'une ligne sélectionnée peut être obtenu avec la fonction <Table>.Select.
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 <Table>.SelectPlus est sans effet. L'indice d'une ligne sélectionnée peut être obtenu avec la fonction <Table>.Select.
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 <Table>.SelectPlus 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 <Table>.SelectPlus :
    <Champ Table>.SelectPlus(<Champ Table>.Occurrence)
  • Propriété Occurrence :
    <Champ Table> = <Champ Table>.Occurrence
  • Fonction <Table>.Occurrence :
    <Champ Table> = <Champ Table>.Occurrence()

É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 :
<Champ Table>.SelectPlus(<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 <Table>.SelectPlus.
WINDEVJava

Sélection au niveau de la cellule

Dans le cas d'un champ Table utilisant un mode de sélection "Sélection multiple" pour les cellules, la propriété Sélectionnée permet de savoir si une cellule est sélectionnée ou de sélectionner une cellule par programmation.
Par exemple :
// Exemple de sélection d'une cellule
TABLE_ListeClients[3,2].Sélectionnée = Vrai

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 <Source>.LitRecherche.
  2. Utiliser la fonction <Table>.Affiche 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 
    TABLE_ListeClients.SelectPlus(3, 4, 5)
Composante : wd300obj.dll
Version minimum requise
  • Version 23
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 16/06/2023

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