共用方式為

ROWLIST 範例：示範選取清單檢視的整列

  • 發行項

更新：2007 年 11 月

ROWLIST 範例說明選取 CListView MFC 通用控制項類別的報表模式的整列。範例會實作一個可重複使用的類別 (CListViewEx)，這個類別會提供整列選取為清單檢視控制項的其他檢視模式。CListViewEx 會使用主控描繪模式來執行控制項的所有繪製。您可以在專案中直接使用類別或是將類別當做基底類別使用。ROWLIST 也會示範如何以清單檢視控制項來使用狀態和覆疊的影像。

安全性注意事項：

這個程式碼範例僅供概念說明之用，同時因為範例中的程式碼撰寫並沒有周全的顧及所有安全性問題，所以本範例不適用於實際執行的應用程式或網站中。如果使用者擅自將範例程式碼用於其他意圖而導致連帶事件或重大損害時，Microsoft 將不承擔任何責任。

若要取得範例和指示以便進行安裝：

  • 按一下 Visual Studio [說明] 功能表上的 [範例]。

    如需詳細資訊，請參閱尋找範例檔案。

  • 最新版的完整範例清單可從 Visual Studio 2008 範例網頁 (英文) 取得。

  • 您也可以將範例置於電腦硬碟中。根據預設，範例和讀我檔案都會複製到 \Program Files\Visual Studio 9.0\Samples\ 下的資料夾中。對於所有的 Visual Studio Express 版，所有範例都可在線上找到。

建置和執行範例

若要建置並執行 ROWLIST 範例

  1. 開啟 rowlist.sln 方案。

  2. 在 [建置] 功能表上，按一下 [建置]。

  3. 在 [偵錯] 功能表上，按一下 [啟動但不偵錯]。

執行 ROWLIST 時，它會呈現一個單一文件介面 (SDI) 應用程式，這個應用程式的檢視是 CListView 衍生類別。這個檢視的項目呈現了不同的色彩和其他相關的資料。清單檢視控制項一開始便是在報表模式，並啟用了整列選取。[檢視] 功能表和工具列可以讓您選取其他的檢視模式。

狀態影像一開始是設定成在每個項目左邊的空白方形。如果您按一下狀態影像，項目的影像會變成標題列上所顯示的圖示。如果狀態影像沒有顯示，您可以按兩下項目來變更它的狀態。

CListViewEx 類別

CListViewEx 類別 (衍生自 CListView) 是能夠實作整列選取模式的可重複使用類別。此類別會提供清單檢視控制項的主控描繪模式的完整支援，而且會藉由實作所有影像和標籤的繪製程式碼，提供整列選取。CListViewEx 會像在報表模式中一樣，顯示控制項的影像和標籤，但另外加入整列選取。類別只有兩種其他成員函式 (與 CListView 比較)：SetFullRowSel 和 GetFullRowSel。這些函式是用來設定或查詢整列選取模式。

您可以重複使用專案中的類別，方法是從類別衍生該類別，或是直接使用該類別。使用這個類別最簡單的方式，是使用應用程式精靈來建立具有 CListView 衍生類別的應用程式，然後再將它的基底類別變更為 CListViewEx。

與 CListView 搭配使用狀態和覆疊影像

ROWLIST 會示範狀態和覆疊影像的使用方法。狀態影像一開始是設定成在每個項目左邊的空白方形。如果您按一下狀態影像，項目的影像會變成標題列上所顯示的圖示。在回應中，項目的狀態圖示會變更為帶有核取記號的方形。CRowListView::OnLButtonDown 包含一段在選取狀態圖示時會插入核取記號、且會變更某個項目狀態圖示的程式碼。

如果沒有顯示狀態圖示，則目前使用中之影像的頂端就會標示一個覆疊影像 (帶有核取記號的灰色方形)。您可以按兩下滑鼠來變更項目的狀態，這種作法也可以開啟或關閉覆疊影像。CRowListView::OnLButtonDblClk 中有按兩下滑鼠的實作程式碼。

注意事項：

部分範例 (包括本範例) 尚未經過改寫，無法反映出目前在 Visual C++ 精靈、程式庫以及編譯器方面的變更，不過還是可以示範如何完成您要進行的工作。

請參閱

其他資源

MFC 範例