PathEdit 控制件
PathEdit 控制件會顯示編輯欄位,讓使用者能夠選取路徑的結尾區段。 此控制檔支援在編輯欄位中輸入選取的資料夾名稱或整個路徑。 使用者也可以輸入沒有驅動器號的磁碟驅動器的通用命名約定 (UNC) 路徑。 如果使用者針對目前磁碟區無效的路徑輸入結束區段,PathEdit 控件就無法將焦點傳送至下一個控件。
PathEdit 控制件、 DirectoryCombo 和 DirectoryList 控件會與相同的字串值屬性相關聯。 該屬性是用戶選取的路徑。 在 Control 資料表的 [屬性] 資料行中輸入屬性的名稱。 這個屬性必須有一個初始值,其中包含至少一個磁碟區和一個子層級。 在 Property 資料表的 Value 資料列中指定 屬性的初始值。
此控件是要與 PathEdit 和 DirectoryList 控件一起用於瀏覽對話方塊。
控件屬性
您可以使用下列屬性搭配此控制件。 若要使用事件變更屬性的值,請將控件訂閱至 EventMapping 數據表中的 ControlEvent,並在 [屬性] 資料行中列出屬性的識別碼。 在 [事件] 數據行中輸入 ControlEvent 的標識碼。
屬性標識碼 | 十六進位位 | 描述 |
---|---|---|
IndirectPropertyName | 這是與控件相關聯的間接屬性名稱。 如果已設定 Indirect 屬性位,控制項會顯示或變更具有這個名稱的屬性值。 如果已設定 Indirect 屬性位,這個名稱也是 Control 資料表的 Property 資料行中列出的屬性值。 | |
位置 | 控件在對話框中的位置。 在控件數據表的 Width、Height、X 和 Y 資料行中,輸入控件左角的寬度、高度和座標。 使用 安裝程式單位 的長度和距離。 |
|
PropertyName | 這是與這個控件相關聯的屬性名稱。 如果未設定 Indirect 屬性位,控制項會顯示或變更具有這個名稱的屬性值。 此屬性是在 Control 資料表的 Property 資料行中指定。 | |
PropertyValue | 這個控件所顯示或變更之屬性的目前值。 如果未設定 Indirect 屬性位,這是 PropertyName 的值。 如果已設定 Indirect 屬性位,這是 IndirectPropertyName 的值。 如果屬性變更,控件會反映新的值。 | |
Text | 若要設定文字字串的字型和字型樣式,請在顯示字元的字串前面加上 {\style} 或 {&style}。 其中 style 是 TextStyle 數據表之 TextStyle 數據行中列出的標識碼。 如果兩者都不存在,但 DefaultUIFont 屬性會定義為有效的文字樣式,則會使用該字型。若要指定使用者可以輸入的字元數,請在任何字型規格後面附加 {n},其中 n 是正整數。 |
|
Visible | 0x00000000 0x00000001 |
隱藏的控件。 可見控制件。 將這個位包含在 Control 資料表中 Attributes 數據行的位字中,讓控件在建立時可見或隱藏。 您也可以使用 ControlCondition 資料表來隱藏或顯示控件。 |
已啟用 | 0x00000000 0x00000002 |
處於停用狀態的控制件。 處於啟用狀態的控制件。 將這個位包含在控件的 [屬性] 數據行的位字中,以在建立時啟用控件。 您也可以使用 ControlCondition 數據表來啟用或停用控件。 |
沉沒 | 0x00000000 0x00000004 |
顯示預設的視覺化樣式。 以沉沒的 3D 外觀顯示控制件。 在 Control 資料表的 [屬性] 資料行中,將這些位包含在位字中。 |
間接 | 0x00000000 0x00000008 |
控制項會在 Control 資料表的 [屬性] 資料行中顯示或變更 屬性的值。 控件會顯示或變更屬性的值,該屬性值已列在 Control 資料表的 [屬性] 資料行中。 判斷與這個控件相關聯的屬性是否間接參考。 |
RTLRO | 0x00000000 0x00000020 |
控件中的文字會以從左至右的閱讀順序顯示。 控件中的文字會以從右至左的閱讀順序顯示。 |
RightAligned | 0x00000000 0x00000040 |
控件中的文字會對齊左邊。 控件中的文字會對齊右邊。 |
備註
PathEdit 控件衍生自 Edit 控制件。
為了與螢幕助讀程式相容,在撰寫具有PathEdit控制項作為第一個使用中控制件的對話框時,您必須將屬於編輯欄位的 文字欄位設為 Dialog 資料表中的第一個使用中控制件。 由於靜態文字無法取得焦點,因此建立對話框時,編輯字段一開始會有焦點;這可確保螢幕助讀程序顯示正確的資訊。