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

FieldIndexIndice del campo o Widget temporaneo di un campo di scelta visibile e scrivibile
DeltaNumero 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