aboutsummaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorDavid Robillard <d@drobilla.net>2022-05-22 20:24:05 -0400
committerDavid Robillard <d@drobilla.net>2023-11-11 09:47:23 -0500
commit32733abab8546b708cab59a4df09f92eb3214f73 (patch)
treeb6bed60281f9dd3b71006b7cb7aa7ab056d6a70c /doc
parent61980dbb9e6968f9d99df9cbd4bbe2f46f0c5050 (diff)
downloadpugl-32733abab8546b708cab59a4df09f92eb3214f73.tar.gz
pugl-32733abab8546b708cab59a4df09f92eb3214f73.tar.bz2
pugl-32733abab8546b708cab59a4df09f92eb3214f73.zip
Add region parameter to puglAcceptOffer()
Diffstat (limited to 'doc')
-rw-r--r--doc/c/clipboards.rst8
1 files changed, 7 insertions, 1 deletions
diff --git a/doc/c/clipboards.rst b/doc/c/clipboards.rst
index ec66bd5..44f2960 100644
--- a/doc/c/clipboards.rst
+++ b/doc/c/clipboards.rst
@@ -82,10 +82,16 @@ it can accept the offer with :func:`puglAcceptOffer`:
for (uint32_t t = 0; t < numTypes; ++t) {
const char* type = puglGetClipboardType(view, t);
if (!strcmp(type, "text/uri-list")) {
- puglAcceptOffer(view, event, t);
+ puglAcceptOffer(view,
+ event,
+ t,
+ puglGetFrame(view));
}
}
+A view region must be given,
+which the window system may use to optimize the process and/or provide user feedback.
+
When an offer is accepted,
the data will be transferred and converted if necessary,
then the view will be sent a :enumerator:`PUGL_DATA` event.