StepChoiceSelection

Formularios, interacción

Descripción

Mueve la opción seleccionada de un campo de elección visible y grabable en el delta solicitado

El valor del campo actual se empareja contra los nombres de exportación y los nombres mostrados de todas las opciones configuradas, y cuando ninguna opción empareja, un delta negativo salta a la última opción mientras un delta no negativo selecciona la primera

El destino resultante se acota dentro de la lista de opciones, el nuevo valor se toma del nombre de exportación de la opción o de su nombre mostrado cuando no existe nombre de exportación, y un valor sin cambios completa sin ninguna acción ni edición

Un valor cambiante enfoca y edita el campo, despacha la acción de pulsación de tecla /K del widget, almacena el nuevo valor transitorio y termina con CommitEdit, así que /V, /F y OnValueChanged corren por la ruta normal de confirmación

/K se veta para un campo que no estaba siendo editado antes, la edición recién iniciada se cancela de nuevo

Declaración

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

Parámetros

Valor devuelto

Devuelve 1 cuando el paso de selección terminó o el valor ya coincidía, y 0 cuando el campo no es válido, no es un campo de lista, es de solo lectura, no tiene opciones, o una acción enviada o la confirmación rechazaron el cambio

Ejemplo

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

Véase también

CommitEdit, SetEditValue, DispatchInputEvent, BeginEdit, OnValueChanged