共用方式為


TVOT_LISTBOX

重要

新式列印平臺是 Windows 與印表機通訊的慣用方法。 我們建議您使用Microsoft的 IPP 收件匣類別驅動程式,以及列印支援應用程式 (PSA),自定義 Windows 10 和 11 中的列印體驗,以進行印表機裝置開發。

如需詳細資訊,請參閱 新式列印平臺列印支援應用程式設計指南

TVOT_LISTBOX選項類型是由群組方塊內的清單框所組成。

OPTITEM 結構

Sel/pSel
索引到選項 OPTTYPE 結構的 pOptParam 成員所指向的 OPTPARAM 陣列。 這會指定目前選取的選項參數。

OPTPARAM 結構陣列 (OPTTYPE 的 pOptParam 成員)

pData
pOptParam[0]->pData 會指向要顯示在清單框中的第一個文字字串。 pOptParam[1]->pData 指向要顯示在清單框中的第二個文字字串。 pOptParam[n]->pData 指向 要顯示在清單框中的第 n個文字字串。

IconID
pOptParam[0]->IconID 會識別要與第一個文字字串相關聯的圖示。 pOptParam[1]->IconID 會識別要與第二個文字字串相關聯的圖示。 pOptParam[n]->IconID 會識別要與 第 n個文字字串相關聯的圖示。

lParam
未使用。

OPTTYPE 結構

類型
TVOT_LISTBOX

Count
OPTPARAM 結構的數目;也就是說,要顯示在清單框中的文字字串數目。

Style
您可以指定下列選擇性位旗標。

旗標 描述
OTS_LBCB_INCL_ITEM_NONE 如果設定,CPSUI 會在清單框中包含 「None」 字串。 如果用戶選取 [無], 則 Sel/pSel 等位會設定為負數。
OTS_LBCB_NO_ICON16_IN_ITEM 如果設定,CPSUI 不會在清單框中顯示參數的值時繪製每個選項參數的圖示(OPTPARAM 中的 IconID )。
OTS_LBCB_PROPPAGE_LBUSECB 當選項顯示在非樹檢視屬性表頁面上時,它會顯示為下拉式方塊,而不是清單框。
OTS_LBCB_SORT 如果設定,CPSUI 會依字母順序顯示文字字串。

BegCtrlID
如果 COMPROPSHEETUI 中的 pDlgPage 識別 CPSUI 提供的頁面,或 DLGPAGE 中的 DlgTemplateID 識別 CPSUI 提供的範本,則不會使用 BegCtrlID。 否則, BegCtrlID 必須包含一組循序編號控制標識碼的第一個控件識別碼。 控件識別碼必須識別下列 Windows 控制項:

控制標識碼 Windows 控件
BegCtrlID 內容 群組方塊
BegCtrlID 內容+1 標題文字
BegCtrlID 內容+2 清單方塊
BegCtrlID 內容+3 清單框圖示
BegCtrlID 內容+4 [擴充] 複選框或 [擴充] 按鈕 (選擇性)
BegCtrlID 內容+5 延伸複選框或延伸按鈕圖示 (選擇性)

如需詳細資訊,請參閱 自定義 CPSUI 支援的視窗控制件

需求

標頭: compstui.h (包括 Compstui.h)

另請參閱

OPTITEM

OPTPARAM

OPTTYPE