类参考
UDreamUIInputModeLibrary
UDreamUIInputModeLibrary
继承自 UBlueprintFunctionLibrary。
声明于 Public/Event/DreamUIInputModeLibrary.h。
输入模式与光标控制,通过 DreamGUI 的用户索引寻址,而非通过原始控制器。
这里的一切都是对 APlayerController 的薄封装,忠实而直接:引擎拥有输入模式和光标,如果 UI 插件也试图拥有它们,那就会成为项目与之对抗的东西。这个封装增加的是用户索引——事件系统、指针和射线投射器都使用同一个索引——这样分屏游戏就不必在每个调用点重新发现某一块 UI 属于哪个控制器。
函数
| 函数 | 类型 | 描述 |
|---|---|---|
APlayerController* GetPlayerControllerForUser(UObject* WorldContextObject, int32 UserIndex) | 纯函数 | DreamGUI 用户索引所指向的玩家控制器。当不存在这样的本地玩家时为空。 |
bool GetShowMouseCursor(UObject* WorldContextObject, int32 UserIndex) | 纯函数 | 获取是否显示鼠标光标 |
void SetInputModeGameAndUI(UObject* WorldContextObject, UDreamWidget* InWidgetToFocus, int32 UserIndex, EMouseLockMode MouseLockMode, bool bHideCursorDuringCapture, bool bFlushInput) | 可调用 | 游戏和 UI 都能看到输入。 |
void SetInputModeGameOnly(UObject* WorldContextObject, int32 UserIndex, bool bFlushInput) | 可调用 | 只有游戏能看到输入。 |
void SetInputModeUIOnly(UObject* WorldContextObject, UDreamWidget* InWidgetToFocus, int32 UserIndex, EMouseLockMode MouseLockMode, bool bFlushInput) | 可调用 | 只有 UI 能看到输入,并且显示光标——前提是玩家使用键盘和鼠标:启用 UDreamGUISettings::bHideCursorOnGamepad 时,只要该模式保持,DreamGUI 会在玩家使用手柄时隐藏光标,并在他们回到鼠标时再次显示。 |
void SetMouseLockMode(UObject* WorldContextObject, EMouseLockMode MouseLockMode, int32 UserIndex) | 可调用 | 将光标锁定到视口(或停止锁定),而不改变输入模式。 |
void SetShowMouseCursor(UObject* WorldContextObject, bool bShowCursor, int32 UserIndex) | 可调用 | 为某个玩家显示或隐藏硬件光标。 |