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 檔案。

繼承階層架構

CObject

CCmdTarget

CWnd

CStatic

CVSListBoxBase

CVSListBox

需求

標頭： 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]可編輯清單控制項專案的以零起始的索引。

傳回值

包含指定專案文字的 CString 物件。

備註

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 位值。 這個值可以是應用程式特定的整數或其他資料的指標。

備註

另請參閱

階層架構圖表
類別