UDreamInputKeySelector

Inherits from UDreamUIControl.

Declared in Public/Controls/DreamInputKeySelector.h.

A button whose label is a bound key, and which listens for the next one when clicked.

Two nodes and one behaviour, the button's anatomy exactly -- the face IS the root, with the key's name centred on it -- because that is what this control is: a button carrying a value. Clicking it ARMS it (bIsListening), the next key it is told about becomes the value, and it disarms.

WHERE THE KEY COMES FROM, plainly, because this plugin has no hook that would supply it and this class does not pretend otherwise. What exists here is:

• UDreamUIActionRouter, which routes NAMED actions from a data table. It resolves a key to an action and fires that action's callback; it cannot report the key itself, and a rebinder needs the key, not the meaning.
• ADreamStandaloneInputEventSystemActor, which does hold real FKeys -- its AnyKey binding is where they arrive -- but forwards them straight into navigation and the router and broadcasts nothing. OnAnyKeyPressed is private and not virtual.
• UDreamUserWidget's Blueprint surface, which is pointer, drag, focus and navigation. No keys. (UUITextInput does capture raw keys, by spawning an actor with AutoReceiveInput and binding every key on it. That is a text field's bargain -- one actor per active field, consuming what it binds -- and inventing a second copy of it inside a control is not something this class does quietly.)

So the arming, the state, the visual and the value live here, and the KEY IS FED IN: while this is listening, the project's input layer calls NotifyKeyPressed with whatever the player pressed, and it returns true when it took it. That layer is wherever the project already sees keys -- its PlayerController, an Enhanced Input action, or a subclass of ADreamStandaloneInputEventSystemActor overriding BindActionRouting (which is virtual for exactly this kind of extension). SetSelectedKey writes the value with no listening involved, for a settings screen restoring saved bindings.

UMG parity is UInputKeySelector's core: SelectedChord (with SelectedKey as its bare-key spelling), bIsListening, OnKeySelected, OnIsSelectingKey -- plus the library's OnValueChangedBP, because the key is a value and <-> binds against it.

/Script/DreamGUIControls.DreamInputKeySelector JumpBinding {
    SelectedKey = (KeyName="SpaceBar")
    OnKeySelected -> HandleJumpRebound

Properties

Functions

Events

Compared with UMG

Every Blueprint-facing member of the UMG class, and where it went. adopt: same name, same meaning. map: here under another name or on another type. reject: deliberately absent, with the reason.