Vous devez avoir un compte Developpez.com et être connecté pour pouvoir participer aux discussions.

Identifiez-vous
Identifiant
Mot de passe
Mot de passe oublié ?
Créer un compte

Vous n'avez pas encore de compte Developpez.com ? L'inscription est gratuite et ne vous prendra que quelques instants !

Je m'inscris !

Developpez.com

Qt

Choisissez la catégorie, puis la rubrique :

Viadeo Twitter Facebook Share on Google+   
Logo Documentation Qt ·  Page d'accueil  ·  Toutes les classes  ·  Toutes les fonctions  ·  Vues d'ensemble  · 

QDropEvent

La classe QDropEvent fournit un événement qui est envoyé lorsqu'une action de glisser-déposer se termine. Plus d'informations...

#include <QDropEvent>

Voir la position dans l'arbre des classes.

Héritage

Hérite de QEvent et QMimeSource.

Hérité par QDragMoveEvent.

Description détaillée

La classe QDropEvent fournit un événement qui est envoyé lorsqu'une action de glisser-déposer se termine.

Lorsqu'un widget accepte les événements de dépose, il recevra cet événement s'il a accepté l'événement QDragEnterEvent ou QDragMoveEvent le plus récent qui lui a été envoyé.

L'événement de dépose contient une action proposée, accessible par proposedAction(), que le widget peut accepter ou ignorer. Si l'action peut être traitée par le widget, vous devez appeler la fonction acceptProposedAction(). Étant donné que l'action proposée peut être une combinaison de valeurs Qt::DropAction, il peut être utile de sélectionner une de ces valeurs comme action par défaut ou de demander à l'utilisateur de sélectionner son action préférentielle.

Si l'action de dépose proposée ne convient pas, par exemple si votre widget personnalisé ne gère pas cette action, vous pouvez la remplacer par une des actions de dépose possibles en appelant setDropAction() avec l'action choisie. Si vous spécifiez une valeur qui n'est pas présente dans la combinaison de bits renvoyée par possibleActions(), l'action de copie par défaut sera utilisée. Après avoir fixé l'action de dépose de remplacement, appelez accept() au lieu de acceptProposedAction() pour terminer l'opération de dépose.

La fonction mimeData() fournit les données déposées sur le widget dans un objet QMimeData. Celui-ci contient des informations sur le type MIME des données en plus des données elles-mêmes.

Voir aussi QMimeData, QDrag et glisser-déposer.

Fonctions membres

QDropEvent::QDropEvent ( const QPoint & pos, Qt::DropActions actions, const QMimeData * data, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Type type = Drop )

Construit un événement de dépose du type donné correspondant à une dépose au point spécifié par pos dans le système de coordonnées du widget destination.

Les actions indiquent quels types d'opérations de glisser-déposer peuvent être effectuées et les données associées sont stockées en encodage MIME dans data.

Les états des boutons de souris et les modificateurs de clavier au moment de la dépose sont spécifiés par buttons et modifiers.

void QDropEvent::acceptProposedAction ()

Accepte l'action proposée comme action de dépose.

Voir aussi setDropAction(), proposedAction() et accept().

Qt::DropAction QDropEvent::dropAction () const

Renvoie l'action qui doit être effectuée sur les données par la cible. Elle peut être différente de l'action spécifiée par proposedAction() si vous avez appelé setDropAction() pour choisir explicitement une action de dépose.

Voir aussi setDropAction().

Qt::KeyboardModifiers QDropEvent::keyboardModifiers () const

Renvoie les modificateurs de clavier actifs.

const QMimeData * QDropEvent::mimeData () const

Renvoie les données déposées sur le widget et l'information de type MIME associée.

Qt::MouseButtons QDropEvent::mouseButtons () const

Renvoie les boutons de souris appuyés.

const QPoint & QDropEvent::pos () const

Renvoie la position à laquelle la dépose a été faite.

Qt::DropActions QDropEvent::possibleActions () const

Renvoie une combinaison OU des actions de dépose possibles.

Voir aussi dropAction().

Qt::DropAction QDropEvent::proposedAction () const

Renvoie l'action de dépose proposée.

Voir aussi dropAction().

void QDropEvent::setDropAction ( Qt::DropAction action )

Définit l'action à effectuer sur les données par la cible. Utilisez cette fonction pour remplacer l'action proposée par une des actions possibles.

Si vous définissez une action de dépose qui ne fait pas partie des actions possibles, l'opération de glisser-déposer deviendra par défaut une action de copie.

Après avoir spécifié une action de remplacement, appelez accept() au lieu de acceptProposedAction().

Voir aussi dropAction().

QWidget * QDropEvent::source () const

Si la source de l'opération de glisser-déposer est un widget de l'application, la fonction renvoie cette source ; sinon elle renvoie 0. La source de l'opération est le premier paramètre de l'objet QDrag utilisé au début de l'opération.

Cette fonction est utile si votre widget doit se comporter différemment en cas de dépose sur lui-même.

Voir aussi QDrag::QDrag().

Remerciements

Merci à Ilya Diallo pour la traduction et à Jonathan Courtois, Claude Leloup et Jacques Thery pour leur relecture !

Warning: include(): https:// wrapper is disabled in the server configuration by allow_url_include=0 in /home/developpez/www/developpez-com/upload/qt/doc/bs.php on line 4 Warning: include(https://qt.developpez.com/index/rightColumn): failed to open stream: no suitable wrapper could be found in /home/developpez/www/developpez-com/upload/qt/doc/bs.php on line 4 Warning: include(): Failed opening 'https://qt.developpez.com/index/rightColumn' for inclusion (include_path='.:/usr/php53/lib/php') in /home/developpez/www/developpez-com/upload/qt/doc/bs.php on line 4
Cette page est une traduction d'une page de la documentation de Qt, écrite par Nokia Corporation and/or its subsidiary(-ies). Les éventuels problèmes résultant d'une mauvaise traduction ne sont pas imputables à Nokia. Qt 4.7
Copyright © 2019 Developpez LLC. Tous droits réservés Developpez LLC. Aucune reproduction, même partielle, ne peut être faite de ce site et de l'ensemble de son contenu : textes, documents et images sans l'autorisation expresse de Developpez LLC. Sinon, vous encourez selon la loi jusqu'à 3 ans de prison et jusqu'à 300 000 E de dommages et intérêts. Cette page est déposée à la SACD.
Vous avez déniché une erreur, une redirection cassée ou tout autre problème, quel qu'il soit ? Ou bien vous désirez participer à ce projet de traduction ? N'hésitez pas à nous contacter ou par MP !
Responsable bénévole de la rubrique Qt : Thibaut Cuvelier -

Partenaire : Hébergement Web