Clipboard

The Clipboard class lets you add or remove data from the clipboard that is shared between applications on the device. This clipboard allows for copying and pasting data in different locations within the same application, or between different applications on the device.

Data in the clipboard is referenced by type. Multiple types of data can exist in the clipboard at the same time. Each type typically refers to a different encoding of the same data. For example, an application copying data from an HTML source might insert both HTML markup and plain text into the clipboard. This increases the likelihood that an application performing a paste operation will find data in the clipboard with a suitable encoding. For example, a rich document editor performing a paste operation might first look for HTML markup in the clipboard and fall back to plain text if no HTML markup is found, whereas a simple document editor might look for plain text data only.

A type can be any non-empty string. For compatibility with other applications, using Internet media types (i.e., MIME types) is recommended. For example, "text/plain", "text/html", and "text/rtf" are three commonly-used encodings for textual data.

The following example shows how to "paste" plain text data from the clipboard:

bb::system::Clipboard clipboard;
QByteArray data = clipboard.value("text/plain");
if (!data.isEmpty()) {
    // process data from clipboard
}

The following example shows how to "copy" html and plain text data to the clipboard:

bb::system::Clipboard clipboard;
clipboard.clear();
clipboard.insert("text/html", "<b>Hello world</b>");
clipboard.insert("text/plain", "Hello world");