編輯控制項類型
本主題提供 編輯 控件類型Microsoft使用者介面自動化支持的相關信息。
編輯控制項可讓使用者檢視和編輯一行簡單的文字，而不支援豐富的格式設定。
下列各節會定義編輯控件類型所需的UI自動化樹狀結構、屬性、控件模式和事件。 使用者介面自動化需求適用於所有編輯控件，其中UI架構/平臺會整合控件類型和控制型模式的UI自動化支援。
本主題包含下列各節。
一般樹狀結構
下表描述與編輯控件相關的UI自動化樹狀結構一般控件和內容檢視，並描述每個檢視中可包含的內容。 如需 UI 自動化樹狀結構的詳細資訊，請參閱 UI 自動化樹狀結構概觀。
| 控件檢視 | 內容檢視 |
|---|---|
|
|
實作 編輯 控件類型的控件，在UI自動化樹狀結構的控件檢視中一律會有零滾動條，因為它是單行控件。 單行文字可能會在某些版面配置案例中換行。 編輯 控件類型僅適用於少量文字。
相關屬性
下表列出UI自動化屬性，其值或定義與編輯控件特別相關。 如需 UI 自動化屬性的詳細資訊，請參閱 從 UI 自動化元素擷取屬性。
| UI 自動化屬性 | 價值 | 筆記 |
|---|---|---|
| UIA_AutomationIdPropertyId | 請參閱附注。 | 在UI自動化樹狀結構的原始檢視中，此屬性的值在所有對等專案之間必須是唯一的。 |
| UIA_BoundingRectanglePropertyId | 請參閱附注。 | 包含整個控件的最外框。 |
| UIA_ClickablePointPropertyId | 請參閱附注。 | 編輯控制項必須具有可點選的點，當使用者按兩下滑鼠時，將輸入焦點提供給控件的編輯部分。 |
| UIA_ControlTypePropertyId | 編輯 | |
| UIA_IsContentElementPropertyId | TRUE | 編輯控制項一律包含在使用者介面自動化樹狀結構的內容檢視中。 |
| UIA_IsControlElementPropertyId | TRUE | 編輯控件一律包含在UI自動化樹狀結構的控件檢視中。 |
| UIA_IsKeyboardFocusablePropertyId | 請參閱附注。 | 如果控件可以接收鍵盤焦點，它必須支援這個屬性。 |
| UIA_IsPasswordPropertyId | 請參閱附注。 | 必須設定為在包含密碼的編輯控件上 TRUE。 如果編輯控制項包含密碼內容，螢幕助讀程式可以使用此屬性來判斷是否應該在使用者輸入按鍵時讀出按鍵。 |
| UIA_LabeledByPropertyId | 請參閱附注。 | 如果有與控件相關聯的靜態文字標籤，這個屬性必須公開該控件的參考。 如果文字控件是另一個控件的子元件，它就不會設定 LabeledBy 屬性集。 |
| UIA_LocalizedControlTypePropertyId | 請參閱附注。 | 對應至 編輯 控制項類型的當地語系化字串。 en-US 或英文 （美國） 的預設值為 “edit”。 |
| UIA_NamePropertyId | 請參閱附注。 | 編輯控制元件的名稱通常是從靜態文字捲標產生。 如果沒有靜態文字標籤，應用程式開發人員必須指派 Name 的屬性值。 Name 屬性絕對不能包含編輯控件的文字內容。 |
必要的控制件模式
下表列出編輯控制項需要支援的UI自動化控制件模式。 如需控制樣式的詳細資訊，請參閱 UI 自動化控制樣式概觀。
| 控制件模式/模式屬性 | 支援/值 | 筆記 |
|---|---|---|
| IRangeValueProvider | 取決於 | 採用數值範圍的所有編輯控件都必須公開 RangeValue 控件模式。 |
| 最低 | 請參閱附注。 | 這個屬性必須是可以設定編輯控件內容的最小值。 |
| 最大 | 請參閱附注。 | 這個屬性必須是可以設定編輯控件內容的最大值。 |
| SmallChange | 請參閱附注。 | 這個屬性必須指出值可以設定為的小數位數。 如果編輯控件只接受整數，SmallChange 屬性值必須是 1。 如果編輯控件接受的範圍從 1.0 到 2.0，則 smallChange 屬性值必須是 0.1。 如果編輯控件接受的範圍從 1.00 到 2.00，則 SmallChange 屬性值必須是 0.001。 |
| LargeChange | NULL | 此屬性不需要在編輯控件上公開。 |
| 值 | 請參閱附注。 | 這個屬性表示編輯控件的數值內容。 當使用者介面自動化用戶端在 Minimum 和 Maximum 屬性中指定的範圍內設定更精確的值時，Value 屬性會自動四捨五入至最接近接受的值。 |
| ITextProvider | 必填 | 所有編輯控制項都必須支援 文字 控件模式，因為輔助技術客戶端必須一律提供詳細資訊。 |
| IValueProvider | 取決於 | 接受字串的所有編輯控制項都必須公開 值 控件模式。 |
| IsReadOnly | 請參閱附注。 | 此屬性必須設定為 ，以指出控制項是否可以以程式設計方式設定值，或可由用戶編輯。 |
| 值 | 請參閱附注。 | 這個屬性包含編輯控件的文字內容。 如果 UIA_IsPasswordPropertyId 屬性設定為 true ，則查詢 Value 屬性必須傳回錯誤。 |
必要事件
下表列出編輯控制項所需的UI自動化事件，才能支援。 如需事件的詳細資訊，請參閱 UI 自動化事件概觀。
| UI 自動化事件 | 筆記 |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| UIA_BoundingRectanglePropertyId 屬性變更事件。 | |
| UIA_IsEnabledPropertyId 屬性變更事件。 | 如果控件支援 IsEnabled 屬性，則必須支援這個事件。 |
| UIA_IsOffscreenPropertyId 屬性變更事件。 | 如果控件支援 IsOffscreen 屬性，它就必須支援這個事件。 |
| UIA_NamePropertyId 屬性變更事件。 | |
| UIA_RangeValueValuePropertyId 屬性變更事件。 | 如果控件支援 RangeValue 控件模式，則必須支援此事件。 |
| UIA_ScrollHorizontallyScrollablePropertyId 屬性變更事件。 | 編輯控件絕不支援 卷動 控件模式。 |
| UIA_ScrollHorizontalScrollPercentPropertyId 屬性變更事件。 | 編輯控件絕不支援 卷動 控件模式。 |
| UIA_ScrollHorizontalViewSizePropertyId 屬性變更事件。 | 編輯控件絕不支援 卷動 控件模式。 |
| UIA_ScrollVerticallyScrollablePropertyId 屬性變更事件。 | 編輯控件絕不支援 卷動 控件模式。 |
| UIA_ScrollVerticalScrollPercentPropertyId 屬性變更事件。 | 編輯控件絕不支援 卷動 控件模式。 |
| UIA_ScrollVerticalViewSizePropertyId 屬性變更事件。 | 編輯控件絕不支援 卷動 控件模式。 |
| UIA_StructureChangedEventId | |
| UIA_Text_TextChangedEventId | 如果控件支援 Text 控件模式，則必須支援此事件。 |
| UIA_Text_TextSelectionChangedEventId | 如果控件支援 Text 控件模式，則必須支援此事件。 |
| UIA_ValueValuePropertyId 屬性變更事件 。 | 如果控件支援 Value 控件模式，它必須支援這個事件。 |
言論
編輯控制項可作為不支持選取或編輯文字的唯讀文字欄位。 這類編輯控件的行為會作為具有特定名稱和值的欄位物件。
如果編輯控件包含佔位元文字（例如提示橫幅），除非使用者可以編輯文字，然後重複使用為佔位元文字，否則文字應該作為 HelpText 屬性使用。 例如，開啟新索引標籤時，Windows Internet Explorer 網址列包含 “about：Tabs” 文字。 這不是 HelpText，因為它是使用者可以使用或編輯的程式設計位址。
相關主題