\brief
Захват мыши для отслеживания ввода вне окна SDL.
\param
включено Независимо от того, включено или нетдля включения захвата
Захват позволяет вашему приложению получать события мыши глобально, а не только внутри вашего окна. Не все видеоцелевые объекты поддерживают эту функцию. Когда захват включен, текущее окно будет получать все события мыши, но в отличие от относительного режима, курсор не изменяется и не ограничивается вашим окном.
Эта функция может также запретить ввод данных мышью в другие окна - как в вашем приложении, так и в других - в системе - поэтому вам следует использовать эту функцию экономно и небольшими пакетами. Например, вы можете отслеживать мышь, пока пользователь что-то перетаскивает, пока пользователь не отпустит кнопку мыши. Не рекомендуется захватывать мышь в течение длительных периодов времени, например, в течение всего времени работы приложения.
Во время захвата события мыши по-прежнему сообщают координаты относительно текущего (переднего плана) окна, но этикоординаты могут находиться за пределами окна (включая отрицательные значения). Захват разрешен только для переднего окна. Если окно теряет фокус во время захвата, захват будет отключен автоматически.
Пока захват включен, в текущем окне будет установлен флаг SDL_WINDOW_MOUSE_CAPTURE
.
\return
0 в случае успехаили -1, если не поддерживается.
extern DECLSPEC int SDLCALL SDL_CaptureMouse(SDL_bool enabled);