QDragMoveEvent(3qt)

📦 version 3.3.8b, in fedora 43, fedora 44

💖 QDragMoveEvent — the manual page, but make it make sense 💖

okay bestie, so this is QDragMoveEvent, and it lives in section 3qt of the manual (that's the Qt library section, iykyk). It's a whole class, it's giving "drag and drop main character energy", and by the end of this you're gonna know it like the back of your hand. 🦋

✨ NAME ✨

QDragMoveEvent — the event that gets sent while a drag and drop is in progress. Like, mid-drag. The vibe check of the drag. 🎀

✨ SYNOPSIS ✨

#include <qevent.h>

So the tea is: it inherits QDropEvent, and it gets inherited by QDragEnterEvent. It's a middle child, but an iconic one. 💅

🌸 Public Members 🌸

  • QDragMoveEvent ( const QPoint & pos, Type type = DragMove )
  • QRect answerRect () const
  • void accept ( const QRect & r )
  • void ignore ( const QRect & r )

✨ DESCRIPTION ✨

QDragMoveEvent is the class that provides an event sent while a drag and drop is in progress. Not before, not after — during. The moment. ⭐

So here's how it goes: when a widget accepts drop events, it will receive this event repeatedly while the drag is within the widget's boundaries. Repeatedly!! Like your bestie texting you the same screenshot four times. 😭

The widget should examine the event to see what data it provides, and accept() the drop if appropriate. That's the whole assignment, bestie. Look at the data, decide if it slays, accept it if it does.

Heads up: this class inherits most of its functionality from QDropEvent. It's not doing all the work itself, it's getting it from its parent. Nepo baby behavior, honestly, but we love it. 💜

See also Drag And Drop Classes and Event Classes.

✨ MEMBER FUNCTION DOCUMENTATION ✨

🎀 QDragMoveEvent::QDragMoveEvent ( const QPoint & pos, Type type = DragMove )

Creates a QDragMoveEvent for which the mouse is at point pos, and the event is of type type. That's it, that's the constructor. ✨

Warning: Do not create a QDragMoveEvent yourself since these objects rely on Qt's internal state. fr fr, do not. 🙈 Like, it is not going to work and you're gonna be sad about it. Let Qt handle its own internal state, babe.

🎀 void QDragMoveEvent::accept ( const QRect & r )

The same as accept(), but also notifies that future moves will also be acceptable if they remain within the rectangle r on the widget: this can improve performance, but may also be ignored by the underlying system. So it's a suggestion, a little "hey, this zone is fine" note, and the system might just be like "ok whatever" and ignore it. Rude, but true. 💀

If the rectangle is empty, then drag move events will be sent continuously. This is useful if the source is scrolling in a timer event. No cap — empty rect means constant updates, which is exactly what you want when something's scrolling on a timer. 🌈

Examples:

(that's literally it — the original just says "Examples:" and then nothing, so. iconic of it, honestly.) 🫶

🎀 QRect QDragMoveEvent::answerRect () const

Returns the rectangle for which the acceptance of the move event applies. So like, the "yes zone". The little box where your acceptance is valid. That's the answer rect. ⭐

🎀 void QDragMoveEvent::ignore ( const QRect & r )

The opposite of accept(const QRect&), i.e. it says that moves within rectangle r are not acceptable (will be ignored). The no-fly zone. The "not today" box. 💅

Example: dirview/dirview.cpp.

✨ SEE ALSO ✨

go read them bestie, they're right there 🔥

Copyright 1992-2007 Trolltech ASA, http://www.trolltech.com. See the license file included in the distribution for a complete license statement. 📜

✨ AUTHOR ✨

Generated automatically from the source code. Not a person. A robot did this. Be nice to the robot. 🤖💖

✨ BUGS ✨

If you find a bug in Qt, please report it as described in http://doc.trolltech.com/bughowto.html. Good bug reports help us to help you. Thank you. (They're literally being so polite about it. We love a gracious ask. 🫶)

The definitive Qt documentation is provided in HTML format; it is located at $QTDIR/doc/html and can be read using Qt Assistant or with a web browser. This man page is provided as a convenience for those users who prefer man pages, although this format is not officially supported by Trolltech. So like, it's a gift, not a contract. 💜

If you find errors in this manual page, please report them to qt-bugs@trolltech.com. Please include the name of the manual page (qdragmoveevent.3qt) and the Qt version (3.3.8). Don't make them guess, bestie, that's mean. 🙈

And that's the whole page!! 🌸 This iconic little number was brought to you by Trolltech AS, dated 2 February 2007, filed under QDragMoveEvent(3qt) — so when you're citing it in the group chat you know exactly where it came from. bye bestie, go accept some drops 💅✨🎀🦋

📦 where this page comes from