Qt 學習之路:視圖選擇 (QItemSelectionModel)


 

Qt 使用QItemSelectionModel類獲取視圖中項目的選擇情況。這個模型保持有項目的索引,並且獨立於任何視圖。這意味着,我們可以讓不同的視圖共享同一個選擇模型,從來達到一種同步操作的目的。選擇由選擇區域組成。模型只將選區的開始和結束的索引位置記錄下來,以保證對於很大的選區也有很好的性能。非連續選區則由多個連續選擇組成。

選擇會直接應用於選擇模型所維護的那些被選中的索引上面。最新的選擇就是當前選擇。這意味着,即便界面上沒有顯示有任何項目被選擇,如果通過某些命令對選區進行操作,同樣會有作用。

在視圖中,始終存在一個當前項和被選擇項(即便從界面上看不到有任何選擇)。與通常所想的不同,當前項和選擇項是相互獨立的兩個狀態。一個項目可以即是當前項又是選擇項。下表是當前項和選擇項的區別:

當前項 選擇項
只能有一個當前項。 可以有多個選擇項。
使用鍵盤或者鼠標點擊可以改變當前項。 選擇項使用兩種狀態:選擇和未選擇,這取決於項目之前的狀態和其它一些設置,例如,單選或多選。只有在用戶進行交互的時候,這種狀態才會發生改變。
當前項可以使用 F2 或者鼠標雙擊進行編輯(前提是程序允許)。 當前項可以結合另外一個錨點指定被選擇或者去除選擇的一塊選區(或二者的結合)。
當前項通常會有一個焦點框進行標識。 選擇項使用選區顏色進行標識。

在處理選擇的時候,我們可以將QItemSelectionModel當成數據模型中所有數據項的選擇狀態的一個記錄。一旦選擇模型創建好,這些數據項就可以在不知道哪些項被選擇的情況下進行選擇、取消選擇或者改變選擇狀態的操作。所有被選擇項的索引都在可隨時更改,其它組件也可以通過信號槽機制修改這些選擇的信息。

標准視圖類(QListViewQTreeView以及QTableView)已經提供了默認的選擇模型,足以滿足大多數應用程序的需求。某一個視圖的選擇模型可以通過selectionModel()函數獲取,然后使用setSelectionModel()提供給其它視圖共享,因此,一般沒有必要新建選擇模型。

如果需要創建一個選區,我們需要指定一個模型以及一對索引,使用這些數據創建一個QItemSelection對象。這兩個索引應該指向給定的模型中的數據,並且作為一個塊狀選區的左上角和右下角的索引。為了將選區應用到模型上,需要將選區提交到選擇模型。這種操作有多種實現,對於現有選擇模型有着不同的影響。

下面我們來看一些代碼片段。首選構建一個總數 32 個數據項的表格模型,然后將其設置為一個表格視圖的數據:

在代碼的最后,我們獲得QTableView的選擇模型,以備以后使用。現在,我們沒有修改模型中的數據,而是選擇表格左上角的一些單元格。下面我們來看看代碼如何實現:

接下來,我們將獲得的兩個索引定義為選區。為達這一目的,我們首先構造一個QItemSelection對象,然后將其賦值給我們獲取的選擇模型:

正如前面我們說的,首先利用左上角和右下角的坐標構建一個QItemSelection對象,然后將這個對象設置為選擇模型的選擇區。select()函數的第一個參數就是需要選擇的選區,第二個參數是選區的標志位。Qt 提供了很多不同的操作,可以參考下QItemSelectionModel::SelectionFlags的文檔。在本例中,我們使用了QItemSelectionModel::Select,這意味着選區中所包含的所有單元格都會被選擇。

下面就是我們的運行結果:

視圖選區示例

現在我們知道如何設置選區。下面來看看如何獲取選區。獲取選區需要使用selectedIndexes()函數。該函數返回一個無序列表。我們可以通過遍歷這個列表獲得哪些被選擇:

在選擇發生更改時,選擇模型會發出信號。我們可以連接selectionChanged()信號,在選區改變時檢查哪個項目發生了變化。這個信號有兩個參數:第一個是新選擇的項目,第二個是剛剛被取消選擇的項目。在下面的示例中,我們通過selectionChanged()信號,將所有新選擇的項目填充字符串,將所有被取消選擇的部分清空:

通過currentChanged(),我們可以追蹤當前有焦點的項。同selectionChanged()信號類似,這個信號也有兩個參數:第一個是新的當前項,第二個是上一個當前項。下面的代碼則是該信號的使用:

這些信號可以用來監控選區的改變。如果你還要直接更新選區,我們還有另外的方法。

同樣是利用前面所說的QItemSelectionModel::SelectionFlag,我們可以對選區進行組合操作。還記得我們在前面的select()函數中使用過的第二個參數嗎?當我們替換這個參數,就可以獲得不同的組合方式。最常用的就是QItemSelectionModel::Select,它的作用是將所有指定的選區都選擇上。QItemSelectionModel::Toggle則是一種取反的操作:如果指定的部分原來已經被選擇,則取消選擇,否則則選擇上。QItemSelectionModel::Deselect則是取消指定的已選擇的部分。在下面的例子中,我們使用QItemSelectionModel::Toggle對前面的示例作進一步的操作:

運行結果將如下所示:

視圖選區示例 Toggle

默認情況下,選擇操作會只會影響到指定的模型索引。但是,我們也可以改變這一設置。例如,只選擇整行或者整列:

上面的代碼,我們依然使用兩個索引設置了一個區域,但是,在選擇的使用我們使用了QItemSelectionModel::RowsQItemSelectionModel::Columns這兩個參數,因此只會選擇這兩個區域中指定的行或者列:

視圖選區示例 Rows Columns

使用QItemSelectionModel::Current參數可以將當前選區替換為新的選區;使用QItemSelectionModel::Clear則會將原來已有的選區全部取消。為了進行全選,我們可以設置選區為左上角和右下角兩個索引:


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM