Поделиться через

Поддержка Автоматизации Пользовательского Интерфейса для типа элемента управления "Счетчик"

  • Статья
ПримечаниеПримечание

Эта документация предназначена для разработчиков на платформе .NET Framework, которым требуется использовать управляемые классы UI Automation, определенные в пространстве имен System.Windows.Automation.Последние сведения о UI Automation см. на веб-странице Windows Automation API: UI Automation.

Этот раздел содержит сведения о поддержке UI Automation для типа элемента управления "Счетчик". В UI Automation тип элемента управления представляет собой набор условий, которым должен удовлетворять элемент управления, чтобы использовать свойство ControlTypeProperty. К этим условиям относятся конкретные правила для древовидной структуры UI Automation, значений свойств UI Automation и шаблонов элементов управления.

Элементы управления "Счетчик" используются для выбора из домена элементов или диапазона чисел.

В следующих разделах определяется необходимая древовидная структура UI Automation, свойства, шаблоны элементов управления и события для типа элемента управления счетчика. UI Automation требования применяются ко всем элементам управления "Счетчик", независимо от Windows Presentation Foundation (WPF), Win32 или Windows Forms.

В этом разделе содержатся следующие подразделы.

  • Требуемая древовидная структура модели автоматизации пользовательского интерфейса
  • Обязательные свойства модели автоматизации пользовательского интерфейса
  • Обязательные шаблоны и свойства элементов управления модели автоматизации пользовательского интерфейса
  • Обязательные события модели автоматизации пользовательского интерфейса
  • Связанные разделы

Требуемая древовидная структура модели автоматизации пользовательского интерфейса

В следующей таблице приведены представление элемента управления и представление содержимого дерева UI Automation, относящиеся к элементам управления Spinner, когда они поддерживают шаблоны элементов управления Range Value, Value и Selection, а также указано, что может содержаться в каждом представлении. Дополнительные сведения о дереве UI Automation см. в разделе Общие сведения о дереве модели автоматизации пользовательского интерфейса.

Шаблон элемента управления Range Value или Value

Представление элементов управления

Представление содержимого

Циклический счетчик

  • Edit (0 или 1)

  • Кнопка (2)

Циклический счетчик

Шаблон элемента управления Выделение

Представление элементов управления

Представление содержимого

Циклический счетчик

  • Edit (0 или 1)

  • Кнопка (2)

  • Элемент списка (0 или более)

Циклический счетчик

  • ListItem (0 или более)

Чтобы гарантировать, что средства автоматической проверки смогут отличить одну кнопку поддерева представления элемента управления от другой, задайте им SmallIncrement или SmallDecrement AutomationId, в зависимости от того, что требуется. Для некоторых реализаций связанный элемент управления Edit может быть одноранговым элементом элемента управления Spinner.

Обязательные свойства модели автоматизации пользовательского интерфейса

В следующей таблице перечислены свойства UI Automation значение или определение которых относится к элементам управления типа "счетчик". Дополнительные сведения о свойствах UI Automation см. в разделе Свойства автоматизации пользовательского интерфейса для клиентов.

Свойство UI Automation

Значение

Примечания

AutomationIdProperty

См. примечания.

Значение этого свойства должно быть уникальным для каждого элемента управления в приложении.

BoundingRectangleProperty

См. примечания.

Внешний прямоугольник, содержащий весь элемент управления.

ClickablePointProperty

См. примечания.

Точка нажатия элемента управления типа "счетчик" фокусируется на части редактирования элемента управления.

IsKeyboardFocusableProperty

См. примечания.

Если элемент управления может получать фокус ввода с клавиатуры, он должен поддерживать это свойство.

NameProperty

См. примечания.

Элемент управления типа "счетчик" обычно получает свое имя от статической текстовой метки.

LabeledByProperty

См. примечания.

Элементы управления типа "счетчик" имеют статическую текстовую метку.

ControlTypeProperty

Циклический счетчик

Это значение одинаково для всех структур пользовательского интерфейса.

LocalizedControlTypeProperty

"счетчик"

Локализованная строка, соответствующая типу элемента управления "счетчик".

IsContentElementProperty

True

Элемент управления типа "счетчик" всегда должен быть содержимым.

IsControlElementProperty

True

Элемент управления типа "счетчик" всегда должен быть содержимым.

Обязательные шаблоны и свойства элементов управления модели автоматизации пользовательского интерфейса

В следующей таблице перечислены шаблоны управления UI Automation, требуемые для поддержки элементов управления типа "счетчик". Дополнительные сведения о шаблонах элементов управления см. в разделе Общие сведения о шаблонах элементов управления модели автоматизации пользовательского интерфейса.

Шаблон элемента управления/свойство шаблона

Поддержка / значение

Примечания

ISelectionProvider

Зависит от конкретного случая

Элементы управления прокрутки, которые имеют список элементов для выбора, должны поддерживать этот шаблон.

CanSelectMultiple

False

Элементы управления прокрутки всегда содержат единственный выбранный элемент.

IRangeValueProvider

Зависит от конкретного случая

Элементы управления Spinner, которые охватывают числовой диапазон, могут поддерживать этот шаблон.

IValueProvider

Зависит от конкретного случая

Элементы управления Spinner, которые охватывают дискретный набор параметров или чисел, могут поддерживать этот шаблон.

Обязательные события модели автоматизации пользовательского интерфейса

В следующей таблице перечислены события UI Automation, требуемые для поддержки всеми элементами управления типа "счетчик". Дополнительные сведения о событиях см. в разделе Обзор событий автоматизации пользовательского интерфейса.

Событие UI Automation

Поддержка

Примечания

InvalidatedEvent

Зависит от конкретного случая

Нет

Событие, изменяемое свойством BoundingRectangleProperty.

Обязательно

Нет

Событие, изменяемое свойством IsOffscreenProperty.

Требуется

Нет

Событие, изменяемое свойством IsEnabledProperty.

Требуется

Нет

Событие, изменяемое свойством ValueProperty.

Зависит от конкретного случая

Нет

Событие, изменяемое свойством ValueProperty.

Зависит от конкретного случая

Нет

AutomationFocusChangedEvent

Обязательно

Нет

StructureChangedEvent

Обязательно

Нет

См. также

Ссылки

Spinner

Основные понятия

Общие сведения о типах элементов управления автоматизации пользовательского интерфейса

Общие сведения о модели автоматизации пользовательского интерфейса