TPDFlibFormInputResult

Forms, interaction, data types

Description

Reports whether a platform-independent form input event was consumed and exposes the resulting interaction state without requiring additional session queries

Declaration

type
  TPDFlibFormInputResult = record
    Handled: Boolean;
    DefaultPrevented: Boolean;
    FocusChanged: Boolean;
    SelectionChanged: Boolean;
    ValueChanged: Boolean;
    FieldIndex: Integer;
    FocusedFieldIndex: Integer;
    HoveredFieldIndex: Integer;
    PressedFieldIndex: Integer;
  end;

Fields

HandledTrue when the form session consumed the event; False permits host fallback such as document scrolling
DefaultPreventedTrue when a form action vetoed its pending default operation or a required focus transition failed
FocusChangedTrue when dispatch changed the focused Widget
SelectionChangedTrue when dispatch changed the active editor or its directed selection
ValueChangedTrue when dispatch committed a new button or choice-field value
FieldIndexHit, captured or focused field associated with the event, or zero
FocusedFieldIndexFocused field after dispatch, or zero
HoveredFieldIndexWidget with an active entered state after dispatch, or zero
PressedFieldIndexWidget retaining primary-pointer capture after dispatch, or zero

See also

DispatchInputEvent, TPDFlibFormInputEvent, TPDFlibFormSession