掉落站点范例 ¶

DropArea 类是子类化的 QLabel with a public slot, clear() ，和 changed() 信号。

class DropArea : public QLabel
{
    Q_OBJECT
public:
    explicit DropArea(QWidget *parent = nullptr);
public slots:
    void clear();
signals:
    void changed(const QMimeData *mimeData = nullptr);
											

此外， DropArea also contains a private instance of QLabel and reimplementations of four QWidget event handlers:

1. dragEnterEvent()

2. dragMoveEvent()

3. dragLeaveEvent()

4. dropEvent()

These event handlers are further explained in the implementation of the DropArea 类。

protected:
    void dragEnterEvent(QDragEnterEvent *event) override;
    void dragMoveEvent(QDragMoveEvent *event) override;
    void dragLeaveEvent(QDragLeaveEvent *event) override;
    void dropEvent(QDropEvent *event) override;
private:
    QLabel *label;
};
											

在 DropArea constructor, we set the minimum size to 200x200 pixels, the frame style to both Sunken and StyledPanel , and we align its contents to the center.

DropArea::DropArea(QWidget *parent)
    : QLabel(parent)
{
    setMinimumSize(200, 200);
    setFrameStyle(QFrame::Sunken | QFrame::StyledPanel);
    setAlignment(Qt::AlignCenter);
    setAcceptDrops(true);
    setAutoFillBackground(true);
    clear();
}
											

Also, we enable drop events in DropArea by setting the acceptDrops 特性到 true . Then, we enable the autoFillBackground property and invoke the clear() 函数。

dragEnterEvent() event handler is called when a drag is in progress and the mouse enters the DropArea object. For the DropSite example, when the mouse enters DropArea , we set its text to “<drop content>” and highlight its background.

<Code snippet "draganddrop/dropsite/droparea.cpp:dragEnterEvent() function" not found>
											

Then, we invoke acceptProposedAction() on event , setting the drop action to the one proposed. Lastly, we emit the changed() signal, with the data that was dropped and its MIME type information as a parameter.

For dragMoveEvent() , we just accept the proposed QDragMoveEvent 对象， event ，采用 acceptProposedAction() .

<Code snippet "draganddrop/dropsite/droparea.cpp:dragMoveEvent() function" not found>
											

DropArea class’s implementation of dropEvent() extracts the event ‘s mime data and displays it accordingly.

<Code snippet "draganddrop/dropsite/droparea.cpp:dropEvent() function part1" not found>
											

mimeData object can contain one of the following objects: an image, HTML text, plain text, or a list of URLs.

<Code snippet "draganddrop/dropsite/droparea.cpp:dropEvent() function part2" not found>
											

• 若 mimeData contains an image, we display it in DropArea with setPixmap() .

• 若 mimeData contains HTML, we display it with setText() and set DropArea ’s text format as RichText .

• 若 mimeData contains plain text, we display it with setText() and set DropArea ’s text format as PlainText . In the event that mimeData contains URLs, we iterate through the list of URLs to display them on individual lines.

• 若 mimeData contains other types of objects, we set DropArea ’s text, with setText() to “Cannot display data” to inform the user.

We then set DropArea ‘s backgroundRole to Dark and we accept event ‘s proposed action.

<Code snippet "draganddrop/dropsite/droparea.cpp:dropEvent() function part3" not found>
											

dragLeaveEvent() event handler is called when a drag is in progress and the mouse leaves the widget.

<Code snippet "draganddrop/dropsite/droparea.cpp:dragLeaveEvent() function" not found>
											

For DropArea ‘s implementation, we clear invoke clear() and then accept the proposed event.

clear() function sets the text in DropArea to “<drop content>” and sets the backgroundRole to Dark . Lastly, it emits the changed() 信号。

<Code snippet "draganddrop/dropsite/droparea.cpp:clear() function" not found>
											

DropSiteWindow class contains a constructor and a public slot, updateFormatsTable() .

class DropSiteWindow : public QWidget
{
    Q_OBJECT
public:
    DropSiteWindow();
public slots:
    void updateFormatsTable(const QMimeData *mimeData);
    void copy();
private:
    DropArea *dropArea;
    QLabel *abstractLabel;
    QTableWidget *formatsTable;
    QPushButton *clearButton;
    QPushButton *copyButton;
    QPushButton *quitButton;
    QDialogButtonBox *buttonBox;
};
											

The class also contains a private instance of DropArea , dropArea , QLabel , abstractLabel , QTableWidget , formatsTable , QDialogButtonBox , buttonBox , and two QPushButton 对象， clearButton and quitButton .

