Поддержка Автоматизации Пользовательского Интерфейса для типа элемента управления "Счетчик"
Примечание.
Эта документация предназначена для разработчиков .NET Framework, желающих использовать управляемые классы автоматизации пользовательского интерфейса, определенные в пространстве имен System.Windows.Automation. Последние сведения об автоматизации пользовательского интерфейса см. в статье API автоматизации Windows. Автоматизация пользовательского интерфейса.
В этом разделе содержатся сведения о поддержке модель автоматизации пользовательского интерфейса типа элемента управления Spinner. В модель автоматизации пользовательского интерфейса тип элемента управления — это набор условий, которые элемент управления должен соответствовать для использования ControlTypeProperty свойства. Условия включают конкретные рекомендации по структуре дерева модель автоматизации пользовательского интерфейса, модель автоматизации пользовательского интерфейса значения свойств и шаблоны элементов управления.
Элементы управления "Счетчик" используются для выбора из домена элементов или диапазона чисел.
В следующих разделах определяются необходимые модель автоматизации пользовательского интерфейса структура дерева, свойства, шаблоны элементов управления и события для типа элемента управления Spinner. Требования модель автоматизации пользовательского интерфейса применяются ко всем элементам управления спиннером, будь то Windows Presentation Foundation (WPF), Win32 или Windows Forms.
Требуемая древовидная структура модели автоматизации пользовательского интерфейса
В следующей таблице представлено представление элемента управления и представление содержимого дерева модель автоматизации пользовательского интерфейса, относящегося к элементам управления спиннером, когда они поддерживают шаблоны элементов управления "Значение диапазона", "Значение" и "Выбор" и описывает, что может содержаться в каждом представлении. Дополнительные сведения о дереве модель автоматизации пользовательского интерфейса см. в модель автоматизации пользовательского интерфейса обзоре дерева.
Шаблон элемента управления Range Value или Value
| Представление элемента управления | Представление содержимого |
|---|---|
| Счетчик — Изменить (0 или 1) - Кнопка (2) |
Счетчик |
Selection - шаблон элемента управления
| Представление элемента управления | Представление содержимого |
|---|---|
| Счетчик — Изменить (0 или 1) - Кнопка (2) — элемент списка (0 или более) |
Счетчик — ListItem (0 или более) |
Чтобы убедиться, что две кнопки в поддереве представления элемента управления можно отличить с помощью автоматизированных средств тестирования, назначить SmallIncrement или SmallDecrement AutomationId соответствующим образом. В некоторых реализациях связанный элемент управления "Поле ввода" может быть одноранговым с элементом управления "Счетчик".
Требуемые свойства модели автоматизации пользовательского интерфейса
В следующей таблице перечислены свойства модель автоматизации пользовательского интерфейса, значение или определение которого особенно важно для элементов управления спиннером. Дополнительные сведения о свойствах модель автоматизации пользовательского интерфейса см. в разделе модель автоматизации пользовательского интерфейса Свойства для клиентов.
| Свойство модели автоматизации пользовательского интерфейса | Значение | Примечания. |
|---|---|---|
| AutomationIdProperty | См. примечания. | Значение этого свойства должно быть уникальным среди всех элементов управления в приложении. |
| BoundingRectangleProperty | См. примечания. | Внешний прямоугольник, содержащий весь элемент управления. |
| ClickablePointProperty | См. примечания. | Активная точка управления "Счетчик" перемещает фокус в область редактирования элемента управления. |
| IsKeyboardFocusableProperty | См. примечания. | Если элемент управления может получать фокус клавиатуры, он должен поддерживать это свойство. |
| NameProperty | См. примечания. | Обычно элемент управления "Счетчик" получает имя из статической текстовой метки. |
| LabeledByProperty | См. примечания. | Элементы управления "Счетчик" имеют метку со статическим текстом. |
| ControlTypeProperty | Счетчик | Это значение является одинаковым для всех инфраструктур пользовательского интерфейса. |
| LocalizedControlTypeProperty | "счетчик" | Локализованная строка, соответствующая типу элемента управления Spinner. |
| IsContentElementProperty | Истина | Элемент управления "Счетчик" всегда должен быть содержимым. |
| IsControlElementProperty | Истина | Элемент управления "Счетчик" всегда должен быть элементом управления. |
Необходимые шаблоны и свойства элементов управления модели автоматизации пользовательского интерфейса
В следующей таблице перечислены шаблоны элементов управления модель автоматизации пользовательского интерфейса, которые должны поддерживаться элементами управления spinner. Дополнительные сведения о шаблонах элементов управления см. в разделе UI Automation Control Patterns Overview.
| Шаблон элемента управления/свойство шаблона | Поддержка/значение | Примечания. |
|---|---|---|
| ISelectionProvider | Зависит | Элементы управления "Счетчик", имеющие список выбираемых элементов, должны поддерживать этот шаблон. |
| CanSelectMultiple | False | Элементы управления "Счетчик" всегда являются контейнерами с возможностью выбора одного варианта. |
| IRangeValueProvider | Зависит | Элементы управления "Счетчик", которые охватывают числовой диапазон, могут поддерживать этот шаблон. |
| IValueProvider | Зависит | Элементы управления "Счетчик", которые охватывают дискретный набор параметров или чисел, могут поддерживать этот шаблон. |
Необходимые события модели автоматизации пользовательского интерфейса
В следующей таблице перечислены события модель автоматизации пользовательского интерфейса, необходимые для поддержки всех элементов управления спиннером. Дополнительные сведения о событиях см. в разделе UI Automation Events Overview.
| событие модель автоматизации пользовательского интерфейса | Поддержка | Примечания. |
|---|---|---|
| InvalidatedEvent | Зависит | нет |
| Событие изменения свойстваBoundingRectangleProperty | Обязательное поле | нет |
| Событие изменения свойстваIsOffscreenProperty | Обязательное поле | нет |
| Событие изменения свойстваIsEnabledProperty | Обязательное поле | нет |
| Событие изменения свойстваValueProperty | Зависит | нет |
| Событие изменения свойстваValueProperty | Зависит | нет |
| AutomationFocusChangedEvent | Обязательное поле | нет |
| StructureChangedEvent | Обязательное поле | нет |