ListView 控制項
ListView 控件，顯示值的單一數據行，每個專案旁邊都有圖示。 它可讓使用者從預先決定清單選取屬性的單一字串或整數值。 可能的值會從 ListView 數據表讀取。 您可以將屬性的名稱輸入 Control 資料表的 Property 資料行，讓控件與整數或字串值產生關聯。
ListView 控件永遠不會顯示 Control 數據表的 Text 字段內容。 相反地，此欄位會指定要由控件顯示的文字樣式，並包含螢幕檢閱公用程式所使用的控件描述。 若要設定文字字串的字型和字型樣式，請在顯示字元的字串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 數據表之 TextStyle 數據行中列出的標識碼。 如果兩者都不存在，但 DefaultUIFont 屬性會定義為有效的文字樣式，則會使用該字型。 螢幕檢閱公用程式會讀取下列資訊做為控件的描述。 請參閱 輔助功能。
控件屬性
您可以使用下列屬性搭配此控制件。 若要使用事件變更屬性的值，請將控件訂閱至 EventMapping 數據表中的 ControlEvent，並在 [屬性] 資料行中列出屬性的識別碼。 在 [事件] 數據行中輸入 ControlEvent 的標識碼。
| 屬性標識碼 | 十六進位位 | 描述 |
|---|---|---|
| IndirectPropertyName | 這是與控件相關聯的間接屬性名稱。 如果已設定 Indirect 屬性位，控制項會顯示或變更具有這個名稱的屬性值。 如果已設定 Indirect 屬性位，這個名稱也是 Control 資料表的 Property 資料行中列出的屬性值。 | |
| 位置 | 控件在對話框中的位置。 在控件數據表的 Width、Height、X 和 Y 資料行中，輸入控件左角的寬度、高度和座標。 使用 安裝程式單位 的長度和距離。 |
|
| PropertyName | 這是與這個控件相關聯的屬性名稱。 如果未設定 Indirect 屬性位，控制項會顯示或變更具有這個名稱的屬性值。 此屬性是在 Control 資料表的 Property 資料行中指定。 | |
| PropertyValue | 這個控件所顯示或變更之屬性的目前值。 如果未設定 Indirect 屬性位，這是 PropertyName 的值。 如果已設定 Indirect 屬性位，這是 IndirectPropertyName 的值。 如果屬性變更，控件會反映新的值。 | |
| Text | 若要在螢幕助讀程式中顯示文字，請在 [控件] 資料表的 [文字] 資料行中輸入文字。 請參閱 輔助功能。 | |
| Visible | 0x00000000 0x00000001 |
隱藏的控件。 可見控制件。 將這個位包含在 Control 資料表中 Attributes 數據行的位字中，讓控件在建立時可見或隱藏。 您也可以使用 ControlCondition 資料表來隱藏或顯示控件。 |
| 已啟用 | 0x00000000 0x00000002 |
處於停用狀態的控制件。 處於啟用狀態的控制件。 將這個位包含在控件的 [屬性] 數據行的位字中，以在建立時啟用控件。 您也可以使用 ControlCondition 數據表來啟用或停用控件。 |
| 沉沒 | 0x00000000 0x00000004 |
顯示預設的視覺化樣式。 以沉沒的 3D 外觀顯示控制件。 在 Control 資料表的 [屬性] 資料行中，將這些位包含在位字中。 |
| 間接 | 0x00000000 0x00000008 |
控制項會在 Control 資料表的 [屬性] 資料行中顯示或變更 屬性的值。 控件會顯示或變更屬性的值，其標識符列在 Control 數據表的 Property 資料行中。 判斷與這個控件相關聯的屬性是否間接參考。 |
| 整數 | 0x00000000 0x00000010 |
與控件相關聯的屬性是字串值。 與控件相關聯的屬性是整數值。 將這個位包含在 Control 數據表的 Attributes 數據行的位字中，以在建立控件時設定此屬性。 |
| RTLRO | 0x00000000 0x00000020 |
控件中的文字會以從左至右的閱讀順序顯示。 控件中的文字會以從右至左的閱讀順序顯示。 |
| RightAligned | 0x00000000 0x00000040 |
控件中的文字會對齊左邊。 控件中的文字會對齊右邊。 |
| LeftScroll | 0x00000000 0x00000080 |
滾動條位於控件右側。 滾動條位於控件的左側。 |
| BiDi | 0x000000E0 | 為 RTLRO、RightAligned 和 LeftScroll 屬性的組合設定此值。 |
| 排序 | 0x00000000 0x00010000 |
依字母順序顯示的專案。 以 ListView 資料表中指定的順序顯示的專案。 將這個位包含在 Attributes 數據行的位字中，以 ListView 資料表之 Order 資料行所指定的順序顯示專案。 |
| FixedSize | 0x00000000 0x00100000 |
縮放圖示影像以符合控件。 裁剪或置中控件中的圖示影像。 將這個位包含在 Control 資料表之 Attributes 數據行的位字中。 |
| IconSize | 0x00000000 0x00200000 0x00400000 0x00600000 |
載入第一個影像。 載入前 16x16 影像。 載入前 32x32 影像。 載入前 48x48 映像。 圖示檔案可以包含相同圖示的不同大小影像。 在 Control 資料表的 [屬性] 資料行中包含適當位字的值 如果未設定這些位，安裝程式會忽略 FixedSize 屬性，並延展影像以符合控件矩形。 如果同時設定 IconSize 位和 FixedSize 位，則小於控件的影像置中，且影像大於壓縮以符合的控件。 |
備註
您可以使用 CreateWindowEx 函式，從 WC_LISTVIEW 類別建立此控件。 它具有LVS_REPORT、LVS_NOCOLUMNHEADER、WS_VSCROLL、WS_HSCROLL、LVS_SHAREIMAGELISTS、LVS_SINGLESEL、LVS_SHOWSELALWAYS、WS_BORDER和WS_TABSTOP樣式。 如果排序的樣式位不在上，控件也有 LVS_SORTASCENDING 樣式。
為了與螢幕助讀程式相容，在撰寫具有 ListView 控件的對話做為第一個使用中控件時，您必須將屬於編輯欄位的文字欄位設為 Dialog 資料表中的第一個使用中控制件。 由於靜態文字無法取得焦點，因此在建立對話框時，編輯字段一開始會有焦點，但這樣做可確保螢幕助讀程序顯示正確的資訊。