Developpez.com - Qt
X

Choisissez d'abord la catégorieensuite la rubrique :

Viadeo Twitter Google Bookmarks ! Facebook Digg del.icio.us MySpace Yahoo MyWeb Blinklist Netvouz Reddit Simpy StumbleUpon Bookmarks Windows Live Favorites 
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 !

Publicité

Best Of

Actualités les plus lues

Semaine
Mois
Année
  1. « Quelque chose ne va vraiment pas avec les développeurs "modernes" », un développeur à "l'ancienne" critique la multiplication des bibliothèques 44
  2. Microsoft ouvre aux autres compilateurs C++ AMP, la spécification pour la conception d'applications parallèles C++ utilisant le GPU 22
  3. Les développeurs ignorent-ils trop les failles découvertes dans leur code ? Prenez-vous en compte les remarques des autres ? 17
  4. RIM : « 13 % des développeurs ont gagné plus de 100 000 $ sur l'AppWord », Qt et open-source au menu du BlackBerry DevCon Europe 0
  5. BlackBerry 10 : premières images du prochain OS de RIM qui devrait intégrer des widgets et des tuiles inspirées de Windows Phone 0
  6. Quelles nouveautés de C++11 Visual C++ doit-il rapidement intégrer ? Donnez-nous votre avis 10
  7. Adieu qmake, bienvenue qbs : Qt Building Suite, un outil déclaratif et extensible pour la compilation de projets Qt 17
Page suivante

Le Qt Quarterly au hasard

Logo

Les développeurs viennent de Mars, les designers de Vénus

Qt Quarterly est la revue trimestrielle proposée par Nokia et à destination des développeurs Qt. Ces articles d'une grande qualité technique sont rédigés par des experts Qt. Lire l'article.

Communauté

Ressources

Liens utiles

Contact

  • Vous souhaitez rejoindre la rédaction ou proposer un tutoriel, une traduction, une question... ? Postez dans le forum Contribuez ou contactez-nous par MP ou par email (voir en bas de page).

Qt dans le magazine

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 © 2012 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 ? Un bug ? 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 !
 
 
 
 
Partenaires

Hébergement Web

Responsable bénévole de la rubrique Qt : Thibaut Cuvelier -