QDrag Class

        QDrag *drag = new QDrag(this);
        QMimeData *mimeData = new QMimeData;

        mimeData->setText(commentEdit->toPlainText());
        drag->setMimeData(mimeData);

    drag->setHotSpot(QPoint(drag->pixmap().width()/2,
                            drag->pixmap().height()));

Documentation des fonctions membres

[explicit] QDrag::QDrag(QObject *dragSource)

Crée un nouvel objet de glisser-déposer pour le widget spécifié par ` dragSource`.

[virtual noexcept] QDrag::~QDrag()

Supprime l'objet de glisser-déposer.

[signal] void QDrag::actionChanged(Qt::DropAction action)

Ce signal est émis lorsque l'action e associée à la traînée change.

Voir aussi targetChanged().

[static] void QDrag::cancel()

Annule une opération de glisser-déposer lancée par Qt.

Voir aussi exec().

Qt::DropAction QDrag::defaultAction() const

Renvoie l'action de dépôt proposée par défaut pour cette opération de glisser-déposer.

Voir également exec() et supportedActions().

QPixmap QDrag::dragCursor(Qt::DropAction action) const

Renvoie le curseur de glisser-déposer de l'action.

Voir aussi setDragCursor().

Qt::DropAction QDrag::exec(Qt::DropActions supportedActions = Qt::MoveAction)

Lance l'opération de glisser-déposer et renvoie une valeur indiquant l'action de dépôt demandée une fois celle-ci terminée. Les actions de dépôt parmi lesquelles l'utilisateur peut choisir sont spécifiées dans ` supportedActions`. L'action proposée par défaut sera sélectionnée parmi les actions autorisées dans l'ordre suivant : Déplacer, Copier et Lier.

Remarque : sous Linux et macOS, l'opération de glisser-déposer peut prendre un certain temps, mais cette fonction ne bloque pas la boucle d'événements. D'autres événements sont toujours transmis à l'application pendant l'exécution de l'opération. Sous Windows, la boucle d'événements Qt est bloquée pendant l'opération.

Voir également cancel().

Qt::DropAction QDrag::exec(Qt::DropActions supportedActions, Qt::DropAction defaultDropAction)

Lance l'opération de glisser-déposer et renvoie une valeur indiquant l'action de dépôt demandée une fois celle-ci terminée. Les actions de dépôt parmi lesquelles l'utilisateur peut choisir sont spécifiées dans ` supportedActions`.

La méthode ` defaultDropAction ` détermine quelle action sera proposée lorsque l'utilisateur effectue un glissement sans utiliser de touches de modification.

Remarque : sous Linux et macOS, l'opération de glisser-déposer peut prendre un certain temps, mais cette fonction ne bloque pas la boucle d'événements. D'autres événements continuent d'être transmis à l'application pendant l'exécution de l'opération. Sous Windows, la boucle d’événements Qt est bloquée pendant l’opération. Cependant, la fonction QDrag::exec() sous Windows provoque l’appel fréquent de processEvents() afin de maintenir la réactivité de l’interface graphique. Si des boucles ou des opérations sont appelées alors qu’une opération de glisser-déposer est en cours, cela bloquera cette opération.

QPoint QDrag::hotSpot() const

Renvoie la position du point sensible par rapport au coin supérieur gauche du curseur.

Voir aussi setHotSpot().

QMimeData *QDrag::mimeData() const

Renvoie les données MIME encapsulées par l'objet de glisser-déposer.

Voir aussi setMimeData().

QPixmap QDrag::pixmap() const

Renvoie la carte de pixels utilisée pour représenter les données lors d'une opération de glisser-déposer.

Voir aussi setPixmap().

void QDrag::setDragCursor(const QPixmap &cursor, Qt::DropAction action)

Définit l’ cursor de glisser-déposer pour l’ action. Cela vous permet de remplacer les curseurs natifs par défaut. Pour revenir à l’utilisation du curseur natif pour action, transmettez une QPixmap nulle en tant que cursor.

Remarque : la configuration du curseur de glissement pour IgnoreAction peut ne pas fonctionner sur toutes les plateformes. Son fonctionnement a été testé sous X11 et macOS. Windows ne le prend pas en charge.

Voir également dragCursor().

void QDrag::setHotSpot(const QPoint &hotspot)

Définit la position de la zone sensible par rapport au coin supérieur gauche de l'image utilisée, au point spécifié par hotspot.

Remarque : sous X11, il se peut que la carte de pixels ne parvienne pas à suivre les mouvements de la souris si la zone sensible entraîne l'affichage de la carte de pixels directement sous le curseur.

Voir également hotSpot().

void QDrag::setMimeData(QMimeData *data)

Définit les données à envoyer à l'data MIME indiquée. La propriété des données est transférée à l'objet QDrag.

Voir également mimeData().

void QDrag::setPixmap(const QPixmap &pixmap)

Définit ` pixmap ` comme image pixel (pixmap) utilisée pour représenter les données lors d'une opération de glisser-déposer. Vous ne pouvez définir une image pixel qu'avant le début du glissement.

Voir aussi pixmap().

QObject *QDrag::source() const

Renvoie la source de l'objet glissé. Il s'agit du widget à l'origine de l'opération de glisser-déposer.

Qt::DropActions QDrag::supportedActions() const

Renvoie l'ensemble des actions de dépôt possibles pour cette opération de glisser-déposer.

Voir également exec() et defaultAction().

QObject *QDrag::target() const

Renvoie la cible de l'opération de glisser-déposer. Il s'agit du widget dans lequel l'objet glissé a été déposé.

[signal] void QDrag::targetChanged(QObject *newTarget)

Ce signal est émis lorsque la cible de l'opération de glisser-déposer change, la nouvelle cible étant newTarget.

Voir également target() et actionChanged().