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 sur les fonctions membres

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

Construit un nouvel objet drag pour le widget spécifié par dragSource.

[virtual noexcept] QDrag::~QDrag()

Détruit l'objet dragué.

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

Ce signal est émis lorsque le site action associé au drag change.

Voir également targetChanged().

[static] void QDrag::cancel()

Annule une opération de glissement initiée par Qt.

Voir également exec().

Qt::DropAction QDrag::defaultAction() const

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

Voir aussi exec() et supportedActions().

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

Renvoie le curseur de déplacement pour le site 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 lorsqu'elle est terminée. Les actions de dépôt que l'utilisateur peut choisir sont spécifiées à l'adresse 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 que l'opération est effectuée. Sous Windows, la boucle d'événements de Qt est bloquée pendant l'opération.

Voir aussi 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 lorsqu'elle est terminée. Les actions de dépôt que l'utilisateur peut choisir sont spécifiées à l'adresse supportedActions.

Le site defaultDropAction détermine l'action qui sera proposée lorsque l'utilisateur effectue un glisser-déposer 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 sont toujours transmis à l'application pendant que l'opération est effectuée. Sous Windows, la boucle d'événements Qt est bloquée pendant l'opération. Cependant, QDrag::exec() sous Windows provoque l'appel fréquent de processEvents() pour maintenir la réactivité de l'interface graphique. Si des boucles ou des opérations sont appelées alors qu'une opération de glissement est active, l'opération de glissement sera bloquée.

QPoint QDrag::hotSpot() const

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

Voir aussi setHotSpot().

QMimeData *QDrag::mimeData() const

Renvoie les données MIME encapsulées dans l'objet drag.

Voir aussi setMimeData().

QPixmap QDrag::pixmap() const

Renvoie la pixmap 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 le curseur de déplacement cursor pour action. Cela vous permet d'ignorer les curseurs natifs par défaut. Pour revenir à l'utilisation du curseur natif pour action, passez une valeur nulle à QPixmap en tant que cursor.

Remarque : la configuration du curseur de glissement pour IgnoreAction peut ne pas fonctionner sur toutes les plates-formes. X11 et macOS ont été testés pour fonctionner. Windows ne le prend pas en charge.

Voir aussi dragCursor().

void QDrag::setHotSpot(const QPoint &hotspot)

Définit la position du point chaud par rapport au coin supérieur gauche de la pixmap utilisée au point spécifié par hotspot.

Note : sur X11, la pixmap peut ne pas être capable de suivre les mouvements de la souris si le point chaud entraîne l'affichage de la pixmap directement sous le curseur.

Voir aussi hotSpot().

void QDrag::setMimeData(QMimeData *data)

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

Voir aussi mimeData().

void QDrag::setPixmap(const QPixmap &pixmap)

Définit pixmap comme la pixmap utilisée pour représenter les données lors d'une opération de glisser-déposer. Vous ne pouvez définir une pixmap qu'avant le début de l'opération de glisser-déposer.

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 aussi 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 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, newTarget étant la nouvelle cible.

Voir également target() et actionChanged().