QListWidget::dragDropMode() 関数でドラッグアンドドロップ操作の動作を変更する

QListWidget::supportedDropActions() 関数の詳細解説

Qt Widgets の QListWidget クラスには、supportedDropActions() という関数があります。この関数は、ドラッグアンドドロップ操作でサポートされるアクションを決定します。

機能

この関数は、Qt::DropActions 型の値を返します。この値は、ドロップ操作で許可されるアクションをビットマスクで表します。

デフォルトの動作

デフォルトでは、supportedDropActions() は以下のアクションをサポートします。

• Qt::CopyAction: アイテムのコピー
• Qt::MoveAction: アイテムの移動
• Qt::LinkAction: アイテムへのリンクの作成

カスタム動作の設定

supportedDropActions() 関数を再定義することで、カスタムの動作を設定できます。例えば、以下のコードは、コピーと移動のみを許可する例です。

class MyListWidget : public QListWidget {
public:
  MyListWidget(QWidget *parent = nullptr) : QListWidget(parent) {}

  Qt::DropActions supportedDropActions() const override {
    return Qt::CopyAction | Qt::MoveAction;
  }
};

注意点

• ドラッグアンドドロップ操作が許可されるためには、setDragDropEnabled() 関数を true に設定する必要があります。
• ドロップされたアイテムを処理するには、dropEvent() 関数を再定義する必要があります。

• supportedDropActions() 関数は、Qt Designer で設定することもできます。
• ドラッグアンドドロップ操作の詳細については、Qt ドキュメントのドラッグアンドドロップの章を参照してください。

この解説で分からない点があれば、遠慮なく質問してください。

QListWidget::supportedDropActions() 関数のサンプルコード

コピーと移動のみを許可する

class MyListWidget : public QListWidget {
public:
  MyListWidget(QWidget *parent = nullptr) : QListWidget(parent) {}

  Qt::DropActions supportedDropActions() const override {
    return Qt::CopyAction | Qt::MoveAction;
  }
};

アイテムのリンク作成を許可する

class MyListWidget : public QListWidget {
public:
  MyListWidget(QWidget *parent = nullptr) : QListWidget(parent) {}

  Qt::DropActions supportedDropActions() const override {
    return Qt::CopyAction | Qt::MoveAction | Qt::LinkAction;
  }
};

ドロップされたアイテムのテキストを表示する

class MyListWidget : public QListWidget {
public:
  MyListWidget(QWidget *parent = nullptr) : QListWidget(parent) {}

  void dropEvent(QDropEvent *event) override {
    if (event->mimeData()->hasText()) {
      QString text = event->mimeData()->text();
      addItem(text);
    } else {
      event->ignore();
    }
  }
};

ドラッグされたアイテムの画像を表示する

class MyListWidget : public QListWidget {
public:
  MyListWidget(QWidget *parent = nullptr) : QListWidget(parent) {}

  void dropEvent(QDropEvent *event) override {
    if (event->mimeData()->hasImage()) {
      QPixmap pixmap = event->mimeData()->imageData();
      addItem(new QListWidgetItem(QIcon(pixmap), pixmap.fileName()));
    } else {
      event->ignore();
    }
  }
};

カスタムデータの受け渡し

class MyListWidget : public QListWidget {
public:
  MyListWidget(QWidget *parent = nullptr) : QListWidget(parent) {}

  void dropEvent(QDropEvent *event) override {
    if (event->mimeData()->hasFormat("application/x-my-custom-data")) {
      QByteArray data = event->mimeData()->data("application/x-my-custom-data");
      // データを処理...
    } else {
      event->ignore();
    }
  }
};

QListWidget::supportedDropActions() 関数以外の方法

ドラッグアンドドロップイベントのフィルタリング

eventFilter() 関数を再定義することで、ドラッグアンドドロップイベントをフィルタリングできます。この方法では、ドロップ操作を許可するかどうかを個別に判断できます。

class MyListWidget : public QListWidget {
public:
  MyListWidget(QWidget *parent = nullptr) : QListWidget(parent) {}

  bool eventFilter(QObject *object, QEvent *event) override {
    if (event->type() == QEvent::DragEnter) {
      // ドラッグされたアイテムを受け入れるかどうかを判断...
    } else if (event->type() == QEvent::Drop) {
      // ドロップされたアイテムを処理...
    }
    return QListWidget::eventFilter(object, event);
  }
};

ドラッグアンドドロップハンドラの設定

setDragDropHandler() 関数を使用して、カスタムのドラッグアンドドロップハンドラを設定できます。ドラッグアンドドロップハンドラは、ドロップ操作の処理を完全に制御できます。

class MyDragDropHandler : public QObject {
public:
  MyDragDropHandler(QWidget *parent = nullptr) : QObject(parent) {}

  bool canDrop(const QMimeData *mimeData, Qt::DropAction action, int row, int column, const QPoint &pos) const {
    // ドロップ操作を許可するかどうかを判断...
  }

  void drop(const QMimeData *mimeData, Qt::DropAction action, int row, int column, const QPoint &pos) {
    // ドロップされたアイテムを処理...
  }
};

class MyListWidget : public QListWidget {
public:
  MyListWidget(QWidget *parent = nullptr) : QListWidget(parent) {}

  void setup() {
    MyDragDropHandler *handler = new MyDragDropHandler(this);
    setDragDropHandler(handler);
  }
};

QAbstractItemView::dragDropMode() の設定

dragDropMode() 関数を設定することで、ドラッグアンドドロップ操作の動作を変更できます。

QListWidget *listWidget = new QListWidget;

// ドラッグアンドドロップ操作を無効にする
listWidget->setDragDropMode(QAbstractItemView::NoDragDrop);

// コピーのみを許可する
listWidget->setDragDropMode(QAbstractItemView::CopyOnly);

// 移動のみを許可する
listWidget->setDragDropMode(QAbstractItemView::MoveOnly);

// コピーと移動を許可する
listWidget->setDragDropMode(QAbstractItemView::InternalMove);

// ドロップのみを許可する
listWidget->setDragDropMode(QAbstractItemView::DropOnly);

これらの方法は、supportedDropActions() 関数よりも柔軟な制御を提供します。