Spec-Zone .ru
спецификации, руководства, описания, API

Библиотека разработчика Mac

Разработчик

Ссылка AXAttributeConstants.h

Опции
Развертывание Target:

На этой странице
Язык:

Ссылка AXAttributeConstants.h

Каждый UIElement имеет ряд атрибутов что вспомогательное использование приложений для получения информации о UIElement. Список атрибутов варьируется в зависимости от типа UIElement. В то время как другие не могут, значение некоторых атрибутов может быть изменено. Например, изменение атрибута «значения» ползунка изменяет настройки ползунка.

Значения атрибута сохранены, поскольку Базовая Основа вводит, CFTypeRefs, и считаемый (CFRetain/CFRelease) ссылки. Некоторые атрибуты имеют определенный тип, связанный с ними. Например, атрибут «заголовка», если определено, всегда имеет строковое значение, независимо от типа UIElement, из которого это получено. Атрибут «значения» UIELEMENT, однако, меняется в зависимости от UIElement. Например, значение текстового поля является строкой, тогда как значение флажка является булевской переменной. Вы должны к explictly протестировать возвращенные объекты, с помощью функции CFGetTypeID, поскольку, что вводит, они действительно.

Наконец, некоторые значения атрибута содержат простые структуры, такие как CGPoint и CGRect, вместо регулярного CFTypes. Они все еще передаются между целевым и вспомогательным приложением как CFTypeRefs, но они просто обертывают закодированную версию структуры. Необходимо использовать функции AXValueCreate и AXValueGetValue для преобразования между структурами и CFTypeRefs. Каждой поддерживаемой структуре связали AXValueType с ним. Функция AXValueGetType возвращает AXValueType структуры, содержавшей в CFTypeRef.

Константы

