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 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.
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

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é.
<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.

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>).
Etats et Requêtes

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 : wd300obj.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 06/03/2023

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