PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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
  • Traitement d'entrée de ligne
Produits
WINDEVWEBDEV - Code ServeurWEBDEV - Code NavigateurWINDEV MobileEtats et Requêtes
Plateformes
WindowsLinuxWindows MobileUniversal Windows 10 AppAndroidWidget AndroidiPhone/iPadApple Watch
Langages
JavaPHPAjaxCode Utilisateur (MCU)Langage Externe
Bases de données
HFSQLHFSQL Client/ServeurProcédures stockéesOLE DBODBCAccès Natifs
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
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Nouveauté 20
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
Exemple
// Indice de la première ligne affichée dans la table "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(<Nom de la table> , <Indice>)
<Nom de la table> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ Table ou Table hiérarchique à manipuler.
Si ce paramètre correspond à une chaîne vide (""), la table manipulée est la table à laquelle appartient le traitement en cours.
<Indice> : Entier
Indice de la ligne qui doit être affichée en premier dans la table.
Si ce paramètre est supérieur au nombre de lignes présentes dans la table (connu avec la fonction TableOccurrence), la dernière ligne est sélectionnée par défaut.

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

TablePosition(<Nom de la table> , <Indice> [, <Option>])
<Nom de la table> : Chaîne de caractères (avec ou sans guillemets)
Nom du champ Table ou Table hiérarchique à manipuler.
Si ce paramètre correspond à une chaîne vide (""), la table manipulée est la table à laquelle appartient le traitement en cours.
<Indice> : Entier
Indice de la ligne qui doit être affichée dans la table. Par défaut, cette ligne est affichée en premier.
Si <Indice> est supérieur au nombre de lignes présentes dans la table (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
WINDEVWindows MobileiPhone/iPad Position de la ligne dans la table :
taPremier
(Valeur par défaut)
La ligne spécifiée par <Indice> est affichée en premier dans la table.
Versions 22 et supérieures
taVisible
Nouveauté 22
taVisible
taVisible
La ligne spécifiée par <Indice> devient visible dans la table. 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 de la table en change pas.
Nouveauté 22
WINDEVWindows MobileiPhone/iPad Position de la ligne dans la table :
taPremier
(Valeur par défaut)
La ligne spécifiée par <Indice> est affichée en premier dans la table.
Versions 22 et supérieures
taVisible
Nouveauté 22
taVisible
taVisible
La ligne spécifiée par <Indice> devient visible dans la table. 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 de la table en change pas.
WINDEVWindows MobileiPhone/iPad Position de la ligne dans la table :
taPremier
(Valeur par défaut)
La ligne spécifiée par <Indice> est affichée en premier dans la table.
Versions 22 et supérieures
taVisible
Nouveauté 22
taVisible
taVisible
La ligne spécifiée par <Indice> devient visible dans la table. 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 de la table en 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(<Nom de la table>)
<Résultat> : Entier
Indice de la première ligne affichée dans la table spécifiée.
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 de la table.
<Nom de la table> : Chaîne de caractères (avec ou sans guillemets)
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 le traitement en cours.
Remarques

Conditions d'utilisation

La fonction TablePosition peut être utilisée indifféremment :
  • un champ fichier ou mémoire,
  • un champ mono-sélection ou multi-sélection.
WEBDEV - Code ServeurPHP Rappel : Les champs multi-sélections sont disponibles uniquement en Ajax.
WEBDEV - Code ServeurPHP Rappel : La multi-sélection n'est pas disponible sur les champs Table "classiques".
AndroidiPhone/iPad Le champ Table hiérarchique n'est pas disponible.

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>).
WINDEVWINDEV MobileEtats et RequêtesWindows MobileJavaCode 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.

Traitement d'entrée de ligne

  • La fonction TablePosition ne force pas l'exécution du traitement d'entrée de ligne du champ.
  • La fonction TablePosition ne peut pas être utilisée dans le traitement d'entrée de ligne (le résultat retourné est incorrect).
Composantes
WINDEVEtats et Requêtes wd220obj.dll
WEBDEV - Code Serveur wd220page.dll
Windows Mobile wp220obj.dll
Java wd220java.jar
Linux wd220obj.so
Android wd220android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire