Set Viewport Mouse Capture Mode
GameplayStaticsЧто это
Exec-функция класса GameplayStatics, которая задаёт режим захвата мыши для указанного окна просмотра (viewport). Используется в мультиоконных приложениях или при кастомном управлении вводом, когда нужно определить, как мышь взаимодействует с окном (захватывается постоянно, только при наведении или никогда).
Пины
Exec-входы:
- execute (exec) — запуск функции
Exec-выходы:
- then (exec) — продолжение выполнения
Входы (данные):
- Target (GameplayStatics) — ссылка на статический класс (обычно
self) - ViewportIndex (int) — индекс окна просмотра, для которого устанавливается режим
- MouseCaptureMode (EMouseCaptureMode) — режим захвата мыши (
CapturePermanently,CaptureIfMouseOver,NeverCapture)
Выходы (данные):
- нет (void)
Когда используется
- Настройка поведения мыши в многоконных проектах (например, симуляторы с несколькими мониторами).
- Принудительное освобождение или захват мыши для UI-элементов в отдельном окне.
- Отключение захвата мыши, чтобы курсор не застревал в окне при работе с внешними инструментами.
Типичные проблемы
- Передача несуществующего
ViewportIndex(если окно не было создано или уже закрыто) — функция не сработает, ошибка не возникнет, но поведение мыши не изменится. - Неверный
MouseCaptureModeдля конкретной задачи: например,CapturePermanentlyможет мешать работе с другими окнами, аNeverCapture— сделать окно «невидимым» для кликов мыши. - Забывают вызвать функцию после создания нового viewport — захват остаётся от предыдущего окна или по умолчанию.