PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

Accueil | Connexion | Français FR
  • Conditions d'utilisation
  • Afficher une ligne en premier (syntaxe 1)
  • Bandeau de sélection et fonction TablePosition
  • Champ Table fichier : limitations de la fonction TablePosition
  • 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.
Versions 15 et supérieures
PHP Cette fonction est désormais disponible pour les sites PHP.
Nouveauté 15
PHP Cette fonction est désormais disponible pour les sites PHP.
PHP Cette fonction est désormais disponible pour les sites PHP.
Versions 16 et supérieures
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Nouveauté 16
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Linux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
Versions 18 et supérieures
WEBDEV - Code ServeurPHP Cette fonction permet désormais de manipuler les champs Table hiérarchique dans les sites WEBDEV et PHP.
Nouveauté 18
WEBDEV - Code ServeurPHP Cette fonction permet désormais de manipuler les champs Table hiérarchique dans les sites WEBDEV et PHP.
WEBDEV - Code ServeurPHP Cette fonction permet désormais de manipuler les champs Table hiérarchique dans les sites WEBDEV et PHP.
Versions 20 et supérieures
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 20
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Android Cette fonction est désormais disponible pour les applications Android.
iPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Exemple
// Indice de la première ligne affichée dans le champ "TABLE_Produit"
ResPosition = TablePosition(TABLE_Produit)
Syntaxe

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

TablePosition(<Champ Table> , <Indice> [, <Option>])
<Champ Table> : Nom de champ
Nom du champ Table ou Table hiérarchique à manipuler.
Si ce paramètre correspond à une chaîne vide (""), le champ manipulé est le champ Table auquel appartient l'événement en cours.
<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 TableOccurrence), la dernière ligne est sélectionnée par défaut.
<Option> : Constante de type Entier
Versions 22 et supérieures
WINDEVWEBDEV - Code ServeuriPhone/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.
Versions 22 et supérieures
taVisible
Nouveauté 22
taVisible
taVisible		La 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.
Nouveauté 22
WINDEVWEBDEV - Code ServeuriPhone/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.
Versions 22 et supérieures
taVisible
Nouveauté 22
taVisible
taVisible		La 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.
WINDEVWEBDEV - Code ServeuriPhone/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.
Versions 22 et supérieures
taVisible
Nouveauté 22
taVisible
taVisible		La 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> = TablePosition(<Champ Table>)
<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.
Si ce paramètre correspond à une chaîne vide (""), le champ manipulé est le champ Table auquel appartient l'événement en cours.
Remarques

Conditions d'utilisation

La fonction TablePosition 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".
AndroidiPhone/iPad Le champ Table hiérarchique n'est pas disponible.
WEBDEV - Code Serveur La fonction TablePosition peut être utilisée uniquement avec un champ Zone répétée Classique sans ascenseur.

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 TablePosition essaie d'afficher un nombre maximum de lignes dans le champ.
La fonction TablePosition 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 TablePosition

La fonction TablePosition 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 TablePosition 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 TablePosition

La fonction TablePosition 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 TablePosition ne force pas l'exécution de l'événement "Entrée en saisie d'une ligne".
  • La fonction TablePosition 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).
Classification Métier / UI : Code UI
Composante : wd270obj.dll
Voir Aussi
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire