鍍金池/ 教程/ C/ 自定義拖放數據對象
Qt 容器和算法拾遺
自定義 model 之一
反走樣
Hello, world!
Qt 容器類之關聯存儲容器
QStringListModel
拖放技術之一
狀態(tài)欄
QTreeWidget
拖放技術之二
通用算法
event()
Qt 學習之路(18): Qt 標準對話框之 QInputDialog
Qt 容器類之遍歷器和隱式數據共享
QListWidget
Meta-Object 系統(tǒng)
事件接收與忽略
Qt 學習之路(tip): parent 參數
Qt 標準對話框之 QColorDialog
QPainter(續(xù))
國際化(下)
漸變填充
自定義委托
創(chuàng)建 shared library
model-view 架構
Graphics View Framework
自定義拖放數據對象
QSortFilterProxyModel
國際化(上)
組件布局
自定義 Model 之三
事件過濾器
QDirModel
Hello, world!(續(xù))
Qt 標準對話框之 QFileDialog
自定義 model 之二
深入了解信號槽
坐標變換
剪貼板操作
QTableWidget
QByteArray 和 QVariant
創(chuàng)建一個對話框(下)
Qt 學習之路(32): 一個簡易畫板的實現(Graphics View)
文本文件讀寫
自定義事件
編寫跨平臺的程序
MainWindow
初探信號槽
Qt 學習之路(17): Qt 標準對話框之 QMessageBox
繪圖設備
菜單和工具條(續(xù))
二進制文件讀寫
QString
事件(event)
菜單和工具條
QPainter
Qt 容器類之順序存儲容器
進程間交互
API 文檔的使用
創(chuàng)建一個對話框(上)
一個簡易畫板的實現(QWidget)

自定義拖放數據對象

前面的例子都是使用的系統(tǒng)提供的拖放對象 QMimeData 進行拖放數據的存儲,比如使用 QMimeData::setText() 創(chuàng)建文本,使用 QMimeData::urls() 創(chuàng)建 URL 對象。但是,如果你希望使用一些自定義的對象作為拖放數據,比如自定義類等等,單純使用 QMimeData 可能就沒有那么容易了。為了實現這種操作,我們可以從下面三種實現方式中選擇一個:

  • 將自定義數據作為 QByteArray 對象,使用 QMimeData::setData() 函數作為二進制數據存儲到 QMimeData 中,然后使用 QMimeData::Data() 讀?。?/li>
  • 繼承 QMimeData,重寫其中的 formats() 和 retrieveData() 函數操作自定義數據;
  • 如果拖放操作僅僅發(fā)生在同一個應用程序,可以直接繼承 QMimeData,然后使用任意合適的數據結構進行存儲。

第一種方法不需要繼承任何類,但是有一些局限:即是拖放不會發(fā)生,我們也必須將自定義的數據對象轉換成 QByteArray 對象;如果你希望支持很多種拖放的數據,那么每種類型的數據都必須使用一個 QMimeData 類,這可能會導致類爆炸;如果數據很大的話,這種方式可能會降低系統(tǒng)的可維護性。然而,后兩種實現方式就不會有這些問題,或者說是能夠減小這種問題,并且能夠讓我們有完全控制權。 我們先來看一個應用,使用 QTableWidget 來進行拖放操作,拖放的類型包括 plain/text,plain/html 和 plain/csv。如果使用第一種實現方法,我們的代碼將會如下所示:


void MyTableWidget::mouseMoveEvent(QMouseEvent *event)  
{  
    if (event->buttons() & Qt::LeftButton) {  
        int distance = (event->pos() - startPos).manhattanLength();  
        if (distance >= QApplication::startDragDistance())  
            performDrag();  
    }  
    QTableWidget::mouseMoveEvent(event);  
}  

void MyTableWidget::performDrag()  
{  
    QString plainText = selectionAsPlainText();  
    if (plainText.isEmpty())  
        return;  

    QMimeData *mimeData = new QMimeData;  
    mimeData->setText(plainText);  
    mimeData->setHtml(toHtml(plainText));  
    mimeData->setData("text/csv", toCsv(plainText).toUtf8());  

    QDrag *drag = new QDrag(this);  
    drag->setMimeData(mimeData);  
    if (drag->exec(Qt::CopyAction | Qt::MoveAction) == Qt::MoveAction)  
        deleteSelection();  
}  

對于這段代碼,我們應該已經很容易的理解:在 performDrag() 函數中,我們調用 QMimeData 的 setText() 和 setHTML() 函數存儲 plain/text 和 plain/html 數據,使用 setData() 將 text/csv 類型的數據作為二進制 QByteArray 類型存儲。


QString MyTableWidget::toCsv(const QString &plainText)  
{  
    QString result = plainText;  
    result.replace("\\", "\\\\");  
    result.replace("\"", "\\\"");  
    result.replace("\t", "\", \"");  
    result.replace("\n", "\"\n\"");  
    result.prepend("\"");  
    result.append("\"");  
    return result;  
}  

QString MyTableWidget::toHtml(const QString &plainText)  
{  
    QString result = Qt::escape(plainText);  
    result.replace("\t", "<td>");  
    result.replace("\n", "\n<tr><td>");  
    result.prepend("<table>\n<tr><td>");  
    result.append("\n</table>");  
    return result;  
}  

toCsv() 和 toHtml() 函數將數據取出并轉換成我們需要的 csv 和 html類型的數據。例如,下面的數據


Red   Green   Blue
Cyan  Yellow  Magenta

轉換成 csv 格式為:


"Red", "Green", "Blue"
"Cyan", "Yellow", "Magenta"

轉換成 html 格式為:

Red Green Blue
Cyan Yellow Magenta

在放置的函數中我們像以前一樣使用:


void MyTableWidget::dropEvent(QDropEvent *event)  
{  
    if (event->mimeData()->hasFormat("text/csv")) {  
        QByteArray csvData = event->mimeData()->data("text/csv");  
        QString csvText = QString::fromUtf8(csvData);  
        // ...  
        event->acceptProposedAction();  
    } else if (event->mimeData()->hasFormat("text/plain")) {  
        QString plainText = event->mimeData()->text();  
        // ...  
        event->acceptProposedAction();  
    }  
}  

雖然我們接受三種數據類型,但是在這個函數中我們只接受兩種類型。至于 html 類型,我們希望如果用戶將 QTableWidget 的數據拖到一個 HTML 編輯器,那么它就會自動轉換成 html 代碼,但是我們不計劃支持將外部的 html 代碼拖放到 QTableWidget 上。為了讓這段代碼能夠工作,我們需要在構造函數中設置 setAcceptDrops(true) 和 setSelectionMode(ContiguousSelection)。

好了,上面就是我們所說的第一種方式的實現。這里并沒有給出完整的實現代碼,大家可以根據需要自己實現一下試試。下面我們將按照第二種方法重新實現這個需求。


class TableMimeData : public QMimeData  
{  
    Q_OBJECT  

public:  
    TableMimeData(const QTableWidget *tableWidget,  
                  const QTableWidgetSelectionRange &range);  

    const QTableWidget *tableWidget() const { return myTableWidget; }  
    QTableWidgetSelectionRange range() const { return myRange; }  
    QStringList formats() const;  

protected:  
    QVariant retrieveData(const QString &format,  
                          QVariant::Type preferredType) const;  

private:  
    static QString toHtml(const QString &plainText);  
    static QString toCsv(const QString &plainText);  

    QString text(int row, int column) const;  
    QString rangeAsPlainText() const;  

    const QTableWidget *myTableWidget;  
    QTableWidgetSelectionRange myRange;  
    QStringList myFormats;  
}; 

為了避免存儲具體的數據,我們存儲 table 和選擇區(qū)域的坐標的指針。


TableMimeData::TableMimeData(const QTableWidget *tableWidget,  
                             const QTableWidgetSelectionRange &range)  
{  
    myTableWidget = tableWidget;  
    myRange = range;  
    myFormats << "text/csv" << "text/html" << "text/plain";  
}  

QStringList TableMimeData::formats() const 
{  
    return myFormats;  
} 

構造函數中,我們對私有變量進行初始化。formats() 函數返回的是被 MIME 數據對象支持的數據類型列表。這個列表是沒有先后順序的,但是最佳實踐是將“最適合”的類型放在第一位。對于支持多種類型的應用程序而言,有時候會直接選用第一個符合的類型存儲。


QVariant TableMimeData::retrieveData(const QString &format,  
                                     QVariant::Type preferredType) const 
{  
    if (format == "text/plain") {  
        return rangeAsPlainText();  
    } else if (format == "text/csv") {  
        return toCsv(rangeAsPlainText());  
    } else if (format == "text/html") {  
        return toHtml(rangeAsPlainText());  
    } else {  
        return QMimeData::retrieveData(format, preferredType);  
    }  
} 

函數 retrieveData() 將給出的 MIME 類型作為 QVariant 返回。參數 format 的值通常是 formats() 函數返回值之一,但是我們并不能假定一定是這個值之一,因為并不是所有的應用程序都會通過 formats() 函數檢查 MIME 類型。一些返回函數,比如 text(), html(), urls(), imageData(), colorData() 和 data() 實際上都是在 QMimeData 的 retrieveData() 函數中實現的。第二個參數 preferredType 給出我們應該在 QVariant 中存儲哪種類型的數據。在這里,我們簡單的將其忽略了,并且在 else 語句中,我們假定 QMimeData 會自動將其轉換成所需要的類型。


void MyTableWidget::dropEvent(QDropEvent *event)  
{  
    const TableMimeData *tableData =  
            qobject_cast<const TableMimeData *>(event->mimeData());  

    if (tableData) {  
        const QTableWidget *otherTable = tableData->tableWidget();  
        QTableWidgetSelectionRange otherRange = tableData->range();  
        // ...  
        event->acceptProposedAction();  
    } else if (event->mimeData()->hasFormat("text/csv")) {  
        QByteArray csvData = event->mimeData()->data("text/csv");  
        QString csvText = QString::fromUtf8(csvData);  
        // ...  
        event->acceptProposedAction();  
    } else if (event->mimeData()->hasFormat("text/plain")) {  
        QString plainText = event->mimeData()->text();  
        // ...  
        event->acceptProposedAction();  
    }  
    QTableWidget::mouseMoveEvent(event);  
} 

在放置的函數中,我們需要按照我們自己定義的數據類型進行選擇。我們使用 qobject_cast 宏進行類型轉換。如果成功,說明數據來自同一應用程序,因此我們直接設置 QTableWidget 相關 數據,如果轉換失敗,我們則使用一般的處理方式。

本文出自 “豆子空間” 博客,請務必保留此出處 http://devbean.blog.51cto.com/448512/193918

上一篇:拖放技術之一下一篇:國際化(下)