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

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

Разработчик

Ссылочная ссылка доступности углерода платформы ApplicationServices

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

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

Ссылка доступности углерода

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

Кто должен считать этот документ?

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

Организация этого документа

Этот документ содержит ссылку API в следующих разделах:

См. также

Для получения дополнительной информации о доступности в целом и доступе, разрешающем приложения Углерода в частности, необходимо считать следующие документы:

  • Начало работы с доступностью

  • Обзор доступности

  • Инструкции по программированию доступности для углерода

Функции

Разные функции доступности углерода
  • AXUIElementCreateWithHIObjectAndIdentifier AXUIElementCreateWithHIObjectAndIdentifier

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

    Объявление

    Objective C

    AXUIElementRef AXUIElementCreateWithHIObjectAndIdentifier ( HIObjectRef inHIObject, UInt64 inIdentifier );

    Параметры

    inHIObject

    Ссылка на элемент пользовательского интерфейса этот объект доступности представляет. Необходимо передать один из следующих ссылочных типов: WindowRef, ControlRef, MenuRef, или HIObjectRef.

    inIdentifier

    64-разрядный идентификатор для однозначного определения доступности возражает в элементе пользовательского интерфейса. Передача 0 указать базовый объект, идентифицированный inHIObject параметр.

    Возвращаемое значение

    Недавно создаваемый объект доступности.

    Обсуждение

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

    • Сегментированное представление в целом, идентифицированный его ссылкой управления (ControlRef) и значение идентификатора 0.

    • Пять элементов кнопки, идентифицированных сегментированной ссылкой представления и идентификаторами 1 через 5, соответственно.

    Объект доступности является a CFTypeRef объект. Можно использовать CFEqual сравнить два объекта доступности. Необходимо вызвать CFRelease на объекте доступности, когда Вам больше не нужен он.

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

    Objective C

    @import Carbon;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • AXUIElementGetHIObject AXUIElementGetHIObject

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

    Объявление

    Objective C

    HIObjectRef AXUIElementGetHIObject ( AXUIElementRef inUIElement );

    Параметры

    inHIAccObj

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

    Возвращаемое значение

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

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

    Objective C

    @import Carbon;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • AXUIElementGetIdentifier AXUIElementGetIdentifier

    Связали уникальный идентификатор с объектом доступности.

    Объявление

    Objective C

    void AXUIElementGetIdentifier ( AXUIElementRef inUIElement, UInt64 *outIdentifier );

    Параметры

    inHIAccObj

    Объект доступности, идентификатор которого Вы хотите получить.

    outIdentifier

    Указатель на 64-разрядное целое число. По возврату, outIdentifier содержит идентификатор объекта доступности. Если inHIAccObj не допустимый объект доступности, эта функция возвращается 0. Обратите внимание на то, что 0 допустимое значение идентификатора, таким образом, Вы не должны принимать это inHIAccObj если Вы получаете 0 результатов, недопустимо.

    Обсуждение

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

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

    Objective C

    @import Carbon;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • AXNotificationHIObjectNotify AXNotificationHIObjectNotify

    Отправляет уведомление для объекта доступности.

    Объявление

    Objective C

    void AXNotificationHIObjectNotify ( CFStringRef inNotification, HIObjectRef inHIObject, UInt64 inIdentifier );

    Параметры

    inNotification

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

    inHIObject

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

    inIdentifier

    64-разрядная часть идентификатора доступности возражает, для которого применяется это уведомление.

    Обсуждение

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

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

    Objective C

    @import Carbon;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • HIObjectIsAccessibilityIgnored HIObjectIsAccessibilityIgnored

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

    Объявление

    Objective C

    Boolean HIObjectIsAccessibilityIgnored ( HIObjectRef inObject );

    Параметры

    inObject

    Объект, доступность которого проигнорировала состояние, которое Вы хотите запросить.

    Возвращаемое значение

    Булево значение, указывающее, проигнорирован ли HIObject в целях доступности.

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

    Objective C

    @import Carbon;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • HIObjectSetAccessibilityIgnored HIObjectSetAccessibilityIgnored

    Отмечает HIObject, как проигнорировано или не проигнорировано в целях доступности.

    Объявление

    Objective C

    OSStatus HIObjectSetAccessibilityIgnored ( HIObjectRef inObject, Boolean inIgnored );

    Параметры

    inObject

    Объект, доступность которого проигнорировала состояние, которое Вы хотите изменить.

    inIgnored

    Булево значение, указывающее, проигнорировать ли объект (TRUE) или не (FALSE).

    Возвращаемое значение

    OSStatus, показывающий успешность или неуспешность.

    Обсуждение

    Проигнорированный HIObject не показан вспомогательному приложению, использующему доступность APIs для исследования интерфейса приложения. Реализация доступности Вашего приложения должна все еще сообщить о проигнорированном HIObject, как обычно. Реализация доступности Углерода автоматически скрывает проигнорированный HIObjects от вспомогательных приложений.

    Примечание: По умолчанию HIObject не проигнорирован.

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

    Objective C

    @import Carbon;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • HIObjectSetAuxiliaryAccessibilityAttribute HIObjectSetAuxiliaryAccessibilityAttribute

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

    Объявление

    Objective C

    OSStatus HIObjectSetAuxiliaryAccessibilityAttribute ( HIObjectRef inHIObject, UInt64 inIdentifier, CFStringRef inAttributeName, CFTypeRef inAttributeData );

    Параметры

    inHIObject

    HIObjectRef часть пары идентификатора объекта, с которой связаны данные атрибута.

    inIdentifier

    64-разрядная часть идентификатора пары идентификатора объекта, с которой связаны данные атрибута. Передайте 0 в этом параметре, когда Вы захотите связать данные атрибута к HIObject в целом. Если, например, Вы хотите дать атрибут описания объекту, представляющему кнопку, Вы могли бы сделать это.

    inAttributeName

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

    inAttributeData

    A CFTypeRef содержание данных предоставляется для значения атрибута. Эти данные сохраняются, прежде чем они будут добавлены к вспомогательной области хранения атрибута; можно выпустить эти данные после вызывания этой функции. Если Вы передаете NULL в этом параметре это указывает, что именованный вспомогательный атрибут больше не должен связываться с парой идентификатора объекта, и любые именованные данные атрибута, ранее связанные с парой идентификатора объекта, будут выпущены.

    Возвращаемое значение

    OSStatus заканчивается код. Функциональные возвраты noErr если это смогло связать данные атрибута с HIObject. Если HIObjectRef недопустимо, paramErr возвращается.

    Обсуждение

    Эта функция позволяет Вашему приложению обеспечивать имя и данные для атрибута доступности, который Вы хотите добавить к UIElement, представляющему данную пару HIObject-идентификатора. Обычно, атрибуты доступности только предоставляются динамично через события Carbon, но эта функция позволяет Вам предоставлять их статически.

    Эта функция только позволяет Вам связывать атрибуты, значения которых никогда не изменяются. Если необходимо предоставить атрибут, значения которого определяются динамично или чьи значения устанавливаемы, необходимо установить необходимые обработчики событий доступности Углерода. Посмотрите, что Доступность Программирует Инструкции для Углерода для получения дополнительной информации о том, как это работает.

    Эта функция особенно полезна для предоставления значений kAXDescriptionAttribute, kAXTitleUIElementAttribute, kAXServesAsTitleForUIElementsAttribute, kAXLinkedUIElementsAttribute атрибуты и другие атрибуты, значения которых являются определенными для расположения и использования Вашего приложения.

    Со вспомогательным хранилищем атрибута (содержащий значения атрибута, Вы предоставляете использование этой функции) консультируются во время обработки HIOBJECT по умолчанию событий атрибута доступности Углерода. Поэтому любая программируемая обработка данного атрибута доступности имеет возможность переопределить или блокировать консультацию хранилища. В целом, если панель инструментов или обработчик событий Углерода могут обеспечить значение атрибута некоторый другой путь, с хранилищем не консультируются.

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

    Objective C

    @import Carbon;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • HIObjectOverrideAccessibilityContainment HIObjectOverrideAccessibilityContainment

    Позволяет Вы для переопределения доступности возражаете, что HIObject обычно предоставлял бы как значения kAXParentAttribute, kAXWindowAttribute, и kAXTopLevelUIElementAttribute атрибуты.

    Объявление

    Objective C

    OSStatus HIObjectOverrideAccessibilityContainment ( HIObjectRef inHIObject, AXUIElementRef inDesiredParent, AXUIElementRef inDesiredWindow, AXUIElementRef inDesiredTopLevelUIElement );

    Параметры

    inHIObject

    HIObjectRef чей родительский атрибут Вы хотите переопределить.

    inDesiredParent

    AXUIElementRef то, что Вы хотите, чтобы данный HIObject возвратился как значение kAXParentAttribute атрибут. Эта функция делает копию AXUIElementRef и необходимо выпустить inDesiredParent параметр после того, как Вы вызываете эту функцию. Передача NULL в этом параметре указывает, что Вы не хотите, чтобы HIObject переопределил значение kAXParentAttribute атрибут.

    inDesiredWindow

    AXUIElementRef то, что Вы хотите, чтобы данный HIObject возвратился как значение kAXWindowAttribute атрибут. Эта функция делает копию AXUIElementRef и необходимо выпустить inDesiredWindow параметр после того, как Вы вызываете эту функцию. Передача NULL в этом параметре указывает, что Вы не хотите, чтобы HIObject переопределил значение kAXWindowAttribute атрибут (если значение существует).

    inDesiredTopLevelUIElement

    AXUIElementRef то, что Вы хотите, чтобы данный HIObject возвратился как значение kAXTopLevelUIElementAttribute атрибут. Эта функция делает копию AXUIElementRef и необходимо выпустить inDesiredTopLevelUIElement параметр после того, как Вы вызываете эту функцию. Передача NULL в этом параметре указывает, что Вы не хотите, чтобы HIObject переопределил значение kAXTopLevelUIElementAttribute атрибут (если значение существует).

    Возвращаемое значение

    OSStatus заканчивается код. Если HIObjectRef недопустимо, эта функция возвраты paramErr.

    Обсуждение

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

    . Если ввод как дочерний элемент доступности ее нормального родителя, HIObject является стандартным объектом панели инструментов, таким как HIView или меню, ввод HIObject не будет включен, во все другие случаи это - ответственность клиента гарантировать, что ввод HIObject не включен как дочерний элемент доступности ее нормального родителя.

    Если желаемое AXUIElementRef родитель представляет HIView, меню или окно, ввод, HIObject будет включен автоматически как дочерний элемент доступности указанного родителя. Во всех других случаях это - ответственность клиента вручную включать ввод HIObject как дочерний элемент доступности указанного родителя. Представлять HIView, меню или окно, AXUIElementRef должен содержать надлежащее HIObjectRef, а также значение идентификатора 0.

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

    Не каждый тип HIObject поддерживает переопределение включения; в настоящее время HIViews, меню и окна поддерживают переопределения включения.

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

    Objective C

    @import Carbon;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • HICopyAccessibilityRoleDescription HICopyAccessibilityRoleDescription

    Возвращает определенную с помощью системы ролевую строку описания для стандартной роли или пары ролевой подроли.

    Объявление

    Objective C

    CFStringRef HICopyAccessibilityRoleDescription ( CFStringRef inRole, CFStringRef inSubrole );

    Параметры

    inRole

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

    inSubrole

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

    Возвращаемое значение

    Определенное с помощью системы описание для роли или пары ролевой подроли. Когда Вы закончены с CFString, содержащим описание, необходимо использовать CFRelease выпускать его. Если нет никакого определенного с помощью системы ролевого описания, связанного с ролью или парой ролевой подроли, Вы передаете в, эта функция возвраты NULL. Если Вы передаете в неизвестной роли или неизвестной подроли, эта функция возвраты NULL.

    Обсуждение

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

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

    Objective C

    @import Carbon;

    Доступность

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

    Не доступный 64-разрядным приложениям.

  • HICopyAccessibilityActionDescription HICopyAccessibilityActionDescription

    Возвращает определенную с помощью системы строку описания действия для стандартного действия.

    Объявление

    Objective C

    CFStringRef HICopyAccessibilityActionDescription ( CFStringRef inAction );

    Параметры

    inAction

    Действие, для которого Вы хотите определенное с помощью системы описание. Посмотрите Действия для строк действия, которые можно использовать.

    Возвращаемое значение

    Определенное с помощью системы описание для действия. Когда Вы закончены с CFString, содержащим описание, необходимо использовать CFRelease выпускать его. Если Вы передаете в неподдерживаемом действии, результаты не определены.

    Обсуждение

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

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

    Objective C

    @import Carbon;

    Доступность

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

    Не доступный 64-разрядным приложениям.

