StepChoiceSelection

Formularze, interakcja

Opis

Przesuwa wybraną opcję widocznego, zapisywalnego pola wyboru o żądaną deltę

Bieżąca wartość pola jest dopasowywana do nazw eksportowych i nazw wyświetlanych wszystkich skonfigurowanych opcji, a gdy żadna opcja nie pasuje, ujemna delta skacze do ostatniej opcji, a niedodatnia wybiera pierwszą

Wynikowy cel jest docinany do listy opcji, nowa wartość pochodzi z nazwy eksportowej opcji albo z jej nazwy wyświetlanej, gdy nazwy eksportowej nie ma, a niezmieniona wartość kończy się bez żadnej akcji ani edycji

Zmieniająca się wartość skupia i edytuje pole, wyzwala akcję naciśnięcia klawisza Widget /K, zapisuje nową tymczasową wartość i kończy przez CommitEdit, więc /V, /F i OnValueChanged biegną normalną ścieżką zatwierdzania

Gdy /K dostanie weto dla pola wcześniej nieedytowanego, świeżo rozpoczęta edycja jest ponownie anulowana

Deklaracja

function StepChoiceSelection(FieldIndex, Delta: Integer): Integer;

Parametry

Wartość zwracana

Zwraca 1, gdy krok zaznaczenia został ukończony albo wartość już pasowała, oraz 0, gdy pole jest nieprawidłowe, nie jest polem wyboru, jest tylko do odczytu, nie ma opcji albo wywołana akcja albo zatwierdzenie odrzuciły zmianę

Przykład

// Keyboard path used by DispatchInputEvent for choice fields
Steps := -1; // fikUp moves to the previous option
Handled := Session.StepChoiceSelection(FieldIndex, Steps) = 1;

Zobacz również

CommitEdit, SetEditValue, DispatchInputEvent, BeginEdit, OnValueChanged