In the constructor of DropSiteWindow , we instantiate abstractLabel and set its wordWrap 特性到 true . We also call the adjustSize() function to adjust abstractLabel ‘s size according to its contents.

DropSiteWindow::DropSiteWindow()
{
    abstractLabel = new QLabel(tr("This example accepts drags from other "
                                  "applications and displays the MIME types "
                                  "provided by the drag object."));
    abstractLabel->setWordWrap(true);
    abstractLabel->adjustSize();
											

Then we instantiate dropArea and connect its changed() signal to DropSiteWindow ‘s updateFormatsTable() 槽。

dropArea = new DropArea;
connect(dropArea, &DropArea::changed,
        this, &DropSiteWindow::updateFormatsTable);
											

We now set up the QTableWidget 对象， formatsTable . Its horizontal header is set using a QStringList 对象， labels . The number of columms are set to two and the table is not editable. Also, the formatTable ‘s horizontal header is formatted to ensure that its second column stretches to occupy additional space available.

QStringList labels;
labels << tr("Format") << tr("Content");
formatsTable = new QTableWidget;
formatsTable->setColumnCount(2);
formatsTable->setEditTriggers(QAbstractItemView::NoEditTriggers);
formatsTable->setHorizontalHeaderLabels(labels);
formatsTable->horizontalHeader()->setStretchLastSection(true);
											

Three QPushButton 对象， clearButton , copyButton ，和 quitButton , are instantiated and added to buttonBox - a QDialogButtonBox object. We use QDialogButtonBox here to ensure that the push buttons are presented in a layout that conforms to the platform’s style.

    clearButton = new QPushButton(tr("Clear"));
    copyButton = new QPushButton(tr("Copy"));
    quitButton = new QPushButton(tr("Quit"));
    buttonBox = new QDialogButtonBox;
    buttonBox->addButton(clearButton, QDialogButtonBox::ActionRole);
    buttonBox->addButton(copyButton, QDialogButtonBox::ActionRole);
#if !QT_CONFIG(clipboard)
    copyButton->setVisible(false);
#endif
    buttonBox->addButton(quitButton, QDialogButtonBox::RejectRole);
    connect(quitButton, &QAbstractButton::clicked, this, &QWidget::close);
    connect(clearButton, &QAbstractButton::clicked, dropArea, &DropArea::clear);
    connect(copyButton, &QAbstractButton::clicked, this, &DropSiteWindow::copy);
											

clicked() signals for copyButton , clearButton ，和 quitButton are connected to copy() , clear() and close() ，分别。

For the layout, we use a QVBoxLayout , mainLayout , to arrange our widgets vertically. We also set the window title to “Drop Site” and the minimum size to 350x500 pixels.

    QVBoxLayout *mainLayout = new QVBoxLayout(this);
    mainLayout->addWidget(abstractLabel);
    mainLayout->addWidget(dropArea);
    mainLayout->addWidget(formatsTable);
    mainLayout->addWidget(buttonBox);
    setWindowTitle(tr("Drop Site"));
    setMinimumSize(350, 500);
}
											

We move on to the updateFormatsTable() function. This function updates the formatsTable , displaying the MIME formats of the object dropped onto the DropArea object. First, we set QTableWidget ‘s rowCount property to 0. Then, we validate to ensure that the QMimeData object passed in is a valid object.

<Code snippet "draganddrop/dropsite/dropsitewindow.cpp:updateFormatsTable() part1" not found>
											

Once we are sure that mimeData is valid, we iterate through its supported formats.

<Code snippet "draganddrop/dropsite/dropsitewindow.cpp:updateFormatsTable() part2" not found>
											

Within each iteration, we create a QTableWidgetItem , formatItem and we set its flags to ItemIsEnabled , and its text alignment to AlignTop and AlignLeft .

A QString 对象， text , is customized to display data according to the contents of format . We invoke QString ‘s simplified() function on text , to obtain a string that has no additional space before, after or in between words.

<Code snippet "draganddrop/dropsite/dropsitewindow.cpp:updateFormatsTable() part3" not found>
											

若 format contains a list of URLs, we iterate through them, using spaces to separate them. On the other hand, if format contains an image, we display the data by converting the text to hexadecimal.

<Code snippet "draganddrop/dropsite/dropsitewindow.cpp:updateFormatsTable() part4" not found>
											

一旦 text has been customized to contain the appropriate data, we insert both format and text into formatsTable with setItem() . Lastly, we invoke resizeColumnToContents() on formatsTable ‘s first column.

Within the main() function, we instantiate DropSiteWindow and invoke its show() 函数。

<Code snippet "draganddrop/dropsite/main.cpp:main() function" not found>
											

范例工程 @ code.qt.io