Константы

События доступности

  • Константы события доступности

    Определите события доступности (kEventClassAccessibility).

    Объявление

    Swift

    var kEventAccessibleGetChildAtPoint: Int { get } var kEventAccessibleGetFocusedChild: Int { get } var kEventAccessibleGetAllAttributeNames: Int { get } var kEventAccessibleGetAllParameterizedAttributeNames: Int { get } var kEventAccessibleGetNamedAttribute: Int { get } var kEventAccessibleSetNamedAttribute: Int { get } var kEventAccessibleIsNamedAttributeSettable: Int { get } var kEventAccessibleGetAllActionNames: Int { get } var kEventAccessiblePerformNamedAction: Int { get } var kEventAccessibleGetNamedActionDescription: Int { get }

    Objective C

    enum { kEventAccessibleGetChildAtPoint = 1, kEventAccessibleGetFocusedChild = 2, kEventAccessibleGetAllAttributeNames = 21, kEventAccessibleGetAllParameterizedAttributeNames = 25, kEventAccessibleGetNamedAttribute = 22, kEventAccessibleSetNamedAttribute = 23, kEventAccessibleIsNamedAttributeSettable = 24, kEventAccessibleGetAllActionNames = 41, kEventAccessiblePerformNamedAction = 42, kEventAccessibleGetNamedActionDescription = 44 };

    Константы

    • kEventAccessibleGetChildAtPoint

      kEventAccessibleGetChildAtPoint

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

      При обработке этого события Вы используете kEventParamAccessibleChild параметр для возврата доступного дочернего элемента первого порядка объекта доступности получение события. Если нет никакого дочернего элемента в данной точке, Ваш обработчик должен уехать kEventParamAccessibleChild пустой параметр и возврат noErr. Вы не должны устанавливать kEventParamAccessibleChild параметр внуку или большему количеству удаленного потомка доступного объекта, получающего это событие.

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

    • kEventAccessibleGetFocusedChild

      kEventAccessibleGetFocusedChild

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

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

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

    • kEventAccessibleGetAllAttributeNames

      kEventAccessibleGetAllAttributeNames

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

      При обработке этого события Вы создаете объект CFString для имени каждого непараметризованного атрибута и добавляете его к непостоянному массиву в kEventParamAccessibleAttributeNames параметр. Объект доступности, получение поддержек события параметризовало атрибуты, при возврате их в обработчике для kEventAccessibleGetAllParameterizedAttributeNames событие.

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

    • kEventAccessibleGetAllParameterizedAttributeNames

      kEventAccessibleGetAllParameterizedAttributeNames

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

      При обработке этого события Вы создаете объект CFString для имени каждого параметризованного атрибута и добавляете его к непостоянному массиву в kEventParamAccessibleAttributeNames параметр. Вы не должны возвращать регулярные, непараметризованные названия атрибута с этим событием. Вместо этого возвратите регулярные названия атрибута в обработчике для kEventAccessibleGetAllAttributeNames событие.

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

    • kEventAccessibleGetNamedAttribute

      kEventAccessibleGetNamedAttribute

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

      При обработке этого события Вы определяете, назвала ли оказанная поддержка объектов доступности атрибут в kEventParamAccessibleAttributeName параметр. Если это делает, Вы возвращаете значение атрибута в kEventParamAccessibleAttributeValue параметр. Если объект доступности не поддерживает атрибут, возвратитесь eventNotHandledErr ошибка. Тип kEventParamAccessibleAttributeValue параметр меняется в зависимости от типа значения атрибута.

      Это событие может также включать дополнительное kEventParamAccessibleAttributeParameter параметр, описывающий параметры параметризованного атрибута. Обратите внимание на то, что параметризованные атрибуты были представлены в версии 10.3 OS X.

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

    • kEventAccessibleSetNamedAttribute

      kEventAccessibleSetNamedAttribute

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

      При обработке этого события Вы определяете, назвала ли оказанная поддержка объектов доступности атрибут в kEventParamAccessibleAttributeName параметр и если атрибут устанавливаем. Затем Вы устанавливаете значение именованного атрибута в значение, предоставленное в kEventParamAccessibleAttributeValue параметр. Если Вы не можете обработать это событие (потому что, например, объект доступности не поддерживает этот атрибут, атрибут не устанавливаем, или значение не является надлежащим), возвратитесь eventNotHandledErr ошибка.

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

    • kEventAccessibleIsNamedAttributeSettable

      kEventAccessibleIsNamedAttributeSettable

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

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

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

    • kEventAccessibleGetAllActionNames

      kEventAccessibleGetAllActionNames

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

      При обработке этого события Вы создаете объект CFString для имени каждого действия оказанная поддержка объектов доступности и добавляете его к непостоянному массиву в kEventParamAccessibleActionNames параметр.

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

    • kEventAccessiblePerformNamedAction

      kEventAccessiblePerformNamedAction

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

      При обработке этого события Вы определяете, назвала ли поддержка объектов доступности действие в kEventParamAccessibleActionName параметр. Если это делает, Вы выполняете его.

      В версии 10.3 OS X и позже, это событие включает kEventParamAccessibilityEventQueued параметр, указывающий, было ли событие поставлено в очередь. Вы проверяете значение этого параметра перед выполнением действия, которое могло бы привести к вызову к подпрограмме, которая может сразу не возвратиться. Если событие ставится в очередь, можно выполнить такое действие без возможности того, чтобы заставлять вспомогательное приложение получить ошибку из-за тайм-аута, ожидающую действия для завершения. Если событие не ставится в очередь, Ваш обработчик может возвратиться eventDeferAccessibilityEventErr запрашивать что это быть поставленным в очередь и отправленным Вам позже.

      В версиях OS X до 10,3, всегда непосредственно диспетчеризируются события, и необходимо выполнить требуемое действие, даже если он мог бы заставить вспомогательное приложение получать ошибку из-за тайм-аута.

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

    • kEventAccessibleGetNamedActionDescription

      kEventAccessibleGetNamedActionDescription

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

      При обработке этого события Вы определяете если оказанная поддержка объектов доступности данное действие. Если это делает, Вы возвращаете значение свойства описания действия в kEventParamAccessibleActionDescription параметр. Чтобы сделать это, Вы не создаете объект CFString для описания действия. Вместо этого необходимо изменить непостоянный строковый объект в kEventParamAccessibleActionDescription параметр для содержания описания действия.

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

    Обсуждение

    Таблица 1 показывает параметры, связанные с событиями доступности.

    Табличные 1Parameter имена и типы для видов события доступности

    Вид события

    Название параметра

    Тип параметра

    kEventAccessibleGetChildAtPoint

    kEventParamAccessibleObject

    typeCFTypeRef ( AXUIElementRef)

    kEventParamAccessibleMouseLocation

    typeHIPoint

    kEventParamAccessibleChild

    typeCFTypeRef

    kEventAccessibleGetFocusedChild

    kEventParamAccessibleObject

    typeCFTypeRef ( AXUIElementRef)

    kEventParamAccessibleChild

    typeCFTypeRef

    kEventAccessibleGetAllAttributeNames

    kEventParamAccessibleObject

    typeCFTypeRef ( AXUIElementRef)

    kEventParamAccessibleAttributeNames

    typeCFMutableArrayRef

    kEventAccessibleGetAllParameterizedAttributeNames

    kEventParamAccessibleObject

    typeCFTypeRef ( AXUIElementRef)

    kEventParamAccessibleAttributeNames

    typeCFMutableArrayRef

    kEventAccessibleGetNamedAttribute

    kEventParamAccessibleObject

    typeCFTypeRef ( AXUIElementRef)

    kEventParamAccessibleAttributeName

    typeCFStringRef

    kEventParamAccessibleAttributeParameter (Дополнительный; представленный в версии 10.3 OS X)

    typeCFTypeRef

    kEventParamAccessibleAttributeValue

    typeCFTypeRef (Меняется в зависимости от типа значения атрибута),

    kEventAccessibleSetNamedAttribute

    kEventParamAccessibleObject

    typeCFTypeRef ( AXUIElementRef)

    kEventParamAccessibleAttributeName

    typeCFStringRef

    kEventParamAccessibleAttribuuteValue

    typeCFTypeRef (Меняется в зависимости от типа значения атрибута),

    kEventAccessibleIsNamedAttributeSettable

    kEventParamAccessibleObject

    typeCFTypeRef ( AXUIElementRef)

    kEventParamAccessibleAttributeName

    typeCFStringRef

    kEventParamAccessibleAttributeSettable

    typeBoolean

    kEventAccessibleGetAllActionNames

    kEventParamAccessibleObject

    typeCFTypeRef

    kEventParamAccessibleActionNames

    typeCFMutableArrayRef

    kEventAccessiblePerformNamedAction

    kEventParamAccessibleObject

    typeCFTypeRef ( AXUIElementRef)

    kEventParamAccessibleActionName

    typeCFStringRef

    kEventParamAccessibleEventQueued (Только в версии 10.3 OS X и позже)

    typeBoolean

    kEventAccessibleGetNamedActionDescription

    kEventParamAccessibleObject

    typeCFTypeRef ( AXUIElementRef)

    kEventParamAccessibleActionName

    typeCFStringRef

    kEventParamAccessibleActionDescription

    typeCFMutableStringRef

  • Параметры события доступности

    Определите параметры, связанные с событиями доступности.

    Объявление

    Swift

    var kEventParamAccessibleObject: Int { get } var kEventParamAccessibleChild: Int { get } var kEventParamAccessibleAttributeName: Int { get } var kEventParamAccessibleAttributeNames: Int { get } var kEventParamAccessibleAttributeValue: Int { get } var kEventParamAccessibleAttributeSettable: Int { get } var kEventParamAccessibleAttributeParameter: Int { get } var kEventParamAccessibleActionName: Int { get } var kEventParamAccessibleActionNames: Int { get } var kEventParamAccessibleActionDescription: Int { get }

    Objective C

    enum { kEventParamAccessibleObject = ‘aojb’, kEventParamAccessibleChild = ‘achl’, kEventParamAccessibleAttributeName = ‘atnm’, kEventParamAccessibleAttributeNames = ‘atns’, kEventParamAccessibleAttributeValue = ‘atvl’, kEventParamAccessibleAttributeSettable = ‘atst’, kEventParamAccessibleAttributeParameter = ‘atpa’, kEventParamAccessibleActionName = ‘acnm’, kEventParamAccessibleActionNames = ‘acns’, kEventParamAccessibleActionDescription = ‘acds’, kEventParamAccessibleEventQueued = ‘aequ’ };

    Константы

    • kEventParamAccessibleObject

      kEventParamAccessibleObject

      Указывает объект доступности. Тип параметра typeCFTypeRef, и данные должны иметь тип AXUIElementRef.

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

    • kEventParamAccessibleChild

      kEventParamAccessibleChild

      Указывает дочерний объект доступности. Тип параметра typeCFTypeRef, и данные должны иметь тип AXUIElementRef.

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

    • kEventParamAccessibleAttributeName

      kEventParamAccessibleAttributeName

      Указывает название атрибута. Тип параметра typeCFStringRef.

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

    • kEventParamAccessibleAttributeNames

      kEventParamAccessibleAttributeNames

      Указывает массив названий атрибута (каждый тип CFStringRef). Тип параметра typeCFMutableArrayRef.

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

    • kEventParamAccessibleAttributeValue

      kEventParamAccessibleAttributeValue

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

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

    • kEventParamAccessibleAttributeSettable

      kEventParamAccessibleAttributeSettable

      Указывает, устанавливаем ли атрибут. Тип параметра typeBoolean.

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

    • kEventParamAccessibleAttributeParameter

      kEventParamAccessibleAttributeParameter

      Указывает параметры параметризованного атрибута. Тип параметра typeCFTypeRef.

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

    • kEventParamAccessibleActionName

      kEventParamAccessibleActionName

      Указывает имя действия. Тип параметра typeCFStringRef.

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

    • kEventParamAccessibleActionNames

      kEventParamAccessibleActionNames

      Указывает массив имен действия (каждый тип CFStringRef). Тип параметра typeCFMutableArrayRef.

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

    • kEventParamAccessibleActionDescription

      kEventParamAccessibleActionDescription

      Specifes описание действия. Тип параметра typeCFMutableStringRef.

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

    • kEventParamAccessibleEventQueued

      kEventParamAccessibleEventQueued

      Указывает, было ли событие поставлено в очередь. Тип параметра typeBoolean.

  • Класс событий доступности

    Определяет класс событий для событий доступности.

    Объявление

    Swift

    var kEventClassAccessibility: Int { get }

    Objective C

    enum { kEventClassAccessibility = 'acce', };

    Константы

    • kEventClassAccessibility

      kEventClassAccessibility

      Передайте это значение для класса событий при регистрации для событий доступности.

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

