diff --git a/DOCS/interface-changes/clipboard.txt b/DOCS/interface-changes/clipboard.txt new file mode 100644 index 0000000000000..00c5784d93bef --- /dev/null +++ b/DOCS/interface-changes/clipboard.txt @@ -0,0 +1,2 @@ +add `--clipboard-enabled` and `--clipboard-monitor` options +add `clipboard` property diff --git a/DOCS/man/input.rst b/DOCS/man/input.rst index 45f0e4c9fa7dd..7320082a283bd 100644 --- a/DOCS/man/input.rst +++ b/DOCS/man/input.rst @@ -3893,6 +3893,18 @@ Property list This property is read-only, and change notification is not supported. +``clipboard`` + The clipboard contents, only works when native clipboard + (``--clipboard-enable``) is supported on the platform. + Depending on the platform, some sub-properties, writing to properties, + or change notifications are not currently functional. + + This has a number of sub-properties: + + ``clipboard/text`` (RW) + The text content in the clipboard (Windows and Wayland only). + Writing to this property sets the text clipboard content (Windows only). + Inconsistencies between options and properties ---------------------------------------------- diff --git a/DOCS/man/options.rst b/DOCS/man/options.rst index 6cc554f48f97f..9f640052057fb 100644 --- a/DOCS/man/options.rst +++ b/DOCS/man/options.rst @@ -7793,3 +7793,18 @@ Miscellaneous code is the same.) Conversion is not applied to metadata that is updated at runtime. + +``--clipboard-enable=`` + (Windows and Wayland only) + + Enable native clipboard support (default: yes). This allows reading and + writing to the ``clipboard`` property to get and set clipboard contents. + +``--clipboard-monitor=`` + (Windows only) + + Enable clipboard monitoring so that the ``clipboard`` property can be + observed for content changes (default: no). This only affects clipboard + implementations which use polling to monitor clipboard updates. + Other platforms currently ignore this option and always/never notify + changes.