AccessibilityNode.value · Справочник

Declaration

public string value;

Описание

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

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

Установите это свойство только для узлов, содержимое которых не может быть полностью передано их меткой. Например, метка узла, представляющего ползунок, может быть "Volume", но его значение "50%," указывающее текущий уровень громкости. В этом случае пользователям необходимо знать не только идентификатор ползуна, но и его текущее значение. Напротив, для узла, представляющего кнопку Сохранить, одна метка предоставляет всю необходимую информацию, и установка значения была бы избыточной и запутанной.

Если значение установлено, экранный читатель объявляет его, когда пользователь фокусирует внимание на узле, до или после чтения метки узла (в зависимости от платформы).

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

Примечания::

Он macOS, это свойство имеет нет влияет на узлы со следующими ролями:

На Windows это свойство влияет только на узлы со следующими ролями:

Он Windows, узлы с ролью AccessibilityRole.ScrollView должно иметь значение, содержащее число от 0 до 100, чтобы точно сообщить программе чтения экрана процент прокрутки. Для представлений прокрутки, поддерживающих вертикальную и горизонтальную прокрутку, значение должно содержать два числа, причем процент вертикальной прокрутки должен быть в списке первым. Например, значение 50, 75 указывает, что вид прокрутки, представленный узлом, прокручивается на 50% по вертикали и 75% по горизонтали.