AuroraMiddleware/gtk
1
0
Fork 1
mirror of https://gitlab.gnome.org/GNOME/gtk.git synced 2025-01-13 14:00:09 +00:00
Code Issues Projects Releases Wiki Activity

dnd: Add some warnings to the docs

Browse Source 
Add some warnings about pitfalls of the async dnd api.
This commit is contained in:
Matthias Clasen 2021-03-16 14:24:04 -04:00
parent cc6bb13242
commit 74e2bb4cf1
1 changed files with 5 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

5
gdk/gdkdrop.c
View File

@ -699,6 +699,11 @@ gdk_drop_read_async (GdkDrop *self,
* *
* Finishes an async drop read operation. * Finishes an async drop read operation.
* *
* Note that you must not use blocking read calls on the returned stream
* in the GTK thread, since some platforms might require communication with
* GTK to complete the data transfer. You can use async APIs such as
* g_input_stream_read_bytes_async().
*
* See [method@Gdk.Drop.read_async]. * See [method@Gdk.Drop.read_async].
* *
* Returns: (nullable) (transfer full): the `GInputStream`, or %NULL * Returns: (nullable) (transfer full): the `GInputStream`, or %NULL