VolumeCostList 控件

VolumeCostList 控件會顯示與不同磁碟區上選取專案相關聯的成本相關信息。 控件會顯示目前安裝所涉及的所有磁碟區,以及屬性位中所指定類型的所有磁碟區。 如果所需的磁碟空間超過某些磁碟驅動器上可用的數量,則會在數據表中反白顯示磁碟區。 按兩下資料列標頭會根據所選的資料列來排序磁碟區。

下列字串用於控件中的數據行標題,而且必須在UIText資料表指定:

  • VolumeCostAvailable
  • VolumeCostDifference
  • VolumeCostRequired
  • VolumeCostSize
  • VolumeCostVolume

下列四個本地化字串用於格式化檔案的大小:

  • Bytes
  • K b
  • M b
  • G b

作者可以在 VolumeCostList 控件中設定欄寬,方法是在任何字型規格之後附加欄寬。 數據行寬度會以以大括弧括住的一系列正整數來輸入。 空白大括弧或 {0} 隱藏資料行。 負數或無法轉換成正整數的字串是無效的數據行寬度。 當數列中遇到無效的數據行寬度時,會隱藏其餘的數據行。 最多可以指定五欄寬度。

Control 數據表Text 字段內容永遠不會由 VolumeCostList 控件顯示。 相反地,此欄位會指定要由控件顯示的文字樣式,並包含螢幕檢閱公用程式所使用的控件描述。 若要設定文字字串的字型和字型樣式,請在顯示字元的字串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 數據表之 TextStyle 數據行中列出的標識碼。 如果兩者都不存在,但 DefaultUIFont 屬性會定義為有效的文字樣式,則會使用該字型。 螢幕檢閱公用程式會讀取下列資訊做為控件的描述。 請參閱 輔助功能

請注意,當使用者進入PathEdit控制件、瀏覽對話框、DirectoryList控件DirectoryCombo 控件時安裝程式不會更新 VolumeCostControl 的內容,因為沒有與 VolumeCostList 控件相關聯的屬性。

控件屬性

您可以使用下列屬性搭配此控制件。 若要使用事件變更屬性的值,請將控件訂閱至 EventMapping 數據表中的 ControlEvent,並在 [屬性] 資料行中列出屬性的識別碼。 在 [事件] 數據行中輸入 ControlEvent 的標識碼。

屬性標識碼 十六進位位 描述
位置
對話框中控件的位置。
在控件數據表的 Width、Height、X 和 Y 資料行中,輸入控件左角的寬度、高度和座標。 使用 安裝程式單位 的長度和距離。
Text
若要在螢幕助讀程式中顯示文字,請在 [控件] 資料表[文字] 資料行中輸入文字。 請參閱 輔助功能
若要在 VolumeCostList 控件中設定欄寬,請將欄寬附加至任何字型規格。 數據行寬度會以以大括弧括住的一系列正整數來輸入。 空白大括弧或 {0} 隱藏資料行。 負數或無法轉換成正整數的字串是無效的數據行寬度。 當數列中遇到無效的數據行寬度時,會隱藏其餘的數據行。 最多可以指定五欄寬度。
Visible
0x00000000
0x00000001
隱藏的控件。
可見控制件。
將這個位包含在 Control 資料表中 Attributes 數據行的位字中,讓控件在建立時可見或隱藏。
您也可以使用 ControlCondition 資料表來隱藏或顯示控件。
已啟用
0x00000000
0x00000002
處於停用狀態的控制件。
處於啟用狀態的控制件。
將這個位包含在控件[屬性] 數據行的位字中,以在建立時啟用控件。
您也可以使用 ControlCondition 數據表來啟用或停用控件。
沉沒
0x00000000
0x00000004
顯示預設的視覺化樣式。
以沉沒的 3D 外觀顯示控制件。
在 Control 資料表的 [屬性] 資料行中,將這些位包含在位字中
RTLRO
0x00000000
0x00000020
控件中的文字會顯示由左至右閱讀順序。
控件中的文字會顯示由右至左的閱讀順序。
RightAligned
0x00000000
0x00000040
控件中的文字會對齊左邊。
控件中的文字會對齊右邊。
LeftScroll
0x00000000
0x00000080
滾動條位於控件右側。
滾動條位於控件的左側。
BiDi
0x000000E0
為 RTLRORightAlignedLeftScroll 屬性的組合設定此值。
RemovableVolume
0x00010000
控件會列出卸除式磁碟驅動器。
包含在 Control 資料表[屬性] 資料行的位字中。
FixedVolume
0x00020000
控件會列出固定的內部硬碟。
包含在 Control 資料表[屬性] 資料行的位字中。
RemoteVolume
0x00040000
控制件會列出遠端磁碟區。
包含在 Control 資料表[屬性] 資料行的位字中。
CDROMVolume
0x00080000
控件會列出CD-ROM磁碟區。
包含在 Control 資料表[屬性] 資料行的位字中。
RAMDiskVolume
0x00100000
控制件會列出 RAM 磁碟。
包含在 Control 資料表[屬性] 資料行的位字中。
FloppyVolume
0x00200000
控制件會列出磁碟驅動器。
包含在 Control 資料表[屬性] 資料行的位字中。
ControlShowRollbackCost
0x00000000
0x00400000
如果 PROMPTROLLBACKCOST = P,而且未設定此屬性,則復原、備份檔不會包含在 VolumeCostList 控件所顯示的成本中。
如果 PROMPTROLLBACKCOST = P,而且已設定此屬性,則 RollCostList 控件所顯示的成本中會包含復原、備份檔案。
如果 PROMPTROLLBACKCOST = D 或 F,則會忽略此控件屬性。如果 PROMPTROLLBACKCOST = F,則會包含復原成本、備份檔。 如果 PROMPTROLLBACKCOST = D,或 DISABLEROLLBACK = 1,則不會包含復原、備份檔案的成本。

 

備註

您可以使用 CreateWindowEx 函式,從 WC_LISTVIEW 類別建立此控件。 它具有LVS_REPORTWS_VSCROLLWS_HSCROLL、LVS_SHAREIMAGELISTS、LVS_AUTOARRANGE、LVS_SINGLESELWS_BORDER、WS_CHILD、WS_TABSTOPWS_GROUP樣式。