DirectoryList 控件

DirectoryList 控件會顯示 PathEdit 控件中目前顯示之路徑的一部分。 DirectoryList 控件會顯示 DirectoryCombo 控件目前所顯示目錄下方的資料夾。

PathEdit、DirectoryCombo 和 DirectoryList 控件會與相同的字串值屬性相關聯。 該屬性是用戶選取的路徑。 在 Control 資料表的 [屬性] 資料行中輸入屬性的名稱。 這個屬性必須具有包含至少一個磁碟區和一個子層級的初始值。 在 Property 資料表的 Value 資料列中指定 屬性的初始值。

此控件旨在與 PathEdit 和 DirectoryList 控件一起用於瀏覽對話方塊。

DirectoryList 控件會發佈下列 ControlEvents。

ControlEvent	描述
DirectoryListNew	建立新的資料夾，並選取要編輯的名稱欄位。
IgnoreChange	醒目提示但未開啟目前目錄中的資料夾。
DirectoryListUp	選取目前目錄的父代。
DirectoryListOpen	選取並醒目提示目錄。

[控件] 數據表的 [文字] 字段內容永遠不會由 DirectoryList 控件顯示。 相反地，此欄位會指定要由控件顯示的文字樣式，並包含螢幕檢閱公用程式所使用的控件描述。 若要設定文字字串的字型和字型樣式，請在顯示字元的字串前面加上 {\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 資料表的 [屬性] 資料行中。 判斷與這個控件相關聯的屬性是否間接參考。
RTLRO	0x00000000 0x00000020	控件中的文字會以從左至右的閱讀順序顯示。 控件中的文字會以從右至左的閱讀順序顯示。
RightAligned	0x00000000 0x00000040	控件中的文字會對齊左邊。 控件中的文字會對齊右邊。
LeftScroll	0x00000000 0x00000080	滾動條位於控件右側。 滾動條位於控件的左側。
BiDi 控制件	0x000000E0	為 RTLRO、RightAligned 和 LeftScroll 屬性的組合設定此值。

備註

您可以使用 CreateWindowEx 函式，從 WC_LISTVIEW 類別建立此控件。 它具有LVS_LIST、LVS_EDITLABELS、WS_VSCROLL、LVS_SHAREIMAGELISTS、LVS_AUTOARRANGE、LVS_SINGLESEL、WS_BORDER、LVS_SORTASCENDING、WS_CHILD、WS_GROUP和WS_TABSTOP樣式。

此控制項可讓用戶選取目前選取範圍的子資料夾。 有了其他按鈕，使用者也可以選取目前選取範圍中的新資料夾，或在路徑中增加一個層級。 如果使用者在已經存在新資料夾的資料夾中選擇 [ 建立新資料夾 ] 按鈕，則不會建立第二個新資料夾，並選取現有的新資料夾名稱進行編輯。