StepChoiceSelection

Formulários, interação

Descrição

Move a opção selecionada de um campo de escolha visível e gravável pelo delta solicitado

O valor atual do campo é comparado com os nomes de exportação e os nomes de exibição de todas as opções configuradas, e quando nenhuma opção corresponde, um delta negativo salta para a última opção enquanto um delta não negativo seleciona a primeira

O alvo resultante é limitado à lista de opções, o novo valor vem do nome de exportação da opção ou de seu nome de exibição quando não há nome de exportação, e um valor inalterado conclui sem qualquer ação ou edição

/K do Widget, armazena o novo valor transitório e termina com CommitEdit, de modo que /V, /F e OnValueChanged executem pelo caminho normal de confirmação Quando

/K é vetado para um campo que não estava sendo editado antes, a edição recém-iniciada é cancelada novamente

Declaração

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

Parâmetros

Valor de retorno

Retorna 1 quando o passo de seleção foi concluído ou o valor já correspondia, e 0 quando o campo é inválido, não é um campo de escolha, é somente leitura, não tem opções ou uma ação despachada ou confirmação rejeitou a alteração

Exemplo

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

Consulte também

CommitEdit, SetEditValue, DispatchInputEvent, BeginEdit, OnValueChanged