Константы объекта доступности

  • Роли

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

    Объявление

    Objective C

    #define kAXApplicationRole CFSTR("AXApplication") #define kAXSystemWideRole CFSTR("AXSystemWide") #define kAXWindowRole CFSTR("AXWindow") #define kAXSheetRole CFSTR("AXSheet") #define kAXDrawerRole CFSTR("AXDrawer") #define kAXGrowAreaRole CFSTR("AXGrowArea") #define kAXImageRole CFSTR("AXImage") #define kAXUnknownRole CFSTR("AXUnknown") #define kAXButtonRole CFSTR("AXButton") #define kAXRadioButtonRole CFSTR("AXRadioButton") #define kAXCheckBoxRole CFSTR("AXCheckBox") #define kAXPopUpButtonRole CFSTR("AXPopUpButton") #define kAXMenuButtonRole CFSTR("AXMenuButton") #define kAXTabGroupRole CFSTR("AXTabGroup") #define kAXTableRole CFSTR("AXTable") #define kAXColumnRole CFSTR("AXColumn") #define kAXRowRole CFSTR("AXRow") #define kAXOutlineRole CFSTR("AXOutline") #define kAXBrowserRole CFSTR("AXBrowser") #define kAXScrollAreaRole CFSTR("AXScrollArea") #define kAXScrollBarRole CFSTR("AXScrollBar") #define kAXRadioGroupRole CFSTR("AXRadioGroup") #define kAXListRole CFSTR("AXList") #define kAXGroupRole CFSTR("AXGroup") #define kAXValueIndicatorRole CFSTR ("AXValueIndicator") #define kAXComboBoxRole CFSTR("AXComboBox") #define kAXSliderRole CFSTR("AXSlider") #define kAXIncrementorRole CFSTR("AXIncrementor") #define kAXBusyIndicatorRole CFSTR ("AXBusyIndicator") #define kAXProgressIndicatorRole CFSTR("AXProgressIndicator") #define kAXRelevanceIndicatorRole CFSTR("AXRelevanceIndicator") #define kAXToolbarRole CFSTR("AXToolbar") #define kAXDisclosureTriangleRole CFSTR("AXDisclosureTriangle") #define kAXTextFieldRole CFSTR("AXTextField") #definekAXTextAreaRole CFSTR("AXTextArea") #define kAXStaticTextRole CFSTR("AXStaticText") #define kAXMenuBarRole CFSTR("AXMenuBar") #define kAXMenuBarItemRole CFSTR("AXMenuBarItem") #define kAXMenuRole CFSTR("AXMenu") #define kAXMenuItemRole CFSTR("AXMenuItem") #define kAXSplitGroupRole CFSTR("AXSplitGroup") #define kAXSplitterRole CFSTR("AXSplitter") #define kAXColorWellRole CFSTR("AXColorWell") #define kAXTimeFieldRole CFSTR("AXTimeField") #define kAXDateFieldRole CFSTR("AXDateField") #define kAXHelpTagRole CFSTR("AXHelpTag") #define kAXMatteRole CFSTR("AXMatteRole") #define kAXDockItemRole CFSTR("AXDockItem")

    Константы

    • kAXApplicationRole

      kAXApplicationRole

      Приложение.

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

    • kAXSystemWideRole

      kAXSystemWideRole

      Объект доступности в масштабе всей системы.

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

    • kAXWindowRole

      kAXWindowRole

      Окно.

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

    • kAXSheetRole

      kAXSheetRole

      Лист.

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

    • kAXDrawerRole

      kAXDrawerRole

      Секция.

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

    • kAXGrowAreaRole

      kAXGrowAreaRole

      Увеличивать управление.

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

    • kAXImageRole

      kAXImageRole

      Изображение.

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

    • kAXUnknownRole

      kAXUnknownRole

      Универсальное ролевое значение для неизвестного объекта доступности.

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

    • kAXButtonRole

      kAXButtonRole

      Кнопка.

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

    • kAXRadioButtonRole

      kAXRadioButtonRole

      Переключатель.

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

    • kAXCheckBoxRole

      kAXCheckBoxRole

      Флажок.

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

    • kAXPopUpButtonRole

      kAXPopUpButtonRole

      Кнопка всплывающего меню.

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

    • kAXMenuButtonRole

      kAXMenuButtonRole

      Кнопка меню.

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

    • kAXTabGroupRole

      kAXTabGroupRole

      Представление вкладки.

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

    • kAXTableRole

      kAXTableRole

      Таблица.

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

    • kAXColumnRole

      kAXColumnRole

      Столбец.

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

    • kAXRowRole

      kAXRowRole

      Строка.

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

    • kAXOutlineRole

      kAXOutlineRole

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

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

    • kAXBrowserRole

      kAXBrowserRole

      Объект доступности, выводящий на экран основанный на столбце, иерархически структурированные данные, такие как представление столбца в окне Finder.

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

    • kAXScrollAreaRole

      kAXScrollAreaRole

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

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

    • kAXScrollBarRole

      kAXScrollBarRole

      Управление полосой прокрутки.

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

    • kAXRadioGroupRole

      kAXRadioGroupRole

      Ряд переключателей.

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

    • kAXListRole

      kAXListRole

      Представление списка.

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

    • kAXGroupRole

      kAXGroupRole

      Групповой блок. Эта роль может также использоваться для группировки других представлений без любой визуальной индикации относительно группировки.

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

    • kAXValueIndicatorRole

      kAXValueIndicatorRole

      Управление, указывающее значение объекта доступности, такого как скроллер управления полосой прокрутки

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

    • kAXComboBoxRole

      kAXComboBoxRole

      Управление полем комбинированного списка.

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

    • kAXSliderRole

      kAXSliderRole

      Управление ползунком.

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

    • kAXIncrementorRole

      kAXIncrementorRole

      Управление степпером (также известный как “небольшие стрелки”).

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

    • kAXBusyIndicatorRole

      kAXBusyIndicatorRole

      Асинхронный индикатор хода выполнения.

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

    • kAXProgressIndicatorRole

      kAXProgressIndicatorRole

      Определенный или неопределенный индикатор хода выполнения.

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

    • kAXRelevanceIndicatorRole

      kAXRelevanceIndicatorRole

      Индикатор уместности.

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

    • kAXToolbarRole

      kAXToolbarRole

      Панель инструментов.

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

    • kAXDisclosureTriangleRole

      kAXDisclosureTriangleRole

      Управление треугольником раскрытия.

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

    • kAXTextFieldRole

      kAXTextFieldRole

      Текстовое поле.

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

    • kAXTextAreaRole

      kAXTextAreaRole

      Доступная для редактирования текстовая область в управлении или окне.

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

    • kAXStaticTextRole

      kAXStaticTextRole

      Строка статического текста вывела на экран в окне, которое не является частью никакого управления.

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

    • kAXMenuBarRole

      kAXMenuBarRole

      Строка меню.

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

    • kAXMenuBarItemRole

      kAXMenuBarItemRole

      Пункт строки меню.

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

    • kAXMenuRole

      kAXMenuRole

      Меню.

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

    • kAXMenuItemRole

      kAXMenuItemRole

      Пункт меню.

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

    • kAXSplitGroupRole

      kAXSplitGroupRole

      Представление разделения.

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

    • kAXSplitterRole

      kAXSplitterRole

      Управление панелью разделителя.

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

    • kAXColorWellRole

      kAXColorWellRole

      Цвет хорошо.

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

    • kAXTimeFieldRole

      kAXTimeFieldRole

      Поле, выводящее на экран время.

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

    • kAXDateFieldRole

      kAXDateFieldRole

      Поле, выводящее на экран даты.

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

    • kAXHelpTagRole

      kAXHelpTagRole

      Тег справки.

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

    • kAXMatteRole

      kAXMatteRole

      Внешнее представление, представляющее все содержание, включая представление через матовую дыру, содержание, скрытое матовым кадром, и изменением размеров и менять местоположение средств управления. Примером объекта с матовой ролью является окно масштабирования значка iChat.

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

    • kAXDockItemRole

      kAXDockItemRole

      Значок, представляющий элемент в Прикреплении.

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

    Обсуждение

    Значение ролевого атрибута описывает, каков объект, не, что это делает. Посмотрите “Роли и Связанные Атрибуты” приложение в Обзоре Доступности, для получения дополнительной информации о котором атрибуты связаны с каждой ролью.

  • Подроли

    Определите значения для подролевого атрибута объекта доступности.

    Объявление

    Objective C

    #define kAXCloseButtonSubrole CFSTR("AXCloseButton") #define kAXMinimizeButtonSubrole CFSTR("AXMinimizeButton") #define kAXZoomButtonSubrole CFSTR("AXZoomButton") #define kAXToolbarButtonSubrole CFSTR("AXToolbarButton") #define kAXSecureTextFieldSubrole CFSTR("AXSecureTextField") #define kAXTableRowSubrole CFSTR("AXTableRow") #define kAXOutlineRowSubrole CFSTR("AXOutlineRow") #define kAXUnknownSubrole CFSTR("AXUnknown") #define kAXStandardWindowSubrole CFSTR("AXStandardWindow") #define kAXDialogSubrole CFSTR("AXDialog") #define kAXSystemDialogSubrole CFSTR("AXSystemDialog") #define kAXFloatingWindowSubrole CFSTR("AXFloatingWindow") #define kAXSystemFloatingWindowSubrole CFSTR("AXSystemFloatingWindow") #define kAXIncrementArrowSubrole CFSTR("AXIncrementArrow") #define kAXDecrementArrowSubrole CFSTR("AXDecrementArrow") #define kAXIncrementPageSubrole CFSTR("AXIncrementPage") #define kAXDecrementPageSubrole CFSTR("AXDecrementPage") #define kAXSortButtonSubrole CFSTR("AXSortButton") #define kAXSearchFieldSubrole CFSTR("AXSearchField") #define kAXApplicationDockItemSubrole CFSTR("AXApplicationDockItem") #define kAXDocumentDockItemSubrole CFSTR("AXDocumentDockItem") #define kAXFolderDockItemSubrole CFSTR("AXFolderDockItem") #define kAXMinimizedWindowDockItemSubrole CFSTR("AXMinimizedWindowDockItem") #define kAXURLDockItemSubrole CFSTR("AXURLDockItem") #define kAXDockExtraDockItemSubrole CFSTR("AXDockExtraDockItem") #define kAXTrashDockItemSubrole CFSTR("AXTrashDockItem") #define kAXProcessSwitcherListSubrole CFSTR("AXProcessSwitcherList")

    Константы

    • kAXCloseButtonSubrole

      kAXCloseButtonSubrole

      Близкая кнопка (т.е. красная кнопка в строке заголовка окна, закрывающей окно).

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

    • kAXMinimizeButtonSubrole

      kAXMinimizeButtonSubrole

      Кнопка свертывания окна (т.е. желтая кнопка в строке заголовка окна, минимизирующей окно в Прикрепление).

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

    • kAXZoomButtonSubrole

      kAXZoomButtonSubrole

      Кнопка изменения масштаба (т.е. зеленая кнопка в строке заголовка окна, корректирующей размер окна).

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

    • kAXToolbarButtonSubrole

      kAXToolbarButtonSubrole

      Кнопка на панели инструментов (т.е. кнопка в строке заголовка окна, скрывающей и показывающей панель инструментов).

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

    • kAXSecureTextFieldSubrole

      kAXSecureTextFieldSubrole

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

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

    • kAXTableRowSubrole

      kAXTableRowSubrole

      Строка в таблице.

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

    • kAXOutlineRowSubrole

      kAXOutlineRowSubrole

      Строка в представлении схемы (см. kAXOutlineRole для описания представления схемы).

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

    • kAXUnknownSubrole

      kAXUnknownSubrole

      Подроль для неизвестного типа окна. Окно должно включать подроль для дальнейшего определения ее типа. Если Ваше окно не соответствует существующей подроли, можно использовать неизвестную подроль. Также можно возвратиться eventNotHandledErr ошибка, когда Ваше окно просят относительно его подроли.

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

    • kAXStandardWindowSubrole

      kAXStandardWindowSubrole

      Стандартное окно, включающее строку заголовка (т.е. не окно инспектора или лист).

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

    • kAXDialogSubrole

      kAXDialogSubrole

      Диалоговое окно, такое как предупреждение.

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

    • kAXSystemDialogSubrole

      kAXSystemDialogSubrole

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

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

    • kAXFloatingWindowSubrole

      kAXFloatingWindowSubrole

      Служебное окно.

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

    • kAXSystemFloatingWindowSubrole

      kAXSystemFloatingWindowSubrole

      Сгенерированное системой служебное окно.

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

    • kAXIncrementArrowSubrole

      kAXIncrementArrowSubrole

      Стрелка вверх полосы прокрутки.

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

    • kAXDecrementArrowSubrole

      kAXDecrementArrowSubrole

      Стрелка вниз полосы прокрутки.

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

    • kAXIncrementPageSubrole

      kAXIncrementPageSubrole

      Инкрементная область в полосе прокрутки полосы прокрутки.

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

    • kAXDecrementPageSubrole

      kAXDecrementPageSubrole

      Декрементная область в полосе прокрутки полосы прокрутки.

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

    • kAXSortButtonSubrole

      kAXSortButtonSubrole

      Кнопка заголовка столбца в списке или представлении столбца.

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

    • kAXSearchFieldSubrole

      kAXSearchFieldSubrole

      Поле поиска.

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

    • kAXApplicationDockItemSubrole

      kAXApplicationDockItemSubrole

      Значок в Прикреплении, представляющем приложение.

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

    • kAXDocumentDockItemSubrole

      kAXDocumentDockItemSubrole

      Значок в Прикреплении, представляющем документ.

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

    • kAXFolderDockItemSubrole

      kAXFolderDockItemSubrole

      Значок в Прикреплении, представляющем папку.

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

    • kAXMinimizedWindowDockItemSubrole

      kAXMinimizedWindowDockItemSubrole

      Значок в Прикреплении, представляющем минимизируемое окно.

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

    • kAXURLDockItemSubrole

      kAXURLDockItemSubrole

      Значок в Прикреплении, представляющем URL.

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

    • kAXDockExtraDockItemSubrole

      kAXDockExtraDockItemSubrole

      Значок в Прикреплении, представляющем Дополнительное Прикрепление.

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

    • kAXTrashDockItemSubrole

      kAXTrashDockItemSubrole

      Значок в Прикреплении, представляющем Мусор.

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

    • kAXProcessSwitcherListSubrole

      kAXProcessSwitcherListSubrole

      Дисплей запущенных приложений (процессы), который появляется, когда пользователь нажимает Command-Tab.

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

    Обсуждение

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

  • Атрибуты

    Определите атрибуты, доступные для объектов доступности.

    Объявление

    Objective C

    //General attributes #define kAXRoleAttribute CFSTR("AXRole") #define kAXSubroleAttribute CFSTR(“AXSubrole”) #define kAXRoleDescriptionAttribute CFSTR("AXRoleDescription") #define kAXHelpAttribute CFSTR("AXHelp") #define kAXTitleAttribute CFSTR("AXTitle") #define kAXValueAttribute CFSTR("AXValue") #define kAXMinValueAttribute CFSTR("AXMinValue") #define kAXMaxValueAttribute CFSTR("AXMaxValue") #define kAXValueIncrementAttribute CFSTR("AXValueIncrement") #define kAXAllowedValuesAttribute CFSTR(“AXAllowedValues”) #define kAXEnabledAttribute CFSTR("AXEnabled") #define kAXFocusedAttribute CFSTR("AXFocused") #define kAXParentAttribute CFSTR("AXParent") #define kAXChildrenAttribute CFSTR("AXChildren") #define kAXSelectedChildrenAttribute CFSTR("AXSelectedChildren") #define kAXVisibleChildrenAttribute CFSTR("AXVisibleChildren") #define kAXWindowAttribute CFSTR("AXWindow") #define kAXTopLevelUIElementAttribute CFSTR(“AXTopLevelUIElement”) #define kAXPositionAttribute CFSTR("AXPosition") #define kAXSizeAttribute CFSTR("AXSize") #define kAXOrientationAttribute CFSTR("AXOrientation") #define kAXDescriptionAttribute CFSTR(“AXDescription”) // Text-specific attributes #define kAXSelectedTextAttribute CFSTR("AXSelectedText") #define kAXVisibleCharacterRangeAttribute CFSTR("AXVisibleCharacterRange") #define kAXSelectedTextRangeAttribute CFSTR("AXSelectedTextRange") #define kAXNumberOfCharactersAttribute CFSTR("AXNumberOfCharacters") #define kAXSharedTextUIElementsAttribute CFSTR("AXSharedTextUIElements") #define kAXSharedCharacterRangeAttribute CFSTR("AXSharedCharacterRange") // Window-specific attributes #define kAXMainAttribute CFSTR("AXMain") #define kAXMinimizedAttribute CFSTR("AXMinimized") #define kAXCloseButtonAttribute CFSTR("AXCloseButton") #define kAXZoomButtonAttribute CFSTR("AXZoomButton") #define kAXMinimizeButtonAttribute CFSTR("AXMinimizeButton") #define kAXToolbarButtonAttribute CFSTR("AXToolbarButton") #define kAXGrowAreaAttribute CFSTR("AXGrowArea") #define kAXProxyAttribute CFSTR("AXProxy") #define kAXModalAttribute CFSTR("AXModal") #define kAXDefaultButtonAttribute CFSTR("AXDefaultButton") #define kAXCancelButtonAttribute CFSTR("AXCancelButton") // Menu-specific attributes #define kAXMenuItemCmdCharAttribute CFSTR("AXMenuItemCmdChar") #define kAXMenuItemCmdVirtualKeyAttribute CFSTR("AXMenuItemCmdVirtualKey") #define kAXMenuItemCmdGlyphAttribute CFSTR("AXMenuItemCmdGlyph") #define kAXMenuItemCmdModifiersAttribute CFSTR("AXMenuItemCmdModifiers") #define kAXMenuItemMarkCharAttribute CFSTR("AXMenuItemMarkChar") #define kAXMenuItemPrimaryUIElementAttribute CFSTR("AXMenuItemPrimaryUIElement") // Application-specific attributes #define kAXMenuBarAttribute CFSTR("AXMenuBar") #define kAXWindowsAttribute CFSTR("AXWindows") #define kAXFrontmostAttribute CFSTR("AXFrontmost") #define kAXHiddenAttribute CFSTR("AXHidden") #define kAXMainWindowAttribute CFSTR("AXMainWindow") #define kAXFocusedWindowAttribute CFSTR("AXFocusedWindow") #define kAXFocusedUIElementAttribute CFSTR("AXFocusedUIElement") // Miscellaneous attributes #define kAXHeaderAttribute CFSTR("AXHeader") #define kAXEditedAttribute CFSTR("AXEdited") #define kAXValueWrapsAttribute CFSTR("AXValueWraps") #define kAXTabsAttribute CFSTR("AXTabs") #define kAXTitleUIElementAttribute CFSTR("AXTitleUIElement") #define kAXHorizontalScrollBarAttribute CFSTR("AXHorizontalScrollBar") #define kAXVerticalScrollBarAttribute CFSTR("AXVerticalScrollBar") #define kAXOverflowButtonAttribute CFSTR("AXOverflowButton") #define kAXFilenameAttribute CFSTR("AXFilename") #define kAXExpandedAttribute CFSTR("AXExpanded") #define kAXSelectedAttribute CFSTR("AXSelected") #define kAXSplittersAttribute CFSTR("AXSplitters") #define kAXNextContentsAttribute CFSTR("AXNextContents") #define kAXDocumentAttribute CFSTR("AXDocument") #define kAXDecrementButtonAttribute CFSTR("AXDecrementButton") #define kAXIncrementButtonAttribute CFSTR("AXIncrementButton") #define kAXPreviousContentsAttribute CFSTR("AXPreviousContents") #define kAXContentsAttribute CFSTR("AXContents") #define kAXIncrementorAttribute CFSTR("AXIncrementor") #define kAXHourFieldAttribute CFSTR("AXHourField") #define kAXMinuteFieldAttribute CFSTR("AXMinuteField") #define kAXSecondFieldAttribute CFSTR("AXSecondField") #define kAXAMPMFieldAttribute CFSTR("AXAMPMField") #define kAXDayFieldAttribute CFSTR("AXDayField") #define kAXMonthFieldAttribute CFSTR("AXMonthField") #define kAXYearFieldAttribute CFSTR("AXYearField") #define kAXColumnTitleAttribute CFSTR("AXColumnTitles") #define kAXURLAttribute CFSTR("AXURL") #define kAXLabelUIElementsAttribute CFSTR("AXLabelUIElements") #define kAXLabelValueAttribute CFSTR("AXLabelValue") #define kAXShownMenuUIElementAttribute CFSTR("AXShownMenuUIElement") #define kAXServesAsTitleForUIElementsAttribute CFSTR("AXServesAsTitleForUIElements") #define kAXLinkedUIElementsAttribute CFSTR("AXLinkedUIElements") // Table and outline view attributes #define kAXRowsAttribute CFSTR("AXRows") #define kAXVisibleRowsAttribute CFSTR("AXVisibleRows") #define kAXSelectedRowsAttribute CFSTR("AXSelectedRows") #define kAXColumnsAttribute CFSTR("AXColumns") #define kAXVisibleColumnsAttribute CFSTR("AXVisibleColumns") #define kAXSelectedColumnsAttribute CFSTR("AXSelectedColumns") #define kAXSortDirectionAttribute CFSTR("AXSortDirection") #define kAXColumnHeaderUIElementsAttribute CFSTR("AXColumnHeaderUIElements") #define kAXIndexAttribute CFSTR("AXIndex") #define kAXDisclosingAttribute CFSTR("AXDisclosing") #define kAXDisclosedRowsAttribute CFSTR("AXDisclosedRows") #define kAXDisclosedByRowAttribute CFSTR("AXDisclosedByRow") // Matte attributes #define kAXMatteHoleAttribute CFSTR("AXMatteHole") #define kAXMatteContentUIElementAttribute CFSTR("AXMatteContentUIElement") // Dock attributes #define kAXIsApplicationRunningAttribute CFSTR("AXIsApplicationRunning") // System-wide attributes #define kAXFocusedApplicationAttribute CFSTR("AXFocusedApplication")

    Константы

    • kAXRoleAttribute

      kAXRoleAttribute

      Роль или тип, этого объекта доступности (например, AXButton). Эта строка в идентификационных целях только и не должна быть локализована. Все объекты доступности должны включать этот атрибут.

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

    • kAXSubroleAttribute

      kAXSubroleAttribute

      Подроль этого объекта доступности (например, AXCloseButton). Подроль предоставляет дополнительную информацию об объекте доступности к вспомогательному приложению. Эта строка в идентификационных целях только и не должна быть локализована. Этот атрибут необходим только для объекта доступности чей AXRole атрибут не соответственно описывает свое значение.

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

    • kAXRoleDescriptionAttribute

      kAXRoleDescriptionAttribute

      Локализованная строка, описывающая роль (например, «кнопка»). Эта строка должна быть читаемой (или speakable к), пользователь. Все объекты доступности должны включать этот атрибут. Для получения определенной с помощью системы ролевой строки описания для данной роли используйте HICopyAccessibilityRoleDescription функция.

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

    • kAXHelpAttribute

      kAXHelpAttribute

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

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

    • kAXTitleAttribute

      kAXTitleAttribute

      Заголовок связался с этим объектом доступности. Заголовок является текстом что отображения объекта как часть его визуального интерфейса, такие как текст «OK» на кнопке OK. Эта строка должна быть локализуемой и человечески-понятной. Этот атрибут требуется для всех объектов доступности, выводящих на экран строку в их визуальных интерфейсах.

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

    • kAXValueAttribute

      kAXValueAttribute

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

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

    • kAXMinValueAttribute

      kAXMinValueAttribute

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

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

    • kAXMaxValueAttribute

      kAXMaxValueAttribute

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

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

    • kAXValueIncrementAttribute

      kAXValueIncrementAttribute

      Сумма, которую значение объекта доступности изменяет как результат единственного действия (например, как далеко скроллер перемещается одним щелчком мышью). Этот атрибут используется только в сочетании с AXValue атрибут.

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

    • kAXAllowedValuesAttribute

      kAXAllowedValuesAttribute

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

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

    • kAXEnabledAttribute

      kAXEnabledAttribute

      Указывает, может ли пользователь взаимодействовать с объектом доступности. Например, AXEnabled атрибут отключенной кнопки false. Этот атрибут требуется для объектов доступности, представляющих представления, меню и пункты меню. Этот атрибут не требуется для объектов доступности, представляющих окна.

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

    • kAXFocusedAttribute

      kAXFocusedAttribute

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

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

    • kAXParentAttribute

      kAXParentAttribute

      Этот родительский объект объекта доступности в иерархии доступности. Этот атрибут требуется для всех объектов доступности кроме объекта доступности прикладного уровня.

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

    • kAXChildrenAttribute

      kAXChildrenAttribute

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

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

    • kAXSelectedChildrenAttribute

      kAXSelectedChildrenAttribute

      Массив выбранных объектов доступности первого порядка содержится этим объектом доступности. Например, выбранные подэлементы представления списка содержатся в AXSelectedChildren массив объекта доступности представления списка. Элементы AXSelectedChildren массив является подмножеством элементов этого объекта доступности AXChildren массив. Этот атрибут требуется для объектов доступности, содержащих выбираемые дочерние объекты.

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

    • kAXVisibleChildrenAttribute

      kAXVisibleChildrenAttribute

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

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

    • kAXWindowAttribute

      kAXWindowAttribute

      Элемент окна, содержащий этот объект доступности. Объект доступности, содержащийся в окне, включает этот атрибут, таким образом, вспомогательное приложение легко может найти окно, не имея необходимость продвигаться через все прошедшие объекты в иерархию доступности. Обратите внимание на то, что значение AXWindow атрибут должен быть объектом доступности, представляющим окно, не лист или секцию. Для подобного атрибута, который менее строг, посмотрите kAXTopLevelUIElementAttribute. AXWindow атрибут требуется для всех элементов доступности, родитель которых или больше удаленного наследователя представляют окно.

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

    • kAXPositionAttribute

      kAXPositionAttribute

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

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

    • kAXTopLevelUIElementAttribute

      kAXTopLevelUIElementAttribute

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

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

    • kAXSizeAttribute

      kAXSizeAttribute

      Измерения по вертикали и измерения по горизонтали этого объекта доступности. Этот атрибут требуется для всех объектов доступности, которые видимы на экране.

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

    • kAXOrientationAttribute

      kAXOrientationAttribute

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

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

    • kAXDescriptionAttribute

      kAXDescriptionAttribute

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

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

    • kAXSelectedTextAttribute

      kAXSelectedTextAttribute

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

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

    • kAXSelectedTextRangeAttribute

      kAXSelectedTextRangeAttribute

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

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

    • kAXVisibleCharacterRangeAttribute

      kAXVisibleCharacterRangeAttribute

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

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

    • kAXNumberOfCharactersAttribute

      kAXNumberOfCharactersAttribute

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

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

    • kAXSharedTextUIElementsAttribute

      kAXSharedTextUIElementsAttribute

      Массив доступности возражает, с которым совместно используется текст этого объекта доступности. В многостолбцовом документе, например, каждый столбец может быть представлен отдельным объектом доступности. Однако текст в документе может вытекать из одного столбца к другому. Вы получаете значение этого атрибута, если необходимо знать, с которой доступностью возражают, что этот объект доступности совместно использует свой текст. Этот атрибут рекомендуется для наборов объектов доступности что текст доли в единственном окне. (См. kAXSharedCharacterRange для связанного атрибута.)

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

    • kAXSharedCharacterRangeAttribute

      kAXSharedCharacterRangeAttribute

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

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

    • kAXMainAttribute

      kAXMainAttribute

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

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

    • kAXMinimizedAttribute

      kAXMinimizedAttribute

      Указывает, минимизируется ли окно, представленное этим объектом доступности в настоящее время, в Прикреплении. Этот атрибут рекомендуется для всех объектов доступности, представляющих окна, которые могут быть минимизированы.

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

    • kAXCloseButtonAttribute

      kAXCloseButtonAttribute

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

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

    • kAXZoomButtonAttribute

      kAXZoomButtonAttribute

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

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

    • kAXMinimizeButtonAttribute

      kAXMinimizeButtonAttribute

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

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

    • kAXToolbarButtonAttribute

      kAXToolbarButtonAttribute

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

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

    • kAXGrowAreaAttribute

      kAXGrowAreaAttribute

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

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

    • kAXProxyAttribute

      kAXProxyAttribute

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

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

    • kAXModalAttribute

      kAXModalAttribute

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

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

    • kAXDefaultButtonAttribute

      kAXDefaultButtonAttribute

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

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

    • kAXCancelButtonAttribute

      kAXCancelButtonAttribute

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

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

    • kAXMenuItemCmdCharAttribute

      kAXMenuItemCmdCharAttribute

      Первичный ключ в сочетании клавиш для команды представлен этим объектом доступности. Например, «O» является первичным ключом в сочетании клавиш для команды Open.

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

    • kAXMenuItemCmdVirtualKeyAttribute

      kAXMenuItemCmdVirtualKeyAttribute

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

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

    • kAXMenuItemCmdGlyphAttribute

      kAXMenuItemCmdGlyphAttribute

      Глиф вывел на экран для физического ключа в сочетании клавиш для команды, представленной этим объектом доступности, если это отличается от видимого результата нажатия клавиши. Клавиша Delete, например, производит невидимый символ, но она связана с видимым глифом.

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

    • kAXMenuItemCmdModifiersAttribute

      kAXMenuItemCmdModifiersAttribute

      Целочисленная маска, представляющая модифицирующие клавиши, удерживаемые в сочетании клавиш для команды, представленной этим объектом доступности.

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

    • kAXMenuItemMarkCharAttribute

      kAXMenuItemMarkCharAttribute

      Символ, выведенный на экран налево от пункта меню, представлен этим объектом доступности. Например, в Меню окна, галочка появляется рядом с именем активного документа. Для получения дополнительной информации о стандартных символах, которые могут казаться следующими за пунктами меню, см. Инструкции по Интерфейсу пользователя Apple.

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

    • kAXMenuItemPrimaryUIElementAttribute

      kAXMenuItemPrimaryUIElementAttribute

      Объект доступности представление элемента основного меню в группе элементов динамического меню. Элемент динамического меню является командами, изменяющимися, когда пользователь нажимает модифицирующую клавишу, те, которые Минимизируют Окно и Минимизируют Весь Windows. В каждой группе каждый объект доступности элемента динамического меню включает этот атрибут, и в каждом случае значение атрибута является объектом доступности представление элемента основного меню.

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

    • kAXMenuBarAttribute

      kAXMenuBarAttribute

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

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

    • kAXWindowsAttribute

      kAXWindowsAttribute

      Массив объектов доступности, представляющих окна этого приложения. Этот атрибут рекомендуется для всех объектов доступности прикладного уровня.

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

    • kAXFrontmostAttribute

      kAXFrontmostAttribute

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

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

    • kAXHiddenAttribute

      kAXHiddenAttribute

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

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

    • kAXMainWindowAttribute

      kAXMainWindowAttribute

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

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

    • kAXFocusedWindowAttribute

      kAXFocusedWindowAttribute

      Объект доступности, представляющий в настоящее время фокусируемое окно этого приложения. Этот атрибут рекомендуется для всех объектов доступности прикладного уровня.

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

    • kAXFocusedUIElemenAttribute

      kAXFocusedUIElemenAttribute

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

    • kAXHeaderAttribute

      kAXHeaderAttribute

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

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

    • kAXEditedAttribute

      kAXEditedAttribute

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

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

    • kAXTitleUIElementAttribute

      kAXTitleUIElementAttribute

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

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

    • kAXValueWrapsAttribute

      kAXValueWrapsAttribute

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

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

    • kAXTabsAttribute

      kAXTabsAttribute

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

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

    • kAXHorizontalScrollBarAttribute

      kAXHorizontalScrollBarAttribute

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

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

    • kAXVerticalScrollBarAttribute

      kAXVerticalScrollBarAttribute

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

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

    • kAXOverflowButtonAttribute

      kAXOverflowButtonAttribute

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

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

    • kAXFilenameAttribute

      kAXFilenameAttribute

      Имя файла связалось с этим объектом доступности. Этот атрибут является дополнительным.

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

    • kAXExpandedAttribute

      kAXExpandedAttribute

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

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

    • kAXSelectedAttribute

      kAXSelectedAttribute

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

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

    • kAXSplittersAttribute

      kAXSplittersAttribute

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

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

    • kAXNextContentsAttribute

      kAXNextContentsAttribute

      Группа объектов доступности, представляющих элементы на одной стороне панели разделителя. (Какую сторону панели разделителя рассматривают, «затем» определяется значением атрибута ориентации панели разделителя.) Этот атрибут рекомендуется для объекта доступности, представляющего панель разделителя в представлении разделения.

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

    • kAXPreviousContentsAttribute

      kAXPreviousContentsAttribute

      Группа объектов доступности, представляющих элементы на одной стороне панели разделителя. (Какую сторону панели разделителя считают «предыдущей», определяется значением атрибута ориентации панели разделителя.) Этот атрибут рекомендуется для объекта доступности, представляющего панель разделителя в представлении разделения.

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

    • kAXDocumentAttribute

      kAXDocumentAttribute

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

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

    • kAXIncrementButtonAttribute

      kAXIncrementButtonAttribute

      Инкрементный элемент, связанный с объектом пользовательского интерфейса этот объект доступности, представляет. Этот атрибут может использоваться для обеспечения удобного доступа к инкрементной области объекта настроенного пользовательского интерфейса. Для обращения к инкрементной кнопке, связанной с датой или полем времени, посмотрите kAXIncrementorAttribute.

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

    • kAXDecrementButtonAttribute

      kAXDecrementButtonAttribute

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

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

    • kAXContentsAttribute

      kAXContentsAttribute

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

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

    • kAXIncrementorAttribute

      kAXIncrementorAttribute

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

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

    • kAXHourFieldAttribute

      kAXHourFieldAttribute

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

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

    • kAXMinuteFieldAttribute

      kAXMinuteFieldAttribute

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

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

    • kAXSecondFieldAttribute

      kAXSecondFieldAttribute

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

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

    • kAXAMPMFieldAttribute

      kAXAMPMFieldAttribute

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

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

    • kAXDayFieldAttribute

      kAXDayFieldAttribute

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

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

    • kAXMonthFieldAttribute

      kAXMonthFieldAttribute

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

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

    • kAXYearFieldAttribute

      kAXYearFieldAttribute

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

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

    • kAXColumnTitleAttribute

      kAXColumnTitleAttribute

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

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

    • kAXURLAttribute

      kAXURLAttribute

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

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

    • kAXLabelUIElementsAttribute

      kAXLabelUIElementsAttribute

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

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

    • kAXLabelValueAttribute

      kAXLabelValueAttribute

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

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

    • kAXShownMenuUIElementAttribute

      kAXShownMenuUIElementAttribute

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

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

    • kAXServesAsTitleForUIElementsAttribute

      kAXServesAsTitleForUIElementsAttribute

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

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

    • kAXLinkedUIElementsAttribute

      kAXLinkedUIElementsAttribute

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

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

    • kAXRowsAttribute

      kAXRowsAttribute

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

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

    • kAXVisibleRowsAttribute

      kAXVisibleRowsAttribute

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

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

    • kAXSelectedRowsAttribute

      kAXSelectedRowsAttribute

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

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

    • kAXColumnsAttribute

      kAXColumnsAttribute

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

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

    • kAXVisibleColumnsAttribute

      kAXVisibleColumnsAttribute

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

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

    • kAXSelectedColumnsAttribute

      kAXSelectedColumnsAttribute

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

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

    • kAXSortDirectionAttribute

      kAXSortDirectionAttribute

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

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

    • kAXColumnHeaderUIElementsAttribute

      kAXColumnHeaderUIElementsAttribute

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

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

    • kAXIndexAttribute

      kAXIndexAttribute

      Индекс строки или столбца представлен этим объектом доступности.

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

    • kAXDisclosingAttribute

      kAXDisclosingAttribute

      Указывает, имеет ли строка в представлении схемы, представленном этим объектом доступности, открытый или закрытый треугольник раскрытия. true указывает открытый треугольник раскрытия; false указывает закрытый треугольник раскрытия.

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

    • kAXDisclosedRowsAttribute

      kAXDisclosedRowsAttribute

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

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

    • kAXDisclosedByRowAttribute

      kAXDisclosedByRowAttribute

      Объект доступности представление строки раскрытия.

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

    • kAXMatteHoleAttribute

      kAXMatteHoleAttribute

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

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

    • kAXMatteContentUIElementAttribute

      kAXMatteContentUIElementAttribute

      Объект доступности отсекается матовым стеклом.

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

    • kAXIsApplicationRunningAttribute

      kAXIsApplicationRunningAttribute

      Указывает, работает ли в настоящее время приложение, представленное Значком панелей, который представляет этот объект доступности.

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

    • kAXFocusedApplicationAttribute

      kAXFocusedApplicationAttribute

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

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

    • kAXInsertionPointLineNumberAttribute

      kAXInsertionPointLineNumberAttribute

      Номер строки точки вставки в тексте связался с этим объектом доступности.

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

    Обсуждение

    Посмотрите “Роли и Связанные Атрибуты” приложение в Обзоре Доступности, для получения дополнительной информации о котором атрибуты связаны с определенной ролью.

  • Параметризованные атрибуты

    Определите параметризованные атрибуты, которые может иметь объект доступности.

    Объявление

    Objective C

    // Text-suite parameterized attributes #define kAXLineForIndexParameterizedAttribute CFSTR("AXLineForIndex") #define kAXRangeForLineParameterizedAttribute CFSTR("AXRangeForLine") #define kAXStringForRangeParameterizedAttribute CFSTR("AXStringForRange") #define kAXRangeForPositionParameterizedAttribute CFSTR("AXRangeForPosition") #define kAXRangeForIndexParameterizedAttribute CFSTR("AXRangeForIndex") #define kAXBoundsForRangeParameterizedAttribute CFSTR("AXBoundsForRange") #define kAXRTFForRangeParameterizedAttribute CFSTR("AXRTFForRange") #define kAXAttributedStringForRangeParameterizedAttribute CFSTR("AXAttributedStringForRange") #define kAXStyleRangeForIndexParameterizedAttribute CFSTR("AXStyleRangeForIndex") #define kAXInsertionPointLineNumberAttribute CFSTR("AXInsertionPointLineNumber")

    Константы

    • kAXLineForIndexParameterizedAttribute

      kAXLineForIndexParameterizedAttribute

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

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

    • kAXRangeForLineParameterizedAttribute

      kAXRangeForLineParameterizedAttribute

      Учитывая номер строки, диапазон символов текста связался с этим объектом доступности, содержащим номер строки.

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

    • kAXStringForRangeParameterizedAttribute

      kAXStringForRangeParameterizedAttribute

      Подстрока текста связалась с этим объектом доступности, указанным данным диапазоном символов.

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

    • kAXRangeForPositionParameterizedAttribute

      kAXRangeForPositionParameterizedAttribute

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

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

    • kAXRangeForIndexParameterizedAttribute

      kAXRangeForIndexParameterizedAttribute

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

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

    • kAXBoundsForRangeParameterizedAttribute

      kAXBoundsForRangeParameterizedAttribute

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

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

    • kAXRTFForRangeParameterizedAttribute

      kAXRTFForRangeParameterizedAttribute

      Представление RTF текста связалось с этим объектом доступности, указанным данным диапазоном.

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

    • kAXAttributedStringForRangeParameterizedAttribute

      kAXAttributedStringForRangeParameterizedAttribute

      Представление CFAttributedStringType текста связалось с этим объектом доступности, указанным данным диапазоном.

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

    • kAXStyleRangeForIndexParameterizedAttribute

      kAXStyleRangeForIndexParameterizedAttribute

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

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

    Обсуждение

    Параметризованные атрибуты позволяют Вам передавать в дополнительных стоимостях для получения более определенной информации о тексте, связанном с объектом доступности.

    Доступность

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

  • Действия

    Определите действия, которые может выполнить объект доступности.

    Объявление

    Objective C

    // Accessibility actions. #define kAXPressAction CFSTR(“AXPress”) #define kAXIncrementAction CFSTR(“AXIncrement”) #define kAXDecrementAction CFSTR(“AXDecrement”) #define kAXConfirmAction CFSTR(“AXConfirm”) #define kAXCancelAction CFSTR(“AXCancel”) #define kAXRaiseAction CFSTR(“AXRaise”) #define kAXShowMenuAction CFSTR(“AXShowMenu”)

    Константы

    • kAXPressAction

      kAXPressAction

      Моделирует единственный щелчок, такой как на кнопке.

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

    • kAXIncrementAction

      kAXIncrementAction

      Постепенно увеличивает значение объекта доступности. Сумма, которой постепенно увеличивается значение, определяется значением kAXValueIncrementAttribute атрибут.

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

    • kAXDecrementAction

      kAXDecrementAction

      Постепенно уменьшает значение объекта доступности. Сумма, которой постепенно уменьшается значение, определяется значением kAXValueIncrementAttribute атрибут.

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

    • kAXConfirmAction

      kAXConfirmAction

      Моделирует нажатие клавиши Return.

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

    • kAXCancelAction

      kAXCancelAction

      Моделирует нажатие Кнопки отмены.

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

    • kAXRaiseAction

      kAXRaiseAction

      Заставляет окно становиться как frontmost, как позволяется содержанием обстоятельств приложения. Обратите внимание на то, что плавающие окна приложения (такие как окна инспектора) могли бы остаться выше окна, выполняющего действие повышения.

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

    • kAXShowMenuAction

      kAXShowMenuAction

      Моделирует открытие контекстного меню в элементе, представленном этим объектом доступности. Это действие может также использоваться для моделирования дисплея меню, предварительно связанного с элементом, таким как меню, выводящее на экран, когда пользователь медленно нажимает кнопку «Назад» Safari's.

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

  • Уведомления

    Определите уведомления, которые могут быть широковещательно переданы объектом доступности.

    Объявление

    Objective C

    // Focus notifications #define kAXMainWindowChangedNotification CFSTR("AXMainWindowChanged") #define kAXFocusedWindowChangedNotification CFSTR("AXFocusedWindowChanged") #define kAXFocusedUIElementChangedNotification CFSTR("AXFocusedUIElementChanged") // Application notifications #define kAXApplicationActivatedNotification CFSTR("AXApplicationActivated") #define kAXApplicationDeactivatedNotification CFSTR("AXApplicationDeactivated") #define kAXApplicationHiddenNotification CFSTR("AXApplicationHidden") #define kAXApplicationShownNotification CFSTR("AXApplicationShown") // Window notifications #define kAXWindowCreatedNotification CFSTR("AXWindowCreated") #define kAXWindowMovedNotification CFSTR("AXWindowMoved") #define kAXWindowResizedNotification CFSTR("AXWindowResized") #define kAXWindowMiniaturizedNotification CFSTR("AXWindowMiniaturized") #define kAXWindowDeminiaturizedNotification CFSTR("AXWindowDeminiaturized") // New drawer, sheet, and help tag notifications #define kAXDrawerCreatedNotification CFSTR("AXDrawerCreated") #define kAXSheetCreatedNotification CFSTR("AXSheetCreated") #define kAXHelpTagCreatedNotification CFSTR("AXHelpTagCreated") // Element notifications #define kAXValueChangedNotification CFSTR("AXValueChanged") #define kAXUIElementDestroyedNotification CFSTR("AXUIElementDestroyed") // Menu notifications #define kAXMenuOpenedNotification CFSTR("AXMenuOpened") #define kAXMenuClosedNotification CFSTR("AXMenuClosed") #define kAXMenuItemSelectedNotification CFSTR("AXMenuItemSelected") // Table and outline view notifications #define kAXRowCountChangedNotification CFSTR("AXRowCountChanged") // Miscellaneous notifications #define kAXSelectedChildrenChangedNotification CFSTR("AXSelectedChildrenChanged") #define kAXResizedNotification CFSTR("AXResized") #define kAXMovedNotification CFSTR("AXMoved") #define kAXCreatedNotification CFSTR("AXCreated”)

    Константы

    • kAXMainWindowChangedNotification

      kAXMainWindowChangedNotification

      Главное окно изменилось.

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

    • kAXFocusedWindowChangedNotification

      kAXFocusedWindowChangedNotification

      Фокусируемое окно изменилось.

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

    • kAXFocusedUIElementChangedNotification

      kAXFocusedUIElementChangedNotification

      Фокусируемый объект доступности изменился.

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

    • kAXApplicationActivatedNotification

      kAXApplicationActivatedNotification

      Приложение было активировано (т.е. перенесено на передний план).

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

    • kAXApplicationDeactivatedNotification

      kAXApplicationDeactivatedNotification

      Приложение было деактивировано.

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

    • kAXApplicationHiddenNotification

      kAXApplicationHiddenNotification

      Приложение было скрыто.

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

    • kAXApplicationShownNotification

      kAXApplicationShownNotification

      Приложение было показано (т.е. скрытое приложение теперь видимо).

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

    • kAXWindowCreatedNotification

      kAXWindowCreatedNotification

      Окно создавалось. Углерод автоматически отправляет это уведомление, когда окно создается, пока окно реализовано с помощью механизмов окна Carbon.

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

    • kAXWindowMovedNotification

      kAXWindowMovedNotification

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

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

    • kAXWindowResizedNotification

      kAXWindowResizedNotification

      Окно было изменено (это уведомление отправляется в конце окна - изменяют размеры работы, не во время него).

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

    • kAXWindowMiniaturizedNotification

      kAXWindowMiniaturizedNotification

      Приложение минимизировалось (т.е. перемещенный в Прикрепление).

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

    • kAXWindowDeminiaturizedNotification

      kAXWindowDeminiaturizedNotification

      Окно было перемещено из Прикрепления.

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

    • kAXDrawerCreatedNotification

      kAXDrawerCreatedNotification

      Секция создавалась (т.е. секция теперь расширяется из этого окна).

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

    • kAXSheetCreatedNotification

      kAXSheetCreatedNotification

      Лист создавался (т.е. модальное диалоговое окно теперь расширяется из этого окна).

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

    • kAXHelpTagCreatedNotification

      kAXHelpTagCreatedNotification

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

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

    • kAXValueChangedNotification

      kAXValueChangedNotification

      Значение атрибута значения объекта доступности было изменено.

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

    • kAXUIElementDestroyedNotification

      kAXUIElementDestroyedNotification

      От объекта доступности избавились.

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

    • kAXMenuOpenedNotification

      kAXMenuOpenedNotification

      Меню было открыто.

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

    • kAXMenuClosedNotification

      kAXMenuClosedNotification

      Меню было закрыто.

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

    • kAXMenuItemSelectedNotification

      kAXMenuItemSelectedNotification

      Пункт меню был выбран.

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

    • kAXRowCountChangedNotification

      kAXRowCountChangedNotification

      Число строк в этой таблице было изменено.

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

    • kAXSelectedChildrenChangedNotification

      kAXSelectedChildrenChangedNotification

      Было выбрано различное подмножество этой доступности дочерние элементы объекта.

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

    • kAXResizedNotification

      kAXResizedNotification

      Окно изменило размер.

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

    • kAXMovedNotification

      kAXMovedNotification

      Положение этого объекта доступности сменилось.

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

    • kAXCreatedNotification

      kAXCreatedNotification

      Объект доступности создавался.

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

  • Ориентации и направления вида

    Определите значения для ориентации и атрибутов направления вида некоторых объектов доступности.

    Объявление

    Objective C

    // Orientations #define kAXHorizontalOrientationValue CFSTR("AXHorizontalOrientation") #define kAXVerticalOrientationValue CFSTR("AXVerticalOrientation") #define kAXUnknownOrientationValue CFSTR("AXUnknownOrientation") // Sort directions #define kAXAscendingSortDirectionValue CFSTR("AXAscendingSortDirection") #define kAXDescendingSortDirectionValue CFSTR("AXDescendingSortDirection") #define kAXUnknownSortDirectionValue CFSTR("AXUnknownSortDirection")

    Константы

    • kAXHorizontalOrientationValue

      kAXHorizontalOrientationValue

      Этот объект ориентирован горизонтально.

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

    • kAXVerticalOrientationValue

      kAXVerticalOrientationValue

      Этот объект ориентирован вертикально.

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

    • kAXUnknownOrientationValue

      kAXUnknownOrientationValue

      Ориентация этого объекта неизвестна.

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

    • kAXAscendingSortDirectionValue

      kAXAscendingSortDirectionValue

      Содержание этого объекта сортируется в порядке возрастания.

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

    • AXDescendingSortDirection

      AXDescendingSortDirection

      Содержание этого объекта сортируется в порядке убывания.

    • kAXUnknownSortDirectionValue

      kAXUnknownSortDirectionValue

      Порядок сортировки этого объекта неизвестен.

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

    Обсуждение

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

