mirrors/kitty
1
0
Fork 0
mirror of https://github.com/kovidgoyal/kitty synced 2026-07-22 16:28:19 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add some docs for the drag source API

Browse Source
This commit is contained in:
Kovid Goyal
2026-02-18 16:05:27 +05:30
parent a2b7a0cd6d
commit 3cd2aa6a2f
1 changed files with 11 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
glfw/glfw3.h vendored
View File

@@ -1812,7 +1812,7 @@ typedef void (* GLFWscrollfun)(GLFWwindow*,const GLFWScrollEvent*);
typedef void (* GLFWkeyboardfun)(GLFWwindow*, GLFWkeyevent*); typedef void (* GLFWkeyboardfun)(GLFWwindow*, GLFWkeyevent*);
typedef enum { typedef enum {
GLFW_DRAG_DATA_REQUEST, GLFW_DRAG_DATA_REQUEST, // request data for specified mime type
GLFW_DRAG_CANCELLED, GLFW_DRAG_CANCELLED,
GLFW_DRAG_FINSHED, GLFW_DRAG_FINSHED,
GLFW_DRAG_ACCEPTED, // mimetype was accepted or NULL if drag was accepted but no mime type specified GLFW_DRAG_ACCEPTED, // mimetype was accepted or NULL if drag was accepted but no mime type specified
@@ -1829,8 +1829,14 @@ typedef struct GLFWDragSourceItem {
typedef struct GLFWDragEvent { typedef struct GLFWDragEvent {
GLFWDragEventType type; GLFWDragEventType type;
// When the drag event callback is called with a mimetype and no data, the
// application should set the data ans data_sz and err_num fields.
// Once glfw is done reading the data the drag event callback will be
// called with the data pointer unchanged. The application is now free
// to delete the data, as needed.
const char *mime_type; const char *mime_type;
const char *data; size_t data_sz; int err_num; const char *data; size_t data_sz;
int err_num; // POSIX error code indicating failure fetching data
GLFWDragOperationType action; // can be 0 indicating no action GLFWDragOperationType action; // can be 0 indicating no action
} GLFWDragEvent; } GLFWDragEvent;
@@ -4973,6 +4979,9 @@ GLFWAPI void glfwRequestDropUpdate(GLFWwindow *window); // ask for update befor
GLFWAPI int glfwRequestDropData(GLFWwindow *window, const char *mime); GLFWAPI int glfwRequestDropData(GLFWwindow *window, const char *mime);
GLFWAPI void glfwEndDrop(GLFWwindow *window, GLFWDragOperationType op); GLFWAPI void glfwEndDrop(GLFWwindow *window, GLFWDragOperationType op);
GLFWAPI GLFWdragsourcefun glfwSetDragSourceCallback(GLFWwindow* window, GLFWdragsourcefun callback); GLFWAPI GLFWdragsourcefun glfwSetDragSourceCallback(GLFWwindow* window, GLFWdragsourcefun callback);
// Start a drag. If called with operations == -1 indicates that previously
// requested data via GLFW_DRAG_DATA_REQUEST is ready.
GLFWAPI int glfwStartDrag(GLFWwindow* window, const GLFWDragSourceItem *items, size_t mime_count, const GLFWimage* thumbnail, int operations); GLFWAPI int glfwStartDrag(GLFWwindow* window, const GLFWDragSourceItem *items, size_t mime_count, const GLFWimage* thumbnail, int operations);
/*! @brief Returns whether the specified joystick is present. /*! @brief Returns whether the specified joystick is present.