|
|
|
|
|
- Présentation
- Etat initial du champ Table
- Détail des options d'affichage
- Mode de sélection
- Options d'affichage des colonnes
- Gérer le remplissage d'un champ Table par programmation
- Afficher le détail d'une ligne dans une fenêtre interne
- Ascenseurs dans un champ Table
- Options conservées par compatibilité avec les anciennes versions
- Forcer le titre en mono-ligne
- Mode de saisie compatible 5.5
Caractéristiques des champs Table dans une fenêtre
Le champ Table permet aussi bien d'afficher et/ou de saisir des informations. Ces informations peuvent provenir d'une source de données, d'une variable WLangage ou elles peuvent également être déterminées par programmation. Cette page d'aide présente les principales caractéristiques pouvant être définies pour un champ Table présent dans une fenêtre : Il est également possible de définir la source des données affichée dans le champ. Pour plus de détails, consultez Contenu d'un champ Table. Etat initial du champ Table L'état initial d'un champ Table peut être : Cet état initial est défini lors de la création du champ et peut être modifié à tout moment dans l'onglet "UI" de la fenêtre de description du champ Table. Les différentes possibilités sont les suivantes : - Visible : Le champ Table sera visible ou non. Cette option peut être modifiée en programmation grâce à la propriété Visible.
- En saisie : L'utilisateur pourra saisir dans les différentes colonnes du champ si ces colonnes sont en saisie.
Le champ Table n'est pas disponible en saisie. Il est disponible en lecture seulement. - Sélection (sans saisie) : L'utilisateur ne pourra pas saisir dans les colonnes du champ. Il sera possible de sélectionner une ligne du champ :
- soit en cliquant sur cette ligne.
- soit en utilisant la fonction TableSelectPlus.
La ligne sera sélectionnée grâce au bandeau de sélection. Remarque : La valeur du champ Table correspond à la ligne sélectionnée. A chaque sélection, le code de sélection de ligne est exécuté.
- Ni saisie, ni sélection : L'utilisateur ne pourra pas saisir dans les colonnes du champ. Il sera possible de sélectionner une ligne du champ uniquement par programmation grâce à la fonction TableSelectPlus. Cette ligne sera sélectionnée grâce au bandeau de sélection. L'utilisateur ne pourra pas modifier la position du bandeau de sélection.
Remarque : La valeur du champ Table correspond à la ligne sélectionnée. Conseil : Cette option est conseillée lorsqu'il est nécessaire de mettre en valeur une ligne grâce au bandeau de sélection. - Grisé : Le champ Table et ses colonnes seront grisés. L'utilisateur ne pourra pas saisir d'informations dans le champ.
Détail des options d'affichage Mode de sélection Les modes de sélection déterminent comment les différents éléments d'un champ Table (ligne, colonne, cellule) pourront être sélectionnés aussi bien par l'utilisateur que par programmation. Ce mode de sélection est défini lors de la création du champ. Il peut être modifié à tout moment dans l'onglet "UI" de la fenêtre de description du champ Table.Les modes de sélection disponibles sont les suivants : - Sans sélection : Le bandeau de sélection ne sera pas affiché, cependant la ligne, la colonne ou la cellule sélectionnée aura le focus (elle sera entourée de pointillés). Il sera possible de sélectionner une ligne, une colonne ou une cellule par un clic sur cet élément ou par programmation.
- Sélection simple : La ligne, la colonne ou la cellule sélectionnée apparaîtra sous le bandeau de sélection. Il sera possible de sélectionner une ligne, une colonne ou une cellule par un clic sur cet élément ou par programmation.
- Sélection multiple : Il est possible de sélectionner simultanément plusieurs lignes, colonnes ou cellules du champ Table :
- grâce à la touche Maj si les lignes, colonnes ou cellules se suivent, et à la touche Ctrl pour si les éléments ne se suivent pas.
- par programmation.
Dans ce cas, il y aura autant de bandeaux de sélection que d'éléments sélectionnés.
Remarques : - Si vous tentez de réaliser une sélection multiple par programmation alors que le mode de sélection est "Sélection simple", une erreur du WLangage sera affichée.
- Lors d'une sélection multiple par cellule, pour sélectionner une ligne, il est nécessaire de sélectionner toutes les cellules de la ligne. Pour simplifier cette opération, il est possible d'afficher un sélecteur de ligne (onglet "Style", élément "Sélecteur de ligne", option "Sélecteur" correspondant à "Flèche à gauche").
La récupération des éléments sélectionnés se fera : - avec la fonction TableSelect. Les constantes tsLigne, tsColonne, tsLigneCellule et tsColonneCellule permettent de récupérer respectivement les informations sur les lignes, les colonnes et les cellules sélectionnées.
- avec la fonction TableSelectOccurrence. Les constantes tsLigne, tsColonne et tsCellule permettent de récupérer respectivement le nombre de lignes, colonnes et cellules sélectionnées.
Exemple : L'exemple suivant permet de récupérer le numéro de la ligne et celui de la colonne des cellules sélectionnées dans le champ Table. // Récupération du nombre de cellules sélectionnées NbSelectionne est un entier NbSelectionne = TableSelectOccurrence(TABLE_StatsFiliales, tsCellule) // Parcours des cellules sélectionnées POUR i = 1 _À_ NbSelectionne // Récupération de la ligne et de la colonne nLigne = TableSelect(TABLE_StatsFiliales, i, tsLigneCellule) nColonne = TableSelect(TABLE_StatsFiliales, i, tsColonneCellule) // Traitement ... FIN Options d'affichage des colonnes De nombreuses options sont disponibles pour paramétrer l'affichage des colonnes. Ces options sont disponibles dans l'onglet "Détail" de la fenêtre de description du champ Table. Ces options sont les suivantes : - Mémoriser la config. des colonnes : Cette option permet de mémoriser la configuration des colonnes (taille, ordre, etc.) à la fermeture de la fenêtre ou de l'application.
- Menu 'Sélectionner les colonnes...' : Cette option permet d'afficher un menu contextuel afin que l'utilisateur puisse sélectionner les colonnes à afficher ou a masquer dans le champ Table.
- Colonnes texte multilignes : Cette option permet de rendre les colonnes de texte multilignes. Ainsi, le texte est entièrement affiché dans la cellule s'il ne peut pas entrer dans la colonne.
- Nb. max. de lignes affichées dans une ligne : Dans la ligne d'un champ Table, il est possible d'afficher plusieurs lignes. Cette option permet de fixer le nombre de lignes affichées (évite par exemple d'avoir une cellule qui comporte 20 lignes, et qui augmente ainsi de manière démesurée la hauteur de la ligne).
- Nombre de colonnes fixées à gauche : Cette option permet d'indiquer le nombre de colonnes fixées à gauche. Ces colonnes seront "collées" au côté gauche du champ et ne pourront pas être déplacées. L'ascenseur horizontal du champ ne permettra pas de déplacer ces colonnes.
L'utilisateur peut également fixer ou "défixer" les colonnes via le curseur "Verrou" ou via l'option "Colonne fixée" du menu contextuel du titre de la colonne. Pour plus de détails, consultez Fixer les colonnes des champs Table. Il est également possible de fixer une colonne par programmation grâce à la fonction TableFixeColonne. Angle du titre des colonnes : Pour les colonnes ayant un titre important et un contenu de taille réduite, il est possible de réduire la taille des colonnes en inclinant le titre des colonnes (ou par exemple en le passant directement à la verticale). Il suffit d'indiquer l'angle voulu dans l'onglet "Détail" de la description du champ Table. Cette option est modifiable par programmation grâce à la propriété AngleTitre. ![WINDEV WINDEV](https://doc.pcsoft.fr/ext/images/fr/WD.png?-158481145) ![Android Android](https://doc.pcsoft.fr/ext/images/fr/ANDROID.png?385929803) Éditer les sur-entêtes de colonnes : Il est possible de définir des sur-entêtes de colonnes. Un sur-entête de colonnes est un titre supplémentaire affiché au-dessus du titre d'une ou plusieurs colonnes. Pour plus de détails, consultez Gestion des titres des colonnes dans un champ Table.
Remarque : Par défaut, les titres des colonnes sont multilignes. La hauteur de l'entête est automatiquement ajustée au nombre de lignes. Les titres de colonnes supportent le RTF. Ascenseurs dans un champ Table Options conservées par compatibilité avec les anciennes versions Forcer le titre en mono-ligne Par défaut, le titre des colonnes d'un champ Table est multiligne. L'option "Forcer le titre en monoligne (8)" permet de retrouver le comportement par défaut de la version 8. Sur les champs Table créés avec la version 8 (ou précédente), cette option doit être décochée pour obtenir un titre de colonnes multiligne.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|