StepChoiceSelection
Формы, взаимодействие
Описание
Перемещает выбранный вариант видимого перезаписываемого поля выбора на запрошенный сдвиг
Текущее значение поля сопоставляется с именами экспорта и отображаемыми именами всех настроенных вариантов, и когда ни один вариант не совпадает, отрицательный сдвиг перескакивает на последний вариант, а неотрицательный выбирает первый
Полученная цель ограничивается списком вариантов, новое значение берется из имени экспорта варианта или его отображаемого имени, когда имени экспорта нет, а неизмененное значение завершает работу без какого-либо действия или правки
/K, сохраняет новое текущее значение и завершает CommitEdit, поэтому /V, /F и OnValueChanged проходят обычный путь фиксации
Когда
/K отклонён для поля, которое ранее не редактировалось, только что начатая правка снова отменяется
Объявление
function StepChoiceSelection(FieldIndex, Delta: Integer): Integer;Параметры
| FieldIndex | Индекс поля или временного Widget видимого, доступного для записи поля выбора |
|---|---|
| Delta | Число вариантов для смещения, отрицательное для шагов назад и положительное для шагов вперёд |
Возвращаемое значение
Возвращает 1, когда шаг выделения завершён или значение уже совпадало, и 0, когда поле недействительно, не является полем выбора, доступно только для чтения, не имеет вариантов либо отправленное действие или фиксация отклонили изменение
Пример
// Keyboard path used by DispatchInputEvent for choice fields
Steps := -1; // fikUp moves to the previous option
Handled := Session.StepChoiceSelection(FieldIndex, Steps) = 1;См. также
CommitEdit, SetEditValue, DispatchInputEvent, BeginEdit, OnValueChanged