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

More words on window closing.

Browse Source
This commit is contained in:
Camilla Berglund 2013-10-25 15:55:24 +02:00
parent baf100f78c
commit 394c44ccf9
1 changed files with 16 additions and 5 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
docs/moving.dox
View File

@ -176,13 +176,24 @@ similar to that of GLFW 2.
@subsection moving_window_close Window closing @subsection moving_window_close Window closing
Window closing is now just an event like any other. GLFW 3 windows won't Window closing initiated by the user is now just an event like any other.
disappear from underfoot even when no close callback is set; instead the Unlike GLFW 2, windows and contexts created with GLFW 3 will not disappear from
window's close flag is set. You can query this flag using @ref underfoot. Each window now has a close flag, which is set when the user
glfwWindowShouldClose, or capture close events by setting a close callback. The attempts to close it. By default, nothing else happens and the window stays
close flag can be modified from any point in your program using @ref open and visible. It is then up to you to either destroy the window, take some
other action or simply ignore the request. You can query the close flag at any
time with @ref glfwWindowShouldClose and set it at any time with @ref
glfwSetWindowShouldClose. glfwSetWindowShouldClose.
The close callback no longer returns a value. Instead, it is called after the
close flag has been set so it can override its value, if it chooses to, before
event processing completes. You may however not call @ref glfwDestroyWindow
from the close callback (or any other window related callback).
GLFW itself never clears the close flag, allowing you to set it for other
reasons for the window to close as well, for example the user choosing Quit from
the main menu.
@subsection moving_context Explicit context management @subsection moving_context Explicit context management