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 actual del campo 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 en edición 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 se completó o el valor ya coincidía, y 0 cuando el campo no es válido, no es un campo de elección, es de solo lectura, no tiene opciones, o una acción despachada o la confirmación rechazó 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