diff --git a/docs/news.dox b/docs/news.dox index a815fb14..94ecf9ef 100644 --- a/docs/news.dox +++ b/docs/news.dox @@ -14,7 +14,7 @@ created with @ref glfwCreateCursor and set with @ref glfwSetCursor. Note that custom cursors are only visible in normal cursor mode. -@subsection news_31_drop Drop event support +@subsection news_31_drop File drop event support GLFW now provides a callback for receiving the paths of files dropped onto GLFW windows. The callback is set with the @ref glfwSetDropCallback function. diff --git a/include/GLFW/glfw3.h b/include/GLFW/glfw3.h index b8a0bae6..43614174 100644 --- a/include/GLFW/glfw3.h +++ b/include/GLFW/glfw3.h @@ -784,13 +784,13 @@ typedef void (* GLFWkeyfun)(GLFWwindow*,int,int,int,int); typedef void (* GLFWcharfun)(GLFWwindow*,unsigned int); -/*! @brief The function signature for drop callbacks. +/*! @brief The function signature for file drop callbacks. * - * This is the function signature for drop callbacks. + * This is the function signature for file drop callbacks. * * @param[in] window The window that received the event. - * @param[in] count The number of dropped objects. - * @param[in] names The UTF-8 encoded names of the dropped objects. + * @param[in] count The number of dropped files. + * @param[in] names The UTF-8 encoded path names of the dropped files. * * @sa glfwSetDropCallback * @@ -2195,15 +2195,15 @@ GLFWAPI GLFWcursorenterfun glfwSetCursorEnterCallback(GLFWwindow* window, GLFWcu */ GLFWAPI GLFWscrollfun glfwSetScrollCallback(GLFWwindow* window, GLFWscrollfun cbfun); -/*! @brief Sets the drop callback. +/*! @brief Sets the file drop callback. * - * This function sets the drop callback of the specified window, which is - * called when an object is dropped over the window. + * This function sets the file drop callback of the specified window, which is + * called when one or more dragged files are dropped on the window. * * * @param[in] window The window whose callback to set. - * @param[in] cbfun The new drop callback, or `NULL` to remove the currently - * set callback. + * @param[in] cbfun The new file drop callback, or `NULL` to remove the + * currently set callback. * @return The previously set callback, or `NULL` if no callback was set or an * error occurred. *