.gif "注意事項") 注意事項 |
|---|
這份文件適用於想要使用 System.Windows.Automation 命名空間中定義之 Managed UI Automation 類別的 .NET Framework 開發人員。如需 UI Automation 的最新資訊，請參閱 Windows Automation API：使用者介面自動化 (英文)。 |
本主題提供 ComboBox 控制項型別之 UI Automation支援的相關資訊。 在 UI Automation中，控制項型別是一組條件；控制項必須符合這些條件才能使用 ControlTypeProperty 屬性。 這些條件包括 UI Automation樹狀結構、UI Automation屬性值、控制項模式和 UI Automation事件的特定方針。
下拉式方塊是由清單方塊再加上靜態控制項或編輯控制項所組成，此控制項會顯示目前在下拉式方塊的清單方塊部分中所選取的項目。 控制項的清單方塊部分會始終顯示，或者只有在使用者選取控制項旁的下拉箭號 (此為按鈕) 時顯示。 如果選取欄位是編輯控制項，使用者可以輸入清單中沒有的資訊，否則，使用者就只能選取清單中的項目。
下列章節定義 ComboBox 控制項型別的必要 UI Automation樹狀結構、屬性、控制項模式和事件。 UI Automation需求適用於所有的 ComboBox 控制項，不論是 Windows Presentation Foundation (WPF)、Win32 或 Windows Forms。
這個主題包含下列章節。
- 必要的 UI 自動化樹狀結構
- 必要的 UI 自動化屬性
- 必要的 UI 自動化控制項模式
- 必要的事件
- 相關主題
必要的 UI 自動化樹狀結構
下表說明與 ComboBox 控制項相關之 UI Automation樹狀目錄的控制項檢視和內容檢視，並說明每個檢視可以包含的內容。 如需 UI Automation 樹狀結構的詳細資訊，請參閱 UI 自動化樹狀目錄概觀。
控制項檢視 |
內容檢視 |
|---|---|
ComboBox
|
ComboBox
|
只有在下拉式方塊可編輯來接受任何輸入 (如 [執行] 對話方塊中的下拉式方塊) 時，下拉式方塊的控制項檢視中才需要編輯控制項。
必要的 UI 自動化屬性
下表列出的 UI Automation屬性，其值或定義與 ComboBox 控制項特別相關。 如需 UI Automation 屬性的詳細資訊，請參閱 用戶端的 UI 自動化屬性。
UI Automation屬性 |
值 |
備註 |
|---|---|---|
請參閱備註 |
這個屬性的值在應用程式的所有控制項間必須是唯一的值。 |
|
請參閱備註 |
包含整個控制項的最外層矩形。 |
|
請參閱備註 |
如果有週框便可支援。 如果無法點選週框內的每個點，而且您執行的是特殊的點擊測試，則請覆寫並提供可按的點。 |
|
ComboBox |
所有 UI 架構的這個值全都相同。 |
|
請參閱備註 |
下拉式方塊控制項的說明文字應解釋，為什麼會要求使用者從下拉式方塊選擇選項。 此文字與透過工具提示呈現的資訊類似。 例如，「選取項目以設定顯示器的解析度」。 |
|
True |
ComboBox 控制項一律包含在 UI Automation樹狀目錄的內容檢視中。 |
|
True |
ComboBox 控制項一律包含在 UI Automation樹狀目錄的控制項檢視中。 |
|
True |
ComboBox 控制項會從選取容器公開一組項目。 ComboBox 控制項可接收鍵盤焦點，不過當 UI 自動化用戶端將焦點設定在下拉式方塊時，下拉式方塊子樹狀目錄中的任何項目都可能接收焦點。 |
|
請參閱備註 |
ComboBox 控制項通常會有此屬性參考的靜態文字標籤。 |
|
"combo box" |
對應 ComboBox 控制項型別的當地語系化字串。 |
|
請參閱備註 |
ComboBox 控制項通常會從靜態文字控制項取得名稱。 |
必要的 UI 自動化控制項模式
下表列出所有 ComboBox 控制項支援所需的 UI Automation控制項模式。 如需控制項模式的詳細資訊，請參閱 UI 自動化控制項模式概觀。
控制項模式 |
支援 |
備註 |
|---|---|---|
是 |
ComboBox 控制項一定要有下拉按鈕，才能成為下拉式方塊。 |
|
是 |
顯示下拉式方塊中的目前選項。 此支援會移轉給組成下拉式方塊的清單方塊。 |
|
相依項 |
如果下拉式方塊可以接受任意文字值，就必須支援 Value 模式。 此模式可讓您以程式設計方式設定下拉式方塊的字串內容。 如果不支援 Value 模式，這表示使用者必須從下拉式方塊的子樹狀目錄選取清單項目。 |
|
永不 |
下拉式方塊永遠不會直接支援 Scroll 模式。 如果下拉式方塊包含的清單方塊可以捲動，則支援此模式。 這只有在畫面上看得到清單方塊時才支援。 |
必要的事件
下表列出所有 ComboBox 控制項支援所需的 UI Automation事件。 如需事件的詳細資訊，請參閱 UI 自動化事件概觀。
UI Automation事件 |
支援 |
備註 |
|---|---|---|
必要項 |
無 |
|
BoundingRectangleProperty 屬性變更事件。 |
必要項 |
無 |
IsOffscreenProperty 屬性變更事件。 |
必要項 |
無 |
IsEnabledProperty 屬性變更事件。 |
必要項 |
無 |
必要項 |
無 |
|
ExpandCollapseStateProperty 屬性變更事件。 |
必要項 |
無 |
ValueProperty 屬性變更事件。 |
相依項 |
如果控制項支援 Value 模式，它必須支援這個事件 |