CVSListBox 類別
類別 CVSListBox 支援可編輯的清單控制件。
語法
class CVSListBox : public CVSListBoxBase
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| CVSListBox：：CVSListBox | 建構 CVSListBox 物件。 |
CVSListBox::~CVSListBox |
解構函式。 |
公用方法
| 名稱 | 描述 |
|---|---|
| CVSListBox：：AddItem | 將字串新增至清單控制件。 (覆寫 CVSListBoxBase::AddItem。) |
| CVSListBox：：EditItem | 在清單控制項專案的文字上啟動編輯作業。 (覆寫 CVSListBoxBase::EditItem。) |
| CVSListBox：：GetCount | 擷取可編輯清單控制的字串數目。 (覆寫 CVSListBoxBase::GetCount。) |
| CVSListBox：：GetItemData | 擷取與可編輯清單控制件專案相關聯的應用程式特定32位值。 (覆寫 CVSListBoxBase::GetItemData。) |
| CVSListBox：：GetItemText | 擷取可編輯清單控制項專案的文字。 (覆寫 CVSListBoxBase::GetItemText。) |
| CVSListBox：：GetSelItem | 擷取可編輯清單控制項中目前選取專案的以零起始的索引。 (覆寫 CVSListBoxBase::GetSelItem。) |
CVSListBox::PreTranslateMessage |
在分派至 TranslateMessage 和 DispatchMessage Windows 函式之前，翻譯視窗訊息。 如需詳細資訊和方法語法，請參閱 CWnd：:P reTranslateMessage。 (覆寫 CVSListBoxBase::PreTranslateMessage。) |
| CVSListBox：：RemoveItem | 從可編輯的清單控制件中移除專案。 (覆寫 CVSListBoxBase::RemoveItem。) |
| CVSListBox：：SelectItem | 選取可編輯的清單控制件字串。 (覆寫 CVSListBoxBase::SelectItem。) |
| CVSListBox：：SetItemData | 將應用程式特定的32位值與可編輯的清單控制件專案產生關聯。 (覆寫 CVSListBoxBase::SetItemData。) |
受保護的方法
| 名稱 | 描述 |
|---|---|
| CVSListBox：：GetListHwnd | 傳回目前內嵌清單檢視控件的句柄。 |
備註
類別 CVSListBox 提供一組編輯按鈕，讓用戶能夠建立、修改、刪除或重新排列清單控件中的專案。
以下是可編輯清單控制件的圖片。 選取標題為 「Item2」 的第二個清單項目進行編輯。
如果您使用資源編輯器來新增可編輯的清單控制件，請注意 編輯器的 [工具箱 ] 窗格未提供預先定義的可編輯清單控制件。 請改為新增靜態控件，例如 Group Box 控制件。 架構會使用靜態控件做為佔位元，以指定可編輯清單控制元件的大小和位置。
若要在對話框範本中使用可編輯的清單控制件，請在您的對話框類別中宣告 CVSListBox 變數。 若要支援變數與控件之間的數據交換，請在對話框的方法中DoDataExchange定義DDX_Control巨集專案。 根據預設，會建立可編輯的清單控件，而不需要編輯按鈕。 使用繼承的 CVSListBoxBase：：SetStandardButtons 方法來啟用編輯按鈕。
如需詳細資訊，請參閱 Samples 目錄、 New Controls 範例、Page3.cpp和 Page3.h 檔案。
繼承階層架構
CVSListBoxBase
需求
標頭： afxvslistbox.h
CVSListBox：：AddItem
將字串新增至清單控制件。
virtual int AddItem(
const CString& strIext,
DWORD_PTR dwData=0,
int iIndex=-1);
參數
strIext
[in]字串的參考。
dwData
[in]與字串相關聯的應用程式特定32位值。 預設值為 0。
iIndex
[in]將保存字串之位置之以零起始的索引。 如果 iIndex 參數是 -1，字串就會新增至清單結尾。 預設值為 -1。
傳回值
字串在清單控制件中位置之以零起始的索引。
備註
使用 CVSListBox：：GetItemData 方法來擷取 dwData 參數所指定的值。 這個值可以是應用程式特定的整數或其他數據的指標。
CVSListBox：：CVSListBox
建構 CVSListBox 物件。
CVSListBox();
傳回值
備註
CVSListBox：：EditItem
在清單控制項專案的文字上啟動編輯作業。
virtual BOOL EditItem(int iIndex);
參數
iIndex
[in]清單控制件專案的以零起始的索引。
傳回值
如果編輯作業成功啟動，則為TRUE;否則為 FALSE。
備註
用戶可按兩下專案的標籤，或在專案具有焦點時按下 F2 或 SPACEBAR 鍵來啟動編輯作業。
CVSListBox：：GetCount
擷取可編輯清單控制的字串數目。
virtual int GetCount() const;
傳回值
清單控制項中的項目數。
備註
請注意，計數大於最後一個專案的索引值，因為索引是以零起始。
CVSListBox：：GetItemData
擷取與可編輯清單控制件專案相關聯的應用程式特定32位值。
virtual DWORD_PTR GetItemData(int iIndex) const;
參數
iIndex
[in]可編輯清單控制項專案的以零起始的索引。
傳回值
與指定專案相關聯的32位值。
備註
使用 CVSListBox：：SetItemData 或 CVSListBox：：AddItem 方法，將 32 位值與列表控制項專案產生關聯。 這個值可以是應用程式特定的整數或其他數據的指標。
CVSListBox：：GetItemText
擷取可編輯清單控制項專案的文字。
virtual CString GetItemText(int iIndex) const;
參數
iIndex
[in]可編輯清單控制項專案的以零起始的索引。
傳回值
備註
CVSListBox：：GetListHwnd
傳回目前內嵌清單檢視控件的句柄。
virtual HWND GetListHwnd() const;
傳回值
內嵌清單檢視控件的句柄。
備註
使用此方法可擷取支援 類別之內嵌清單檢視控件的 CVSListBox 句柄。
CVSListBox：：GetSelItem
擷取可編輯清單控制項中目前選取專案的以零起始的索引。
virtual int GetSelItem() const;
傳回值
如果此方法成功，則為目前選取專案之以零起始的索引;否則為 -1。
備註
CVSListBox：：RemoveItem
從可編輯的清單控制件中移除專案。
virtual BOOL RemoveItem(int iIndex);
參數
iIndex
[in]可編輯清單控制項專案的以零起始的索引。
傳回值
如果移除指定的專案，則為TRUE;否則為 FALSE。
備註
CVSListBox：：SelectItem
選取可編輯的清單控制件字串。
virtual BOOL SelectItem(int iItem);
參數
iItem
[in]可編輯清單控制項專案的以零起始的索引。
傳回值
如果此方法成功，則為TRUE;否則為 FALSE。
備註
這個方法會選取指定的專案，如果需要，請將專案捲動到檢視中。
CVSListBox：：SetItemData
將應用程式特定的32位值與可編輯的清單控制件專案產生關聯。
virtual void SetItemData(
int iIndex,
DWORD_PTR dwData);
參數
iIndex
[in]可編輯清單控制項專案的以零起始的索引。
dwData
[in]32 位值。 這個值可以是應用程式特定的整數或其他數據的指標。