mirror/glfw
1
0
Fork 0
mirror of https://github.com/glfw/glfw.git synced 2024-11-26 06:14:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

Added notes on synthetic release events.

Browse Source
This commit is contained in:
Camilla Berglund 2013-04-24 19:49:46 +02:00
parent 3ec843a1da
commit 4538a525f0
1 changed files with 17 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
include/GL/glfw3.h
View File

@ -1580,6 +1580,11 @@ GLFWAPI GLFWwindowrefreshfun glfwSetWindowRefreshCallback(GLFWwindow* window, GL
* This function sets the focus callback of the specified window, which is * This function sets the focus callback of the specified window, which is
* called when the window gains or loses focus. * called when the window gains or loses focus.
* *
* After the focus callback is called for a window that lost focus, synthetic
* key and mouse button release events will be generated for all such that had
* been pressed. For more information, see @ref glfwSetKeyCallback and @ref
* glfwSetMouseButtonCallback.
*
* @param[in] window The window whose callback to set. * @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set * @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback. * callback.
@ -1800,6 +1805,12 @@ GLFWAPI void glfwSetCursorPos(GLFWwindow* window, double xpos, double ypos);
* layout. If you want to input text, use the [character callback](@ref * layout. If you want to input text, use the [character callback](@ref
* glfwSetCharCallback) instead. * glfwSetCharCallback) instead.
* *
* When a window loses focus, it will generate synthetic key release events
* for all pressed keys. You can tell these events from user-generated events
* by the fact that the synthetic ones are generated after the window has lost
* focus, i.e. `GLFW_FOCUSED` will be false and the focus callback will have
* already been called.
*
* @param[in] window The window whose callback to set. * @param[in] window The window whose callback to set.
* @param[in] cbfun The new key callback, or `NULL` to remove the currently * @param[in] cbfun The new key callback, or `NULL` to remove the currently
* set callback. * set callback.
@ -1834,6 +1845,12 @@ GLFWAPI GLFWcharfun glfwSetCharCallback(GLFWwindow* window, GLFWcharfun cbfun);
* This function sets the mouse button callback of the specified window, which * This function sets the mouse button callback of the specified window, which
* is called when a mouse button is pressed or released. * is called when a mouse button is pressed or released.
* *
* When a window loses focus, it will generate synthetic mouse button release
* events for all pressed mouse buttons. You can tell these events from
* user-generated events by the fact that the synthetic ones are generated
* after the window has lost focus, i.e. `GLFW_FOCUSED` will be false and the
* focus callback will have already been called.
*
* @param[in] window The window whose callback to set. * @param[in] window The window whose callback to set.
* @param[in] cbfun The new callback, or `NULL` to remove the currently set * @param[in] cbfun The new callback, or `NULL` to remove the currently set
* callback. * callback.