【決定版】Qt GUIにおけるクリップボード操作のすべて：QClipboard::supportsSelection()を使いこなして開発を成功に導く

QClipboard::supportsSelection()は、Qt GUIアプリケーションにおいて、マウス選択されたテキストや画像がクリップボードに格納可能かどうかを確認するための関数です。この関数は、bool型の値を返します。

機能

falseを返す場合：マウス選択されたテキストや画像がクリップボードに格納できません。
trueを返す場合：マウス選択されたテキストや画像がクリップボードに格納可能です。

QClipboard *clipboard = QGuiApplication::clipboard();

if (clipboard->supportsSelection()) {
  // マウス選択されたテキストや画像を処理
} else {
  // マウス選択されたテキストや画像を処理できない旨をユーザーに通知
}

マウス選択されたテキストや画像をクリップボードに格納するには、QClipboard::setText()やQClipboard::setImage()などの関数を使用します。
QClipboard::supportsSelection()は、プラットフォームによって動作が異なる場合があります。

#include <QApplication>
#include <QClipboard>
#include <QTextEdit>

int main() {
  QApplication app;

  QTextEdit textEdit;
  textEdit.show();

  QObject::connect(textEdit, &QTextEdit::selectionChanged, []() {
    QClipboard *clipboard = QApplication::clipboard();

    if (clipboard->supportsSelection()) {
      QString selectedText = textEdit.selectedText();
      clipboard->setText(selectedText);
    } else {
      // マウス選択されたテキストをクリップボードに格納できません。
    }
  });

  return app.exec();
}

コード解説

QApplicationオブジェクトを作成します。
QTextEditオブジェクトを作成し、ウィンドウに表示します。
QTextEditオブジェクトのselectionChangedシグナルを、匿名スロットに接続します。
匿名スロット内で、QClipboardオブジェクトを取得します。
QClipboard::supportsSelection()を使用して、マウス選択されたテキストがクリップボードに格納可能かどうかを確認します。
可能な場合、QClipboard::setText()を使用して、マウス選択されたテキストをクリップボードに格納します。
不可能な場合、ユーザーに通知します。

例えば、マウス選択されたテキスト以外のデータ（画像など）を処理したい場合は、QClipboard::setImage()などの関数を使用する必要があります。

以下に、QClipboard::supportsSelection()の代替方法として考えられる方法をいくつか紹介します。

QApplication::clipboard()->mimeData() を使用する

QApplication::clipboard()->mimeData()は、現在のクリップボードに格納されているデータのMIMEタイプを返す関数です。この関数を用いて、マウス選択されたデータがクリップボードに格納されているかどうかを確認することができます。

QClipboard *clipboard = QApplication::clipboard();

if (clipboard->mimeData()) {
  // マウス選択されたデータがクリップボードに格納されています。
  // MIMEタイプを検査して、処理を行う
} else {
  // マウス選択されたデータがクリップボードに格納されていません。
}

QApplication::clipboard()->text() を使用する

QApplication::clipboard()->text()は、現在のクリップボードに格納されているテキストを返す関数です。この関数を用いて、マウス選択されたテキストがクリップボードに格納されているかどうかを確認することができます。

QClipboard *clipboard = QApplication::clipboard();

if (!clipboard->text().isEmpty()) {
  // マウス選択されたテキストがクリップボードに格納されています。
  // テキストを処理する
} else {
  // マウス選択されたテキストがクリップボードに格納されていません。
}

QApplication::clipboard()->image() を使用する

QApplication::clipboard()->image()は、現在のクリップボードに格納されている画像を返す関数です。この関数を用いて、マウス選択された画像がクリップボードに格納されているかどうかを確認することができます。

QClipboard *clipboard = QApplication::clipboard();

if (!clipboard->image().isNull()) {
  // マウス選択された画像がクリップボードに格納されています。
  // 画像を処理する
} else {
  // マウス選択された画像がクリップボードに格納されていません。
}

プラットフォーム固有の API を使用する

上記の方法でうまくいかない場合は、プラットフォーム固有の API を使用する必要がある場合があります。例えば、Windowsの場合は、GetClipCursorPos()やOpenClipboard()などの API を使用することができます。

注意点

プラットフォーム固有の API を使用する場合は、そのプラットフォームのドキュメントを参照する必要があります。
しかし、プラットフォームによって動作が異なる場合があるため、注意が必要です。
上記の方法は、QClipboard::supportsSelection()よりも汎用性が高く、多くの状況で使用することができます。

QClipboard::supportsSelection()の代替方法を選択する際には、以下の点を考慮する必要があります。

サポートしているプラットフォーム
使用している Qt のバージョン
必要とするデータの種類（テキスト、画像など）