Посмотрите раздел Overview выше для документации уровня заголовка.

  • Объявление

    Objective C

    #define kAXAllowedValuesAttribute CFSTR("AXAllowedValues") #define kAXAMPMFieldAttribute CFSTR("AXAMPMField") #define kAXCancelButtonAttribute CFSTR("AXCancelButton") #define kAXChildrenAttribute CFSTR("AXChildren") #define kAXCloseButtonAttribute CFSTR("AXCloseButton") #define kAXColumnTitleAttribute CFSTR("AXColumnTitles") #define kAXContentsAttribute CFSTR("AXContents") #define kAXDayFieldAttribute CFSTR("AXDayField") #define kAXDefaultButtonAttribute CFSTR("AXDefaultButton") #define kAXDescriptionAttribute CFSTR("AXDescription") #define kAXEnabledAttribute CFSTR("AXEnabled") #define kAXFocusedAttribute CFSTR("AXFocused") #define kAXGrowAreaAttribute CFSTR("AXGrowArea") #define kAXHeaderAttribute CFSTR("AXHeader") #define kAXHelpAttribute CFSTR("AXHelp") #define kAXHourFieldAttribute CFSTR("AXHourField") #define kAXIncrementorAttribute CFSTR("AXIncrementor") #define kAXInsertionPointLineNumberAttribute CFSTR("AXInsertionPointLineNumber") #define kAXMainAttribute CFSTR("AXMain") #define kAXMaxValueAttribute CFSTR("AXMaxValue") #define kAXMinimizeButtonAttribute CFSTR("AXMinimizeButton") #define kAXMinimizedAttribute CFSTR("AXMinimized") #define kAXMinuteFieldAttribute CFSTR("AXMinuteField") #define kAXMinValueAttribute CFSTR("AXMinValue") #define kAXModalAttribute CFSTR("AXModal") #define kAXMonthFieldAttribute CFSTR("AXMonthField") #define kAXNumberOfCharactersAttribute CFSTR("AXNumberOfCharacters") #define kAXOrientationAttribute CFSTR("AXOrientation") #define kAXParentAttribute CFSTR("AXParent") #define kAXPositionAttribute CFSTR("AXPosition") #define kAXProxyAttribute CFSTR("AXProxy") #define kAXRoleAttribute CFSTR("AXRole") #define kAXRoleDescriptionAttribute CFSTR("AXRoleDescription") #define kAXSecondFieldAttribute CFSTR("AXSecondField") #define kAXSelectedChildrenAttribute CFSTR("AXSelectedChildren") #define kAXSelectedTextAttribute CFSTR("AXSelectedText") #define kAXSelectedTextRangeAttribute CFSTR("AXSelectedTextRange") #define kAXSelectedTextRangesAttribute CFSTR("AXSelectedTextRanges") #define kAXSharedCharacterRangeAttribute CFSTR("AXSharedCharacterRange") #define kAXSharedTextUIElementsAttribute CFSTR("AXSharedTextUIElements") #define kAXSizeAttribute CFSTR("AXSize") #define kAXSubroleAttribute CFSTR("AXSubrole") #define kAXTitleAttribute CFSTR("AXTitle") #define kAXToolbarButtonAttribute CFSTR("AXToolbarButton") #define kAXTopLevelUIElementAttribute CFSTR("AXTopLevelUIElement") #define kAXURLAttribute CFSTR("AXURL") #define kAXValueAttribute CFSTR("AXValue") #define kAXValueDescriptionAttribute CFSTR("AXValueDescription") #define kAXValueIncrementAttribute CFSTR("AXValueIncrement") #define kAXVisibleCharacterRangeAttribute CFSTR("AXVisibleCharacterRange") #define kAXVisibleChildrenAttribute CFSTR("AXVisibleChildren") #define kAXVisibleColumnsAttribute CFSTR("AXVisibleColumns") #define kAXWindowAttribute CFSTR("AXWindow") #define kAXYearFieldAttribute CFSTR("AXYearField") #define kAXZoomButtonAttribute CFSTR("AXZoomButton")

    Константы

    • kAXAllowedValuesAttribute

      kAXAllowedValuesAttribute

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

      Значение: CFArrayRef любого типа элемент использует для его kAXValueAttribute.

      Перезаписываемый? Нет.

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

      Доступный в OS X v10.4 и позже.

    • kAXAMPMFieldAttribute

      kAXAMPMFieldAttribute

      Атрибут удобства, приводящий к полю AM/PM полевого элемента времени.

      Значение: AXUIElementRef роли kAXTextFieldRole, который используется для редактирования установки AM/PM в полевом элементе времени.

      Перезаписываемый? Нет.

      Требуемый для полевых элементов времени, который выводит на экран установку AM/PM.

      Доступный в OS X v10.3 и позже.

    • kAXCancelButtonAttribute

      kAXCancelButtonAttribute

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

      Значение: AXUIElementRef элемента кнопки отмены окна.

      Перезаписываемый? Нет.

      Требуемый для всех элементов окна, имеющих кнопку отмены.

      Доступный в OS X v10.3 и позже.

    • kAXChildrenAttribute

      kAXChildrenAttribute

      Указывает sub элементы данного элемента в визуальной иерархии элемента. kAXChildrenAttribute группы вкладки является массивом элементов переключателя вкладки. kAXChildrenAttribute окна является массивом элементов представлений первого порядка в окне. kAXChildrenAttribute меню является массивом элементов пункта меню.

      Данный элемент может только быть в дочернем массиве одного другого элемента. Если элемент находится в дочернем массиве некоторого другого элемента, kAXParentAttribute элемента должен быть другим элементом.

      Значение: CFArrayRef AXUIElementRefs.

      Перезаписываемый? Нет.

      Требуемый для элементов, содержащих sub элементы.

      Доступный в OS X v10.2 и позже.

    • kAXCloseButtonAttribute

      kAXCloseButtonAttribute

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

      Значение: AXUIElementRef близкого элемента кнопки окна.

      Перезаписываемый? Нет.

      Требуемый для всех элементов окна, имеющих близкую кнопку.

      Доступный в OS X v10.2 и позже.

    • kAXColumnTitleAttribute

      kAXColumnTitleAttribute

      Доступный в OS X v10.4 и позже.

    • kAXContentsAttribute

      kAXContentsAttribute

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

      Значение: CFArrayRef AXUIElementRefs.

      Перезаписываемый? Нет.

      Рекомендуемый для элементов, имеющих дочерние элементы, которые реагируют или являются отдельными от других дочерних элементов.

      Доступный в OS X v10.2 и позже.

    • kAXDayFieldAttribute

      kAXDayFieldAttribute

      Атрибут удобства, приводящий к дневному полю элемента поля даты.

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

      Перезаписываемый? Нет.

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

      Доступный в OS X v10.3 и позже.

    • kAXDefaultButtonAttribute

      kAXDefaultButtonAttribute

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

      Значение: AXUIElementRef элемента кнопки окна по умолчанию.

      Перезаписываемый? Нет.

      Требуемый для всех элементов окна, имеющих кнопку по умолчанию.

      Доступный в OS X v10.3 и позже.

    • kAXDescriptionAttribute

      kAXDescriptionAttribute

      Локализованная, человекочитаемая строка, указывающая цель элемента в пути, который является немного более определенным, чем kAXRoleDescriptionAttribute, но который менее многословен, чем kAXHelpAttribute. Как правило, описание должно быть адъективной или короткой фразой, описывающей использование элемента. Например, описание ползунка в панели шрифта могло бы быть «размером шрифта». Строка должна быть всем нижним регистром и не содержать пунктуацию.

      Значение: локализованный, человекочитаемый CFStringRef.

      Перезаписываемый? Нет.

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

      Доступный в OS X v10.4 и позже.

    • kAXEnabledAttribute

      kAXEnabledAttribute

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

      Значение: CFBooleanRef. Истинные средние значения включили, ложные отключенные средние значения.

      Перезаписываемый? Нет.

      Требуемый для всех представлений, меню и пунктов меню. Не требуемый для окон.

      Доступный в OS X v10.2 и позже.

    • kAXFocusedAttribute

      kAXFocusedAttribute

      Указывает, является ли элемент текущим клавиатурным фокусом. Это должно быть перезаписываемо для любого элемента, который может принять клавиатурный фокус, хотя можно только установить значение kAXFocusedAttribute к истине. Вы не можете не фокусировать элемент путем установки значения в ложь. Только один элемент во всей иерархии доступности окна должен быть отмечен, как фокусируется.

      Значение: CFBooleanRef. Истинные средние значения фокусировались, ложные средние значения, не фокусируемые.

      Перезаписываемый? Да, для любого focusable элемента. Нет во всех других случаях.

      Требуемый для любого focusable элемента. Не требуемый для других элементов, хотя это часто предлагается для non-focusable элементов способом только для чтения.

      Доступный в OS X v10.2 и позже.

    • kAXGrowAreaAttribute

      kAXGrowAreaAttribute

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

      Значение: AXUIElementRef окна увеличивает элемент области.

      Перезаписываемый? Нет.

      Требуемый для всех элементов окна, имеющих увеличивать область.

      Доступный в OS X v10.2 и позже.

    • kAXHeaderAttribute

      kAXHeaderAttribute

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

      Значение: AXUIElementRef, роль которого варьируется.

      Перезаписываемый? Нет.

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

      Доступный в OS X v10.2 и позже.

    • kAXHelpAttribute

      kAXHelpAttribute

      Локализованный, человекочитаемый CFStringRef, предлагающий содержание справки для элемента.

      Это часто - та же информация, которая была бы предоставлена в теге справки для элемента.

      Рекомендуемый для любого элемента, имеющего доступные данные справки.

      Доступный в OS X v10.2 и позже.

    • kAXHourFieldAttribute

      kAXHourFieldAttribute

      Атрибут удобства, приводящий к полю часа полевого элемента времени.

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

      Перезаписываемый? Нет.

      Требуемый для полевых элементов времени тот дисплей часы.

      Доступный в OS X v10.3 и позже.

    • kAXIncrementorAttribute

      kAXIncrementorAttribute

      Атрибут удобства, приводящий к инкрементору элемента поля или поля даты времени.

      Значение: AXUIElementRef роли kAXIncrementorRole.

      Перезаписываемый? Нет.

      Требуемый для элементов поля и поля даты времени, выводящих на экран инкрементор.

      Доступный в OS X v10.3 и позже.

    • kAXInsertionPointLineNumberAttribute

      kAXInsertionPointLineNumberAttribute

      Доступный в OS X v10.4 и позже.

    • kAXMainAttribute

      kAXMainAttribute

      Является ли окно основным окном документа приложения. Для активного приложения главное окно является единственным активным окном документа. Для неактивного приложения главное окно является окном единого документа, которое было бы активно, если бы приложение было активно. Основной не обязательно подразумевает, что окно имеет ключевой фокус.

      Значение: CFBooleanRef. Истина означает, что окно является основным. Ложь означает, что это не.

      Перезаписываемый? Да.

      Требуемый для всех элементов окна.

      Доступный в OS X v10.2 и позже.

    • kAXMaxValueAttribute

      kAXMaxValueAttribute

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

      Значение: Тот же тип данных как kAXValueAttribute элемента.

      Перезаписываемый? Нет.

      Требуемый для многих пользователь maniipulatable элементы. Дополнительную информацию см. в kAXValueAttribute.

      Доступный в OS X v10.2 и позже.

    • kAXMinimizeButtonAttribute

      kAXMinimizeButtonAttribute

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

      Значение: AXUIElementRef элемента кнопки свертывания окна окна.

      Перезаписываемый? Нет.

      Требуемый для всех элементов окна, имеющих кнопку свертывания окна.

      Доступный в OS X v10.2 и позже.

    • kAXMinimizedAttribute

      kAXMinimizedAttribute

      Минимизируется ли окно в настоящее время к прикреплению. Значение: CFBooleanRef. Минимизированы истинные средние значения. Перезаписываемый? Да. Требуемый для всех элементов окна, которые могут быть минимизированы.

      Доступный в OS X v10.2 и позже.

    • kAXMinuteFieldAttribute

      kAXMinuteFieldAttribute

      Атрибут удобства, приводящий к мелкому полю полевого элемента времени.

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

      Перезаписываемый? Нет.

      Требуемый для полевых элементов времени тот дисплей минуты.

      Доступный в OS X v10.3 и позже.

    • kAXMinValueAttribute

      kAXMinValueAttribute

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

      Значение: Тот же тип данных как kAXValueAttribute элемента.

      Перезаписываемый? Нет.

      Требуемый для многих пользователь maniipulatable элементы. Дополнительную информацию см. в kAXValueAttribute.

      Доступный в OS X v10.2 и позже.

    • kAXModalAttribute

      kAXModalAttribute

      Модально ли окно. Значение: CFBooleanRef. Истина означает, что окно модально. Перезаписываемый? Нет. Требуемый для всех элементов окна.

      Доступный в OS X v10.3 и позже.

    • kAXMonthFieldAttribute

      kAXMonthFieldAttribute

      Атрибут удобства, приводящий к полю месяца элемента поля даты.

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

      Перезаписываемый? Нет.

      Требуемый для элементов поля даты тот дисплей месяцы.

      Доступный в OS X v10.3 и позже.

    • kAXNumberOfCharactersAttribute

      kAXNumberOfCharactersAttribute

      Общее количество символов (не байты) в доступном для редактирования текстовом элементе. Значение: Перезаписываемый CFNumberRef? Нет. Требуемый для доступных для редактирования текстовых элементов.

      Доступный в OS X v10.3 и позже.

    • kAXOrientationAttribute

      kAXOrientationAttribute

      Индикация относительно того, нарисован ли элемент и/или взаимодействовал с вертикальным или горизонтальным способом. Элементы, такие как полосы прокрутки и ползунки предлагают kAXOrientationAttribute.

      Значение: kAXHorizontalOrientationValue, kAXVerticalOrientationValue, или редко kAXUnknownOrientationValue.

      Перезаписываемый? Нет.

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

      Доступный в OS X v10.2 и позже.

    • kAXParentAttribute

      kAXParentAttribute

      Указывает контейнерный элемент элемента в визуальной иерархии элемента. kAXParentElement кнопки мог бы быть элементом окна или группой. kAXParentElement листа будет элементом окна. kAXParentElement окна будет элементом приложения. kAXParentElement пункта меню будет элементом меню.

      Значение: AXUIElementRef.

      Перезаписываемый? Нет.

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

      Доступный в OS X v10.2 и позже.

    • kAXPositionAttribute

      kAXPositionAttribute

      Глобальная экранная позиция верхнего левого угла элемента.

      Значение: AXValueRef с типом kAXValueCGPointType. 0,0 верхний левый угол экрана, выводящего на экран строку меню. Значение горизонтальной оси увеличивается вправо. Значение вертикальной оси увеличивается вниз. Модули являются пикселями.

      Перезаписываемый? Обычно нет. Однако некоторые элементы, которые могут быть перемещены пользователем посредством непосредственного управления (как окна) должны предложить перезаписываемый атрибут позиции.

      Требуемый для всех элементов, которые видимы на экране, который является фактически всеми элементами.

      Доступный в OS X v10.2 и позже.

    • kAXProxyAttribute

      kAXProxyAttribute

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

      Значение: AXUIElementRef документа окна проксирует элемент.

      Перезаписываемый? Нет.

      Требуемый для всех элементов окна, имеющих прокси документа.

      Доступный в OS X v10.2 и позже.

    • kAXRoleAttribute

      kAXRoleAttribute

      Идентифицирует основной тип элемента.

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

      Доступный в OS X v10.2 и позже.

    • kAXRoleDescriptionAttribute

      kAXRoleDescriptionAttribute

      Требуемый для всех элементов. Даже в худшем варианте развития событий, где элемент не может выяснить, каков его основной тип, это может все еще предоставить «неизвестное» значение.

      Локализованная, человекочитаемая строка, которую вспомогательное приложение может представить пользователю как объяснение основного типа или цели элемента. Примерами была бы «кнопка», или «защищают текстовое поле». Язык строки должен соответствовать язык приложения, в котором живет элемент. Строка должна быть всем нижним регистром и не содержать пунктуацию.

      Два элемента с тем же kAXRoleAttribute и kAXSubroleAttribute должны иметь тот же kAXRoleDescriptionAttribute.

      Доступный в OS X v10.2 и позже.

    • kAXSecondFieldAttribute

      kAXSecondFieldAttribute

      Атрибут удобства, приводящий к полю секунд полевого элемента времени.

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

      Перезаписываемый? Нет.

      Требуемый для полевых элементов времени тот дисплей секунды.

      Доступный в OS X v10.3 и позже.

    • kAXSelectedChildrenAttribute

      kAXSelectedChildrenAttribute

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

      Значение: CFArrayRef AXUIElementRefs.

      Перезаписываемый? Только если нет никакого другого способа управлять набором выбранных элементов через атрибуты доступности или действия. Даже если другие пути существуют, этот атрибут может быть перезаписываем как удобство к вспомогательным приложениям и их пользователям. Если kAXSelectedChildrenAttribute перезаписываем, запрос записи со значением пустого массива должен отменить выбор всех выбранных дочерних элементов.

      Требуемый для элементов, содержащих выбираемые sub элементы.

      Доступный в OS X v10.2 и позже.

    • kAXSelectedTextAttribute

      kAXSelectedTextAttribute

      Выбранный текст доступного для редактирования текстового элемента. Значение: CFStringRef с в настоящее время выбираемым текстом элемента. Перезаписываемый? Нет. Требуемый для всех доступных для редактирования текстовых элементов.

      Доступный в OS X v10.2 и позже.

    • kAXSelectedTextRangeAttribute

      kAXSelectedTextRangeAttribute

      Диапазон символов (не байты), который определяет текущий выбор доступного для редактирования текстового элемента.

      Значение: AXValueRef типа kAXValueCFRange.

      Перезаписываемый? Да.

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

      Доступный в OS X v10.2 и позже.

    • kAXSelectedTextRangesAttribute

      kAXSelectedTextRangesAttribute

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

      Значение: CFArrayRef kAXValueCFRanges.

      Перезаписываемый? Да.

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

      Доступный в OS X v10.5 и позже.

    • kAXSharedCharacterRangeAttribute

      kAXSharedCharacterRangeAttribute

      Значение: AXValueRef типа kAXValueCFRangeType Перезаписываемый? Нет. Дополнительный?

      Доступный в OS X v10.4 и позже.

    • kAXSharedTextUIElementsAttribute

      kAXSharedTextUIElementsAttribute

      Значение: CFArrayRef перезаписываемого AXUIElementRefs? Нет. Дополнительный?

      Доступный в OS X v10.4 и позже.

    • kAXSizeAttribute

      kAXSizeAttribute

      Измерения по вертикали и измерения по горизонтали элемента.

      Значение: AXValueRef с типом kAXValueCGSizeType. Модули являются пикселями.

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

      Требуемый для всех элементов, которые видимы на экране, который является фактически всеми элементами.

      Доступный в OS X v10.2 и позже.

    • kAXSubroleAttribute

      kAXSubroleAttribute

      Более в частности идентифицирует тип элемента вне основного типа, предоставленного kAXRoleAttribute.

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

      Элемент в качестве примера, предлагающий kAXSubroleAttribute, является рамкой для закрытия окна. Его значение kAXRoleAttribute является kAXButtonRole, и его kAXSubroleAttribute является kAXCloseButtonSubrole. Это имеет роль kAXButtonRole, потому что это не предлагает дополнительных действий или атрибутов выше и вне того, что обеспечивают другие kAXButtonRole элементы; этому дали подроль, чтобы позволить вспомогательному приложению передавать семантическое различие рамки для закрытия для пользователя.

      Доступный в OS X v10.2 и позже.

    • kAXTitleAttribute

      kAXTitleAttribute

      Локализованная, человекочитаемая строка, выведенная на экран как часть нормального визуального интерфейса элемента. Например, kAXTitleElement кнопки OK является строкой «OK», и kAXTitleElement пункта меню является текстом пункта меню.

      Требуемый, если элемент рисует строку как часть ее нормального визуального интерфейса.

      Доступный в OS X v10.2 и позже.

    • kAXToolbarButtonAttribute

      kAXToolbarButtonAttribute

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

      Значение: AXUIElementRef элемента кнопки на панели инструментов окна.

      Перезаписываемый? Нет.

      Требуемый для всех элементов окна, имеющих кнопку на панели инструментов.

      Доступный в OS X v10.2 и позже.

    • kAXTopLevelUIElementAttribute

      kAXTopLevelUIElementAttribute

      Это очень походит на kAXWindowAttribute, за исключением того, что значение этого атрибута может быть элементом с ролью kAXSheetRole или kAXDrawerRole. Это - короткий путь для того, чтобы пересечь родительскую иерархию элемента до элемента роли kAXWindowRole, kAXSheetRole, или kAXDrawerRole найден.

      Значение: AXUIElementRef роли kAXWindowRole, kAXSheetRole, или kAXDrawerRole.

      Перезаписываемый? Нет.

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

      Доступный в OS X v10.4 и позже.

    • kAXURLAttribute

      kAXURLAttribute

      Значение: CFURLRef. Перезаписываемый? Нет. Требуемый для элементов, представляющих диск или сетевой элемент.

      Доступный в OS X v10.3 и позже.

    • kAXValueAttribute

      kAXValueAttribute

      Всеобъемлющий атрибут, представляющий пользователя модифицируемая установка элемента. Например, содержание доступного для редактирования текстового поля, позиция ползунка полосы прокрутки, и проверяется ли флажок, все передаются kAXValueAttribute их соответствующих элементов.

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

      Доступный в OS X v10.2 и позже.

    • kAXValueDescriptionAttribute

      kAXValueDescriptionAttribute

      Используемый для дополнения kAXValueAttribute. Этот атрибут возвращает строковое описание, лучше всего описывающее текущую стоимость, сохраненную в kAXValueAttribute. Это полезно для вещей как ползунок, куда числовое значение в kAXValueAttribute не всегда передает достаточно информации о корректировке, внесенной на ползунке. Как пример, цветовая шкала, корректирующаяся через различные цвета, не может быть хорошо описана числовым значением в существующем AXValueAttribute. Это - то, где пригождается kAXValueDescriptionAttribute. В этом примере разработчик может предоставить информацию о цвете с помощью этого атрибута.

      Значение: локализованный, человекочитаемый CFStringRef.

      Перезаписываемый? Нет.

      Рекомендуемый для элементов та поддержка kAXValueAttribute.

      Доступный в OS X v10.5 и позже.

    • kAXValueIncrementAttribute

      kAXValueIncrementAttribute

      Только используемый в сочетании с kAXValueAttribute, этот атрибут представляет сумму, которую значение изменит в одном действии с данным элементом. В частности это используется на элементах роли kAXIncrementorRole для давания пользователю общее представление того, сколько ее значение изменит одним щелчком на или стрелка вниз.

      Значение: Тот же тип данных как kAXValueAttribute элемента.

      Перезаписываемый? Нет.

      Рекомендуемый для kAXIncrementorRole и других подобных элементов.

      Доступный в OS X v10.2 и позже.

    • kAXVisibleCharacterRangeAttribute

      kAXVisibleCharacterRangeAttribute

      Диапазон символов (не байты), которые прокручиваются в представление в доступном для редактирования текстовом элементе.

      Значение: AXValueRef типа kAXValueCFRange.

      Перезаписываемый? Нет.

      Требуемый для элементов роли kAXTextAreaRole. Не требуемый для любых других элементов, включая те из роли kAXTextFieldRole.

      Доступный в OS X v10.3 и позже.

    • kAXVisibleChildrenAttribute

      kAXVisibleChildrenAttribute

      Указывает видимые sub элементы данного элемента в визуальной иерархии элемента. Это - подмножество kAXChildrenAttribute элемента, который зрячий пользователь видит на экране. В элементе списка kAXVisibleChildrenAttribute был бы массивом дочерних элементов, в настоящее время прокручивающихся в представление.

      Значение: CFArrayRef AXUIElementRefs.

      Перезаписываемый? Нет.

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

      Доступный в OS X v10.2 и позже.

    • kAXVisibleColumnsAttribute

      kAXVisibleColumnsAttribute

      Указывает подэлементы видимого столбца kAXBrowserRole элемента. Это - подмножество kAXColumnsAttribute браузера, где каждый столбец в массиве является тем, в настоящее время прокручивающимся в представление в браузере. Это не включает столбцов, в настоящее время прокручивающихся из представления.

      Значение: CFArrayRef AXUIElementRefs, представляющего столбцы браузера. Столбцы будут элементами внука браузера и обычно будут роли kAXScrollArea.

      Перезаписываемый? Нет.

      Требуемый для всех элементов браузера.

      Доступный в OS X v10.2 и позже.

    • kAXWindowAttribute

      kAXWindowAttribute

      Короткий путь для того, чтобы пересечь родительскую иерархию элемента до элемента роли kAXWindowRole найден. Обратите внимание на то, что значение для kAXWindowAttribute не должно быть элементом роли kAXSheetRole или kAXDrawerRole; вместо этого, значение должно быть элементом kAXWindowRole, к которому присоединены лист или секция.

      Значение: AXUIElementRef роли kAXWindowRole.

      Перезаписываемый? Нет.

      Требуемый для любого элемента, имеющего элемент роли kAXWindowRole где-нибудь в ее родительской цепочке.

      Доступный в OS X v10.2 и позже.

    • kAXYearFieldAttribute

      kAXYearFieldAttribute

      Атрибут удобства, приводящий к полю года элемента поля даты.

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

      Перезаписываемый? Нет.

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

      Доступный в OS X v10.3 и позже.

    • kAXZoomButtonAttribute

      kAXZoomButtonAttribute

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

      Значение: AXUIElementRef элемента кнопки изменения масштаба окна.

      Перезаписываемый? Нет.

      Требуемый для всех элементов окна, имеющих кнопку изменения масштаба.

      Доступный в OS X v10.2 и позже.

  • Значения, указывающие модификаторы сочетания клавиш для пункта меню (используемый с kAXMenuItemCmdModifiersAttribute атрибут).

    Объявление

    Swift

    typealias AXMenuItemModifiers = UInt32

    Objective C

    enum { kAXMenuItemModifierNone = 0, /* Mask for no modifiers other than the command key (which is used by default ) */ kAXMenuItemModifierShift = ( 1 << 0), /* Mask for shift key modifier */ kAXMenuItemModifierOption = ( 1 << 1), /* Mask for option key modifier */ kAXMenuItemModifierControl = ( 1 << 2), /* Mask for control key modifier */ kAXMenuItemModifierNoCommand = ( 1 << 3) /* Mask for no modifiers at all, not even the command key */ }; typedef UInt32 AXMenuItemModifiers;

    Оператор импорта

    Objective C

    @import ApplicationServices;

    Swift

    import ApplicationServices

    Доступность

    Доступный в OS X v10.9 и позже.