StepChoiceSelection
Formulaires, interaction
Description
Déplace l'option sélectionnée d'un champ de choix visible et inscriptible du delta demandé
La valeur actuelle du champ est rapprochée des noms d'exportation et des noms affichés de toutes les options configurées ; quand aucune option ne correspond, un delta négatif saute à la dernière option tandis qu'un delta non négatif sélectionne la première
La cible résultante est bornée dans la liste d'options, la nouvelle valeur provient du nom d'exportation de l'option ou de son nom affiché quand aucun nom d'exportation n'existe, et une valeur inchangée se termine sans action ni édition
Une valeur changeante focalise et édite le champ, dispatche l'action de frappe /K du widget, stocke la nouvelle valeur transitoire et termine avec CommitEdit ; /V, /F et OnValueChanged passent donc par le chemin de validation normal
/K est soumis à un veto pour un champ qui n'était pas en cours d'édition auparavant, l'édition fraîchement commencée est annulée à nouveau
Déclaration
function StepChoiceSelection(FieldIndex, Delta: Integer): Integer;Paramètres
| FieldIndex | Index de champ ou de Widget temporaire d'un champ de liste visible et inscriptible |
|---|---|
| Delta | Nombre d'options à parcourir, négatif pour un déplacement en arrière et positif pour un déplacement en avant |
Valeur de retour
Retourne 1 lorsque l'étape de sélection s'est terminée ou que la valeur correspondait déjà, et 0 lorsque le champ est invalide, n'est pas un champ de liste, est en lecture seule, n'a aucune option, ou qu'une action distribuée ou la validation a rejeté le changement
Exemple
// Keyboard path used by DispatchInputEvent for choice fields
Steps := -1; // fikUp moves to the previous option
Handled := Session.StepChoiceSelection(FieldIndex, Steps) = 1;Voir aussi
CommitEdit, SetEditValue, DispatchInputEvent, BeginEdit, OnValueChanged