StepChoiceSelection
Moduli, interazione
Descrizione
Sposta l'opzione selezionata di un campo di scelta visibile e scrivibile del delta richiesto
Il valore corrente del campo viene confrontato con i nomi di esportazione e i nomi mostrati di tutte le opzioni configurate, e quando nessuna opzione corrisponde, un delta negativo salta all'ultima opzione mentre un delta non negativo seleziona la prima
La destinazione risultante viene limitata nella lista di opzioni, il nuovo valore si prende dal nome di esportazione dell'opzione o dal suo nome mostrato quando non esiste nome di esportazione, e un valore invariato completa senza azione né modifica
Un valore che cambia focalizza e modifica il campo, dispaccia l'azione di battitura /K del widget, memorizza il nuovo valore transitorio e termina con CommitEdit, così /V, /F e OnValueChanged girano per il normale percorso di commit
/K subisce un veto per un campo che non era in modifica prima, la modifica appena avviata viene annullata di nuovo
Dichiarazione
function StepChoiceSelection(FieldIndex, Delta: Integer): Integer;
Parametri
| FieldIndex | Indice del campo o Widget temporaneo di un campo di scelta visibile e scrivibile |
|---|---|
| Delta | Numero di opzioni di cui spostare, negativo per passi all'indietro e positivo in avanti |
Valore restituito
Restituisce 1 quando il passo di selezione è completato o il valore corrisponde già, e 0 quando il campo non è valido, non è un campo di scelta, è di sola lettura, non ha opzioni oppure un'azione inviata o un commit ha rifiutato il cambiamento
Esempio
// Keyboard path used by DispatchInputEvent for choice fields
Steps := -1; // fikUp moves to the previous option
Handled := Session.StepChoiceSelection(FieldIndex, Steps) = 1;
Vedere anche
CommitEdit, SetEditValue, DispatchInputEvent, BeginEdit, OnValueChanged