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 位值。 這個值可以是應用程式特定的整數或其他資料的指標。
備註
另請參閱
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應