Коды результата

Коды результата, возвращенные реализацией доступности Углерода, упоминаются ниже. Другие коды результата, определенные в AXError.h полезны только для вспомогательных приложений.

  • kAXErrorIllegalArgument

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

    Значение

    - 25201

    Описание

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

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

  • kAXErrorInvalidUIElement

    Объект доступности, полученный в этом случае, недопустим.

    Значение

    - 25202

    Описание

    Объект доступности, полученный в этом случае, недопустим.

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

  • kAXErrorInvalidUIElementObserver

    Наблюдатель для объекта доступности, полученного в этом случае, недопустим.

    Значение

    - 25203

    Описание

    Наблюдатель для объекта доступности, полученного в этом случае, недопустим.

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

  • kAXErrorCannotComplete

    Фундаментальная ошибка произошла, такие как отказ выделить память во время обработки.

    Значение

    - 25204

    Описание

    Фундаментальная ошибка произошла, такие как отказ выделить память во время обработки.

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

  • kAXErrorAttributeUnsupported

    Атрибут, на который ссылаются, не поддерживается. Также можно возвратиться eventNotHandledErr ошибка.

    Значение

    - 25205

    Описание

    Атрибут, на который ссылаются, не поддерживается. Также можно возвратиться eventNotHandledErr ошибка.

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

  • kAXErrorActionUnsupported

    Действие, на которое ссылаются, не поддерживается. Также можно возвратиться eventNotHandledErr ошибка.

    Значение

    - 25206

    Описание

    Действие, на которое ссылаются, не поддерживается. Также можно возвратиться eventNotHandledErr ошибка.

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

  • kAXErrorAPIDisabled

    Вспомогательные приложения не включены в Установках системы.

    Значение

    - 25211

    Описание

    Вспомогательные приложения не включены в Установках системы.

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

  • kAXErrorParameterizedAttributeUnsupported

    Параметризованный атрибут не поддерживается. Также можно возвратиться eventNotHandledErr ошибка.

    Значение

    - 25213

    Описание

    Параметризованный атрибут не поддерживается. Также можно возвратиться eventNotHandledErr ошибка.

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