DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Champs, pages et fenêtres / Fonctions Table
  • Conditions d'utilisation
  • Afficher une ligne en premier (syntaxe 1)
  • Bandeau de sélection et fonction <Table>.Position
  • Champ Table fichier : limitations de la fonction <Table>.Position
  • Evénement "Entrée en saisie d'une 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
Affiche un champ Table ou Table hiérarchique à partir d'une ligne spécifiée ou renvoie l'indice de la première ligne affichée dans un champ Table ou Table hiérarchique.
WEBDEV - Code Navigateur Cette fonction est disponible uniquement pour les champs Table navigateur.
Exemple
// Indice de la première ligne affichée dans le champ "TABLE_Produit"
ResPosition = TABLE_Produit.Position()
Syntaxe

Afficher un champ Table ou Table hiérarchique à partir d'une ligne spécifiée Masquer les détails

<Champ Table>.Position(<Indice> [, <Option>])
<Champ Table> : Nom de champ
Nom du champ Table ou Table hiérarchique à manipuler.
<Indice> : Entier
Indice de la ligne qui doit être affichée dans le champ. Par défaut, cette ligne est affichée en premier.
Si <Indice> est supérieur au nombre de lignes présentes dans le champ (connu avec la fonction <Table>.Occurrence), la dernière ligne est sélectionnée par défaut.
<Option> : Constante de type Entier
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateuriPhone/iPadPHP Position de la ligne dans le champ :
taPremier
(Valeur par défaut)
La ligne spécifiée par <Indice> est affichée en premier dans le champ Table/Table hiérarchique.
taVisibleLa ligne spécifiée par <Indice> devient visible dans le champ Table/Table hiérarchique. Elle est affichée :
  • en premier (si <Indice> est inférieur à la ligne en cours).
  • en dernier (si <Indice> est supérieur à la ligne en cours).
Si la ligne est déjà visible, l'affichage du champ Table/Table hiérarchique ne change pas.

Connaître l'indice de la première ligne affichée dans un champ Table ou Table hiérarchique Masquer les détails

<Résultat> = <Champ Table>.Position()
<Résultat> : Entier
Indice de la première ligne affichée dans le champ spécifié.
PHP Dernière valeur de <Indice> spécifié dans la syntaxe permettant d'afficher une ligne. Il n'est pas possible de connaître le première ligne réellement affichée suite à l'utilisation de l'ascenseur du champ Table.
<Champ Table> : Nom de champ
Nom du champ Table ou Table hiérarchique à manipuler.
Remarques

Conditions d'utilisation

La fonction <Table>.Position peut être utilisée indifféremment :
  • 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 "classiques".

Afficher une ligne en premier (syntaxe 1)

La ligne affichée en premier peut être différente de celle demandée. En effet, la fonction <Table>.Position essaie d'afficher un nombre maximum de lignes dans le champ.
La fonction <Table>.Position n'affichera la ligne spécifiée que si cette ligne est suivie d'un nombre suffisant de lignes non vides. Dans l'exemple suivant, la ligne "Durand" ne peut pas être affichée au début du champ Table.

Bandeau de sélection et fonction <Table>.Position

La fonction <Table>.Position ne modifie pas la ligne en cours (c'est-à-dire la ligne sélectionnée à l'aide du bandeau de sélection).
Ainsi, si le champ Table a le focus lorsque la fonction <Table>.Position est exécutée, la ligne en cours devra être visible en même temps que la ligne spécifiée. Si la ligne en cours et la ligne spécifiée ne peuvent pas être affichées en même temps, le contenu du champ sera affiché à partir de la ligne en cours (et non à partir de la ligne <Indice>).
WINDEVEtats et RequêtesJavaCode Utilisateur (MCU)

Champ Table fichier : limitations de la fonction <Table>.Position

La fonction <Table>.Position ne fonctionne pas pour les champs Table fichier en mode "manuel" qui utilisent un ascenseur à rebond (option "Ascenseur proportionnel" non cochée dans l'onglet "Détail" de la description du champ).
Rappel :
  • Un champ Table fichier en mode "manuel" est un champ qui est relié par programmation à un fichier de données.
  • Avec un ascenseur à rebond, il est possible de faire défiler l'ascenseur en gardant le bouton de la souris enfoncé sur le bouton de l'ascenseur ou en gardant la touche flèche haut ou flèche bas appuyée.

Evénement "Entrée en saisie d'une ligne"

  • La fonction <Table>.Position ne force pas l'exécution de l'événement "Entrée en saisie d'une ligne".
  • La fonction <Table>.Position ne peut pas être utilisée dans l'événement "Entrée en saisie d'une ligne" du champ (le résultat retourné est incorrect).
Composante : wd290obj.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