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

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

Разработчик

Ссылочная кварцевая ссылка служб события платформы ApplicationServices

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

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

Кварцевая ссылка служб события

Этот документ описывает API C для касаний события, которые являются фильтрами, используемыми, чтобы наблюдать и изменить поток низкоуровневых событий ввода данных пользователем в OS X. Касания события позволяют контролировать и отфильтровать входные события от нескольких точек в системе до их поставки приоритетному приложению. Дополнение касаний события и расширяет возможности механизма монитора события Carbon, позволяющего приложению наблюдать входные события, поставленные другим процессам (см. функцию GetEventMonitorTarget).

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

Представленный в версии 10.4 OS X, касания события обеспечивают функциональность, подобную функциям Win32 SetWinEventHook когда используется установить рычаг события из контекста, и SendInput. Quartz Event Services также включает более старый набор событийных функций, объявленных в файле CGRemoteOperation.h. Эти функции все еще поддерживаются, но им не рекомендуют для новой разработки.

Функции

Работа с кварцевыми событиями
  • CGEventGetTypeID () CGEventGetTypeID

    Возвращает идентификатор типа для непрозрачного типа CGEventRef.

    Объявление

    Swift

    func CGEventGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CGEventGetTypeID ( void );

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

    Базовый идентификатор типа Основы для непрозрачного типа CGEventRef.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventCreate (_:) CGEventCreate

    Возвращает новое событие Quartz.

    Объявление

    Swift

    func CGEventCreate(_ source: CGEventSource!) -> Unmanaged<CGEvent>!

    Objective C

    CGEventRef CGEventCreate ( CGEventSourceRef source );

    Параметры

    source

    Источник события, или NULL использовать источник по умолчанию.

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

    Новое событие, чтобы быть заполненным в, или NULL если не могло бы быть создано событие. Когда Вам больше не нужно событие, необходимо выпустить его с помощью функции CFRelease.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventCreateData (_: _:) CGEventCreateData

    Возвращает сглаженное представление данных события Quartz.

    Объявление

    Swift

    func CGEventCreateData(_ allocator: CFAllocator!, _ event: CGEvent!) -> Unmanaged<CFData>!

    Objective C

    CFDataRef CGEventCreateData ( CFAllocatorRef allocator, CGEventRef event );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для объекта данных. Использовать текущее средство выделения по умолчанию, передачу NULL или kCFAllocatorDefault.

    event

    Событие для выравнивания.

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

    Сглаженное представление данных события, или NULL если event параметр недопустим. Когда Вам больше не нужен объект данных, необходимо выпустить его с помощью функции CFRelease.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventCreateFromData (_: _:) CGEventCreateFromData

    Возвращает событие Quartz, создаваемое из сглаженного представления данных события.

    Объявление

    Swift

    func CGEventCreateFromData(_ allocator: CFAllocator!, _ eventData: CFData!) -> Unmanaged<CGEvent>!

    Objective C

    CGEventRef CGEventCreateFromData ( CFAllocatorRef allocator, CFDataRef data );

    Параметры

    allocator

    Средство выделения для использования для выделения памяти для объекта-события. Использовать текущее средство выделения по умолчанию, передачу NULL или kCFAllocatorDefault.

    eventData

    Сглаженное представление данных события для восстановления.

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

    Событие, созданное из сглаженного представления данных, или NULL если eventData параметр недопустим.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventCreateMouseEvent (_: _: _: _:) CGEventCreateMouseEvent

    Возвращает новое Кварцевое событие от нажатия мыши.

    Объявление

    Swift

    func CGEventCreateMouseEvent(_ source: CGEventSource!, _ mouseType: CGEventType, _ mouseCursorPosition: CGPoint, _ mouseButton: CGMouseButton) -> Unmanaged<CGEvent>!

    Objective C

    CGEventRef CGEventCreateMouseEvent ( CGEventSourceRef source, CGEventType mouseType, CGPoint mouseCursorPosition, CGMouseButton mouseButton );

    Параметры

    source

    Источник события, взятый от другого события, или NULL.

    mouseType

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

    mouseCursorPosition

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

    mouseButton

    Кнопка это изменяет состояние. Передайте одну из констант, перечисленных в Кнопках мыши. Этот параметр проигнорирован если mouseType параметр kCGEventOtherMouseDown, kCGEventOtherMouseDragged, или kCGEventOtherMouseUp.

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

    Новое событие от нажатия мыши, или NULL если не могло бы быть создано событие. Когда Вам больше не нужно событие, необходимо выпустить его с помощью функции CFRelease.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventCreateKeyboardEvent (_: _: _:) CGEventCreateKeyboardEvent

    Возвращает новое Кварцевое событие клавиатуры.

    Объявление

    Swift

    func CGEventCreateKeyboardEvent(_ source: CGEventSource!, _ virtualKey: CGKeyCode, _ keyDown: Bool) -> Unmanaged<CGEvent>!

    Objective C

    CGEventRef CGEventCreateKeyboardEvent ( CGEventSourceRef source, CGKeyCode virtualKey, bool keyDown );

    Параметры

    source

    Источник события, взятый от другого события, или NULL.

    virtualKey

    Код виртуальной клавиши для события.

    keyDown

    Передача true указать, что снижается ключевая позиция. Указать, что ключевая позиция произошла, передача false. Это значение используется, чтобы решить, что тип события клавиатуры — видит Типы событий.

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

    Новое событие клавиатуры, или NULL если не могло бы быть создано событие. Когда Вам больше не нужно событие, необходимо выпустить его с помощью функции CFRelease.

    Обсуждение

    Все нажатия клавиш должны были генерировать символ, должен быть введен, включая модифицирующие клавиши. Например, для создания 'Z' клавиша SHIFT должна снизиться, 'z' ключ должен потерять работоспособность, и затем SHIFT и 'z' ключ должны быть выпущены:

    • CGEventRef event1, event2, event3, event4;
    • event1 = CGEventCreateKeyboardEvent (NULL, (CGKeyCode)56, true);
    • event2 = CGEventCreateKeyboardEvent (NULL, (CGKeyCode)6, true);
    • event3 = CGEventCreateKeyboardEvent (NULL, (CGKeyCode)6, false);
    • event4 = CGEventCreateKeyboardEvent (NULL, (CGKeyCode)56, false);

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventCreateScrollWheelEvent CGEventCreateScrollWheelEvent

    Возвращает новое Кварцевое событие прокрутки.

    Объявление

    Objective C

    CGEventRef CGEventCreateScrollWheelEvent ( CGEventSourceRef source, CGScrollEventUnit units, uint32_t wheelCount, int32_t wheel1, ... );

    Параметры

    source

    Источник события, взятый от другого события, или NULL.

    units

    Единица измерения для события прокрутки. Передайте одну из констант, перечисленных в Прокрутке Модулей События.

    wheelCount

    Число прокрутки устройств на мыши, максимум до 3.

    wheel1

    Значение, отражающее перемещение основного устройства прокрутки на мыши. Прокрутка перемещения обычно представляется маленькими значениями целого числа со знаком, обычно в диапазоне от-10 до +10. Большие значения могут иметь неожиданные результаты, в зависимости от приложения, обрабатывающего событие.

    ...

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

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

    Новое событие прокрутки, или NULL если не могло бы быть создано событие. Когда Вам больше не нужно событие, необходимо выпустить его с помощью функции CFRelease.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

  • CGEventCreateCopy (_:) CGEventCreateCopy

    Возвращает копию существующего события Quartz.

    Объявление

    Swift

    func CGEventCreateCopy(_ event: CGEvent!) -> Unmanaged<CGEvent>!

    Objective C

    CGEventRef CGEventCreateCopy ( CGEventRef event );

    Параметры

    event

    Скопированное событие.

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

    Копия указанного события. Когда Вам больше не нужна копия, необходимо выпустить ее с помощью функции CFRelease.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventCreateSourceFromEvent (_:) CGEventCreateSourceFromEvent

    Возвращает Кварцевый источник события, создаваемый из существующего события Quartz.

    Объявление

    Swift

    func CGEventCreateSourceFromEvent(_ event: CGEvent!) -> Unmanaged<CGEventSource>!

    Objective C

    CGEventSourceRef CGEventCreateSourceFromEvent ( CGEventRef event );

    Параметры

    event

    Событие к доступу.

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

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

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSetSource (_: _:) CGEventSetSource

    Устанавливает источник события события Quartz.

    Объявление

    Swift

    func CGEventSetSource(_ event: CGEvent!, _ source: CGEventSource!)

    Objective C

    void CGEventSetSource ( CGEventRef event, CGEventSourceRef source );

    Параметры

    event

    Событие к доступу.

    source

    Новый источник события указанного события.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventGetType (_:) CGEventGetType

    Возвращается тип события события Quartz (снизил мышь, например).

    Объявление

    Swift

    func CGEventGetType(_ event: CGEvent!) -> CGEventType

    Objective C

    CGEventType CGEventGetType ( CGEventRef event );

    Параметры

    event

    Событие к доступу.

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

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGEventSetType

  • CGEventSetType (_: _:) CGEventSetType

    Устанавливает тип события события Quartz (снизил мышь, например).

    Объявление

    Swift

    func CGEventSetType(_ event: CGEvent!, _ type: CGEventType)

    Objective C

    void CGEventSetType ( CGEventRef event, CGEventType type );

    Параметры

    event

    Событие к доступу.

    type

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGEventGetType

  • CGEventGetTimestamp (_:) CGEventGetTimestamp

    Возвращает метку времени события Quartz.

    Объявление

    Swift

    func CGEventGetTimestamp(_ event: CGEvent!) -> CGEventTimestamp

    Objective C

    CGEventTimestamp CGEventGetTimestamp ( CGEventRef event );

    Параметры

    event

    Событие к доступу.

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

    Текущая метка времени указанного события.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSetTimestamp (_: _:) CGEventSetTimestamp

    Устанавливает метку времени события Quartz.

    Объявление

    Swift

    func CGEventSetTimestamp(_ event: CGEvent!, _ timestamp: CGEventTimestamp)

    Objective C

    void CGEventSetTimestamp ( CGEventRef event, CGEventTimestamp timestamp );

    Параметры

    event

    Событие к доступу.

    timestamp

    Новая метка времени указанного события.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventGetLocation (_:) CGEventGetLocation

    Возвращает расположение Кварцевого события от нажатия мыши.

    Объявление

    Swift

    func CGEventGetLocation(_ event: CGEvent!) -> CGPoint

    Objective C

    CGPoint CGEventGetLocation ( CGEventRef event );

    Параметры

    event

    Событие от нажатия мыши для определения местоположения.

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

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventGetUnflippedLocation (_:) CGEventGetUnflippedLocation

    Возвращает расположение Кварцевого события от нажатия мыши.

    Объявление

    Swift

    func CGEventGetUnflippedLocation(_ event: CGEvent!) -> CGPoint

    Objective C

    CGPoint CGEventGetUnflippedLocation ( CGEventRef event );

    Параметры

    event

    Событие от нажатия мыши, расположение которого Вы хотите получить.

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

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

    Обсуждение

    Эта функция возвращает расположение курсора мыши, связанного с событием. Используемая система координат относительно нижнего левого угла основного дисплея и совместима с глобальной системой координат, используемой Набором Приложения.

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

    • CGPoint p = CGEventGetLocation(event);
    • p.y = main_display_height - p.y;
    • /* not p.y = (main_display_height - 1) - p.y */
    • return p;

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSetLocation (_: _:) CGEventSetLocation

    Устанавливает расположение Кварцевого события от нажатия мыши.

    Объявление

    Swift

    func CGEventSetLocation(_ event: CGEvent!, _ location: CGPoint)

    Objective C

    void CGEventSetLocation ( CGEventRef event, CGPoint location );

    Параметры

    event

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

    location

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventGetFlags (_:) CGEventGetFlags

    Возвращает флаги события события Quartz.

    Объявление

    Swift

    func CGEventGetFlags(_ event: CGEvent!) -> CGEventFlags

    Objective C

    CGEventFlags CGEventGetFlags ( CGEventRef event );

    Параметры

    event

    Событие к доступу.

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

    Текущие флаги указанного события. Для получения дополнительной информации посмотрите Флаги События.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSetFlags (_: _:) CGEventSetFlags

    Устанавливает флаги события события Quartz.

    Объявление

    Swift

    func CGEventSetFlags(_ event: CGEvent!, _ location: CGEventFlags)

    Objective C

    void CGEventSetFlags ( CGEventRef event, CGEventFlags flags );

    Параметры

    event

    Событие к доступу.

    location

    Новые флаги указанного события. Посмотрите Флаги События.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventKeyboardGetUnicodeString (_: _: _: _:) CGEventKeyboardGetUnicodeString

    Возвращает строку Unicode, связанную с Кварцевым событием клавиатуры.

    Объявление

    Swift

    func CGEventKeyboardGetUnicodeString(_ event: CGEvent!, _ maxStringLength: UniCharCount, _ actualStringLength: UnsafeMutablePointer<UniCharCount>, _ unicodeString: UnsafeMutablePointer<UniChar>)

    Objective C

    void CGEventKeyboardGetUnicodeString ( CGEventRef event, UniCharCount maxStringLength, UniCharCount *actualStringLength, UniChar unicodeString[] );

    Параметры

    event

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

    maxStringLength

    Длина массива Вы обеспечиваете в unicodeString параметр.

    actualStringLength

    Указатель на a UniCharCount переменная. По возврату переменная содержит фактическое количество символов Unicode в конечном счете данные.

    unicodeString

    Указатель на a UniChar массив. Вы ответственны за выделение хранения для массива. По возврату Ваш массив содержит строку Unicode, связанную с указанным событием.

    Обсуждение

    Когда Вы вызываете эту функцию и указываете a NULL строка или максимальная длина строки 0, функция все еще возвращает фактическое количество символов Unicode в конечном счете данные.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventKeyboardSetUnicodeString (_: _: _:) CGEventKeyboardSetUnicodeString

    Устанавливает строку Unicode, связанную с Кварцевым событием клавиатуры.

    Объявление

    Swift

    func CGEventKeyboardSetUnicodeString(_ event: CGEvent!, _ stringLength: UniCharCount, _ unicodeString: UnsafePointer<UniChar>)

    Objective C

    void CGEventKeyboardSetUnicodeString ( CGEventRef event, UniCharCount stringLength, const UniChar unicodeString[] );

    Параметры

    event

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

    stringLength

    Длина массива Вы обеспечиваете в unicodeString параметр.

    unicodeString

    Массив, содержащий новую строку Unicode, связанную с указанным событием.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventGetIntegerValueField (_: _:) CGEventGetIntegerValueField

    Возвращает целочисленное значение поля в событии Quartz.

    Объявление

    Swift

    func CGEventGetIntegerValueField(_ event: CGEvent!, _ field: CGEventField) -> Int64

    Objective C

    int64_t CGEventGetIntegerValueField ( CGEventRef event, CGEventField field );

    Параметры

    event

    Событие к доступу.

    field

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

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

    64-разрядное целочисленное представление текущей стоимости указанного поля.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSetIntegerValueField (_: _: _:) CGEventSetIntegerValueField

    Устанавливает целочисленное значение поля в событии Quartz.

    Объявление

    Swift

    func CGEventSetIntegerValueField(_ event: CGEvent!, _ field: CGEventField, _ value: Int64)

    Objective C

    void CGEventSetIntegerValueField ( CGEventRef event, CGEventField field, int64_t value );

    Параметры

    event

    Событие к доступу.

    field

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

    value

    Новое значение указанного поля.

    Обсуждение

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

    Если Вы создаете событие от нажатия мыши, сгенерированное планшетом, вызываете эту функцию и указываете поле kCGMouseEventSubtype со значением kCGEventMouseSubtypeTabletPoint или kCGEventMouseSubtypeTabletProximity прежде, чем установить другие параметры.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventGetDoubleValueField (_: _:) CGEventGetDoubleValueField

    Возвращает значение с плавающей точкой поля в событии Quartz.

    Объявление

    Swift

    func CGEventGetDoubleValueField(_ event: CGEvent!, _ field: CGEventField) -> Double

    Objective C

    double CGEventGetDoubleValueField ( CGEventRef event, CGEventField field );

    Параметры

    event

    Событие к доступу.

    field

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

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

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

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSetDoubleValueField (_: _: _:) CGEventSetDoubleValueField

    Устанавливает значение с плавающей точкой поля в событии Quartz.

    Объявление

    Swift

    func CGEventSetDoubleValueField(_ event: CGEvent!, _ field: CGEventField, _ value: Double)

    Objective C

    void CGEventSetDoubleValueField ( CGEventRef event, CGEventField field, double value );

    Параметры

    event

    Событие к доступу.

    field

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

    value

    Новое значение указанного поля.

    Обсуждение

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

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

Работа с кварцевыми касаниями события
  • CGEventTapCreate (_: _: _: _: _: _:) CGEventTapCreate

    Создает касание события.

    Объявление

    Swift

    func CGEventTapCreate(_ tap: CGEventTapLocation, _ place: CGEventTapPlacement, _ options: CGEventTapOptions, _ eventsOfInterest: CGEventMask, _ callback: CGEventTapCallBack, _ refcon: UnsafeMutablePointer<Void>) -> Unmanaged<CFMachPort>!

    Objective C

    CFMachPortRef CGEventTapCreate ( CGEventTapLocation tap, CGEventTapPlacement place, CGEventTapOptions options, CGEventMask eventsOfInterest, CGEventTapCallBack callback, void *userInfo );

    Параметры

    tap

    Расположение нового касания события. Передайте одну из констант, перечисленных в Расположениях Касания События. Только процессы, работающие как пользователь root, могут определить местоположение касания события в точке, где события HID вводят сервер окна; для других пользователей, эта функция возвраты NULL.

    place

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

    options

    Константа, указывающая, является ли новое касание события пассивным слушателем или активным фильтром.

    eventsOfInterest

    Немного маски, указывающей набор событий, которые будут наблюдаться. Для списка возможных событий посмотрите Типы событий. Для получения информации о том, как указать маску, посмотрите CGEventMask. Если касанию события не разрешают контролировать один или больше событий, указанных в eventsOfInterest параметр, тогда надлежащие биты в маске очищены. Если то действие приводит к пустой маске, эта функция возвраты NULL.

    callback

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

    refcon

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

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

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

    Обсуждение

    Касания события получают, настраивают и ключ вниз события, если одно из следующих условий является истиной:

    • Текущий процесс работает как пользователь root.

    • Доступ для вспомогательных устройств включен. В OS X v10.4, можно активировать эту опцию с помощью Установок системы, панели Universal Access, представления Keyboard.

    После создания касания события можно добавить его к циклу выполнения следующим образом:

    1. Передайте касание события CFMachPortCreateRunLoopSource функция для создания источника события цикла выполнения.

    2. Вызовите CFRunLoopAddSource функция для добавления источника к надлежащему циклу выполнения.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventTapCreateForPSN (_: _: _: _: _: _:) CGEventTapCreateForPSN

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

    Объявление

    Swift

    func CGEventTapCreateForPSN(_ processSerialNumber: UnsafeMutablePointer<Void>, _ place: CGEventTapPlacement, _ options: CGEventTapOptions, _ eventsOfInterest: CGEventMask, _ callback: CGEventTapCallBack, _ refcon: UnsafeMutablePointer<Void>) -> Unmanaged<CFMachPort>!

    Objective C

    CFMachPortRef CGEventTapCreateForPSN ( void *processSerialNumber, CGEventTapPlacement place, CGEventTapOptions options, CGEventMask eventsOfInterest, CGEventTapCallBack callback, void *userInfo );

    Параметры

    processSerialNumber

    Процесс для контроля.

    place

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

    options

    Константа, указывающая, является ли новое касание события пассивным слушателем или активным фильтром.

    eventsOfInterest

    Немного маски, указывающей набор событий, которые будут наблюдаться. Для списка возможных событий посмотрите Типы событий. Для получения информации о том, как указать маску, посмотрите CGEventMask. Если касанию события не разрешают контролировать один или больше событий, указанных в eventsOfInterest параметр, тогда надлежащие биты в маске очищены. Если то действие приводит к пустой маске, эта функция возвраты NULL.

    callback

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

    refcon

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

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

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

    Обсуждение

    Эта функция создает касание события, получающее события, направляемые сервером окна к указанному процессу. Для получения дополнительной информации о создании касаний события, посмотрите CGEventTapCreate.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventTapEnable (_: _:) CGEventTapEnable

    Включает или отключает касание события.

    Объявление

    Swift

    func CGEventTapEnable(_ myTap: CFMachPort!, _ enable: Bool)

    Objective C

    void CGEventTapEnable ( CFMachPortRef tap, bool enable );

    Параметры

    myTap

    Касание события, чтобы включить или отключить.

    enable

    Передача true включить касание события. Отключить его, передача false.

    Обсуждение

    Касания события обычно включаются, когда создается. Если касание события становится безразличным, или если пользователь запрашивает, чтобы касания события были отключены, то a kCGEventTapDisabled событие передается функции обратного вызова касания события. Касания события могут быть повторно включены путем вызывания этой функции.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventTapIsEnabled (_:) CGEventTapIsEnabled

    Возвращает булево значение, указывающее, включено ли касание события.

    Объявление

    Swift

    func CGEventTapIsEnabled(_ myTap: CFMachPort!) -> Bool

    Objective C

    bool CGEventTapIsEnabled ( CFMachPortRef tap );

    Параметры

    myTap

    Касание события для тестирования.

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

    Если true, указанное касание события включено; иначе, false.

    Обсуждение

    Для получения дополнительной информации посмотрите функцию CGEventTapEnable.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventTapPostEvent (_: _:) CGEventTapPostEvent

    Сообщения событие Quartz от события наслаждаются поток событий.

    Объявление

    Swift

    func CGEventTapPostEvent(_ proxy: CGEventTapProxy, _ event: CGEvent!)

    Objective C

    void CGEventTapPostEvent ( CGEventTapProxy proxy, CGEventRef event );

    Параметры

    proxy

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

    event

    Событие для регистрации.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventPost (_: _:) CGEventPost

    Отправляет событие Quartz в поток событий в указанном расположении.

    Объявление

    Swift

    func CGEventPost(_ tap: CGEventTapLocation, _ event: CGEvent!)

    Objective C

    void CGEventPost ( CGEventTapLocation tap, CGEventRef event );

    Параметры

    tap

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

    event

    Событие для регистрации.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventPostToPSN (_: _:) CGEventPostToPSN

    Отправляет событие Quartz в поток событий для определенного приложения.

    Объявление

    Swift

    func CGEventPostToPSN(_ processSerialNumber: UnsafeMutablePointer<Void>, _ event: CGEvent!)

    Objective C

    void CGEventPostToPSN ( void *processSerialNumber, CGEventRef event );

    Параметры

    processSerialNumber

    Процесс для получения события.

    event

    Событие для регистрации.

    Обсуждение

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

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGGetEventTapList (_: _: _:) CGGetEventTapList

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

    Объявление

    Swift

    func CGGetEventTapList(_ maxNumberOfTaps: UInt32, _ tapList: UnsafeMutablePointer<CGEventTapInformation>, _ eventTapCount: UnsafeMutablePointer<UInt32>) -> CGError

    Objective C

    CGError CGGetEventTapList ( uint32_t maxNumberOfTaps, CGEventTapInformation tapList[], uint32_t *eventTapCount );

    Параметры

    maxNumberOfTaps

    Длина массива Вы обеспечиваете в tapList параметр.

    tapList

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

    eventTapCount

    Указатель на a CGTableCount переменная. По возврату переменная содержит фактическое число заполненных элементов матрицы.

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

    Код результата. Посмотрите коды результата, описанные в Ссылке Quartz Display Services.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventMaskBit CGEventMaskBit

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

    Объявление

    Objective C

    CGEventMask CGEventMaskBit ( CGEventType eventType );

    Параметры

    eventType

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

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

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

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

Работа с кварцевыми источниками событий
  • CGEventSourceGetTypeID () CGEventSourceGetTypeID

    Возвращает идентификатор типа для непрозрачного типа CGEventSourceRef.

    Объявление

    Swift

    func CGEventSourceGetTypeID() -> CFTypeID

    Objective C

    CFTypeID CGEventSourceGetTypeID ( void );

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

    Базовый идентификатор типа Основы для непрозрачного типа CGEventSourceRef.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceCreate (_:) CGEventSourceCreate

    Возвращает Кварцевый источник события, создаваемый с указанным исходным состоянием.

    Объявление

    Swift

    func CGEventSourceCreate(_ sourceState: CGEventSourceStateID) -> Unmanaged<CGEventSource>!

    Objective C

    CGEventSourceRef CGEventSourceCreate ( CGEventSourceStateID stateID );

    Параметры

    sourceState

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

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

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

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceGetKeyboardType (_:) CGEventSourceGetKeyboardType

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

    Объявление

    Swift

    func CGEventSourceGetKeyboardType(_ source: CGEventSource!) -> CGEventSourceKeyboardType

    Objective C

    CGEventSourceKeyboardType CGEventSourceGetKeyboardType ( CGEventSourceRef source );

    Параметры

    source

    Источник события к доступу. Передайте одну из констант, перечисленных в состояниях Источника события.

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

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceSetKeyboardType (_: _:) CGEventSourceSetKeyboardType

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

    Объявление

    Swift

    func CGEventSourceSetKeyboardType(_ source: CGEventSource!, _ keyboardType: CGEventSourceKeyboardType)

    Objective C

    void CGEventSourceSetKeyboardType ( CGEventSourceRef source, CGEventSourceKeyboardType keyboardType );

    Параметры

    source

    Источник события к доступу.

    keyboardType

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceGetSourceStateID (_:) CGEventSourceGetSourceStateID

    Возвращает исходное состояние, связанное с Кварцевым источником события.

    Объявление

    Swift

    func CGEventSourceGetSourceStateID(_ source: CGEventSource!) -> CGEventSourceStateID

    Objective C

    CGEventSourceStateID CGEventSourceGetSourceStateID ( CGEventSourceRef source );

    Параметры

    source

    Источник события к доступу.

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

    Исходное состояние связалось с указанным источником события.

    Обсуждение

    Эта функция возвращает ID исходной таблицы состояния, связанной с источником события.

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceButtonState (_: _:) CGEventSourceButtonState

    Возвращает булево значение, указывающее текущее состояние кнопки Кварцевого источника события.

    Объявление

    Swift

    func CGEventSourceButtonState(_ sourceState: CGEventSourceStateID, _ button: CGMouseButton) -> Bool

    Objective C

    bool CGEventSourceButtonState ( CGEventSourceStateID stateID, CGMouseButton button );

    Параметры

    sourceState

    Исходное состояние к доступу. Передайте одну из констант, перечисленных в состояниях Источника события.

    button

    Кнопка мыши для тестирования. Передайте одну из констант, перечисленных в Кнопках мыши.

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

    Если true, кнопка снижается. Если false, кнопка возросла.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceKeyState (_: _:) CGEventSourceKeyState

    Возвращает булево значение, указывающее текущее состояние клавиатуры Кварцевого источника события.

    Объявление

    Swift

    func CGEventSourceKeyState(_ sourceState: CGEventSourceStateID, _ key: CGKeyCode) -> Bool

    Objective C

    bool CGEventSourceKeyState ( CGEventSourceStateID stateID, CGKeyCode key );

    Параметры

    sourceState

    Исходное состояние к доступу. Передайте одну из констант, перечисленных в состояниях Источника события.

    key

    Код виртуальной клавиши для тестирования.

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

    Если true, ключ снижается. Если false, ключ произошел.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceFlagsState (_:) CGEventSourceFlagsState

    Возвращает текущие флаги Кварцевого источника события.

    Объявление

    Swift

    func CGEventSourceFlagsState(_ sourceState: CGEventSourceStateID) -> CGEventFlags

    Objective C

    CGEventFlags CGEventSourceFlagsState ( CGEventSourceStateID stateID );

    Параметры

    sourceState

    Исходное состояние к доступу. Передайте одну из констант, перечисленных в состояниях Источника события.

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

    Текущие флаги указанного источника события. Для получения дополнительной информации посмотрите Флаги События.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceSecondsSinceLastEventType (_: _:) CGEventSourceSecondsSinceLastEventType

    Возвращает прошедшее время начиная с последнего события для Кварцевого источника события.

    Объявление

    Swift

    func CGEventSourceSecondsSinceLastEventType(_ source: CGEventSourceStateID, _ eventType: CGEventType) -> CFTimeInterval

    Objective C

    CFTimeInterval CGEventSourceSecondsSinceLastEventType ( CGEventSourceStateID stateID, CGEventType eventType );

    Параметры

    source

    Исходное состояние к доступу. Передайте одну из констант, перечисленных в состояниях Источника события.

    eventType

    Тип события к доступу. Для получения прошедшего времени начиная с предыдущего входного события — клавиатуры, мыши, или планшета — указывают kCGAnyInputEventType.

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

    Время в секундах начиная с предыдущего входного события указанного типа.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceCounterForEventType (_: _:) CGEventSourceCounterForEventType

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

    Объявление

    Swift

    func CGEventSourceCounterForEventType(_ sourceState: CGEventSourceStateID, _ eventType: CGEventType) -> UInt32

    Objective C

    uint32_t CGEventSourceCounterForEventType ( CGEventSourceStateID stateID, CGEventType eventType );

    Параметры

    sourceState

    Исходное состояние к доступу. Передайте одну из констант, перечисленных в состояниях Источника события.

    eventType

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

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

    Количество событий указанного типа, замеченного, так как запустился сервер окна.

    Обсуждение

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

    Модифицирующие клавиши производят kCGEventFlagsChanged события, нет kCGEventKeyDown события, и делают так и на нажатии и на выпуске. Объем, яркость и CD извлекаются, включает некоторые клавиатуры (и рабочий стол и ноутбук), не генерируют, настраивают или ключ вниз события.

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

    Ключевые события автоповтора не считаются.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceGetUserData (_:) CGEventSourceGetUserData

    Возвращает 64-разрядные указанные пользователями данные для Кварцевого источника события.

    Объявление

    Swift

    func CGEventSourceGetUserData(_ source: CGEventSource!) -> Int64

    Objective C

    int64_t CGEventSourceGetUserData ( CGEventSourceRef source );

    Параметры

    source

    Источник события к доступу.

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

    Указанные пользователями данные.

    Обсуждение

    Каждое входное событие включает 64 бита указанных пользователями данных. Эта функция получает указанные пользователями данные для всех событий, создаваемых указанным источником события. Эти данные могут также быть получены на событие с помощью CGEventGetIntegerValueField функция.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceSetUserData (_: _:) CGEventSourceSetUserData

    Устанавливает 64-разрядные указанные пользователями данные для Кварцевого источника события.

    Объявление

    Swift

    func CGEventSourceSetUserData(_ source: CGEventSource!, _ userData: Int64)

    Objective C

    void CGEventSourceSetUserData ( CGEventSourceRef source, int64_t userData );

    Параметры

    source

    Источник события к доступу.

    userData

    Указанные пользователями данные. Например, Вы могли указать аппаратные средства поставщика ID.

    Обсуждение

    Каждое входное событие включает 64 бита указанных пользователями данных. Эта функция устанавливает указанные пользователями данные для всех событий, создаваемых указанным источником события. Эти данные могут также быть установлены на событие с помощью CGEventSetIntegerValueField функция.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceGetLocalEventsFilterDuringSuppressionState (_: _:) CGEventSourceGetLocalEventsFilterDuringSuppressionState

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

    Объявление

    Swift

    func CGEventSourceGetLocalEventsFilterDuringSuppressionState(_ source: CGEventSource!, _ state: CGEventSuppressionState) -> CGEventFilterMask

    Objective C

    CGEventFilterMask CGEventSourceGetLocalEventsFilterDuringSuppressionState ( CGEventSourceRef source, CGEventSuppressionState state );

    Параметры

    source

    Источник события к доступу.

    state

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

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

    Маска, указывающая категории событий локального оборудования для включения во время интервала утаивания события. Посмотрите Маски Фильтра События.

    Обсуждение

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

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceSetLocalEventsFilterDuringSuppressionState (_: _: _:) CGEventSourceSetLocalEventsFilterDuringSuppressionState

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

    Объявление

    Swift

    func CGEventSourceSetLocalEventsFilterDuringSuppressionState(_ source: CGEventSource!, _ filter: CGEventFilterMask, _ state: CGEventSuppressionState)

    Objective C

    void CGEventSourceSetLocalEventsFilterDuringSuppressionState ( CGEventSourceRef source, CGEventFilterMask filter, CGEventSuppressionState state );

    Параметры

    source

    Источник события к доступу.

    filter

    Маска, указывающая категории событий локального оборудования для включения во время интервала утаивания события. Посмотрите Маски Фильтра События.

    state

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

    Обсуждение

    По умолчанию система не подавляет события локального оборудования с клавиатуры или мыши во время короткого интервала после того, как событие Quartz отправляется — посмотрите CGEventSourceSetLocalEventsSuppressionInterval— и во время синтетической мыши перетаскивают (движение мыши с левыми или только кнопкой мыши вниз).

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceGetLocalEventsSuppressionInterval (_:) CGEventSourceGetLocalEventsSuppressionInterval

    Возвращает интервал, что события локального оборудования могут быть подавлены после регистрации события Quartz.

    Объявление

    Swift

    func CGEventSourceGetLocalEventsSuppressionInterval(_ source: CGEventSource!) -> CFTimeInterval

    Objective C

    CFTimeInterval CGEventSourceGetLocalEventsSuppressionInterval ( CGEventSourceRef source );

    Параметры

    source

    Источник события к доступу.

    Обсуждение

    По умолчанию система не подавляет события локального оборудования с клавиатуры или мыши во время короткого интервала после того, как будет отправлено событие Quartz. Можно использовать функцию CGEventSourceSetLocalEventsFilterDuringSuppressionState изменить это поведение.

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceSetLocalEventsSuppressionInterval (_: _:) CGEventSourceSetLocalEventsSuppressionInterval

    Устанавливает интервал, что события локального оборудования могут быть подавлены после регистрации события Quartz.

    Объявление

    Swift

    func CGEventSourceSetLocalEventsSuppressionInterval(_ source: CGEventSource!, _ seconds: CFTimeInterval)

    Objective C

    void CGEventSourceSetLocalEventsSuppressionInterval ( CGEventSourceRef source, CFTimeInterval seconds );

    Параметры

    source

    Источник события к доступу.

    seconds

    Промежуток времени в секундах, что события локального оборудования (клавиатура или мышь) подавлены после регистрации события Quartz, создаваемого с указанным источником события. Значение должно быть числом в диапазоне [0.0, 10.0].

    Обсуждение

    По умолчанию система не подавляет события локального оборудования с клавиатуры или мыши во время короткого интервала после того, как будет отправлено событие Quartz. Можно использовать функцию CGEventSourceSetLocalEventsFilterDuringSuppressionState изменить это поведение.

    В секундах эта функция устанавливает промежуток времени, что события локального оборудования могут быть подавлены после регистрации события Quartz, создаваемого с указанным источником события. Интервал утаивания по умолчанию составляет 0,25 секунды.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceGetPixelsPerLine (_:) CGEventSourceGetPixelsPerLine

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

    Объявление

    Swift

    func CGEventSourceGetPixelsPerLine(_ source: CGEventSource!) -> Double

    Objective C

    double CGEventSourceGetPixelsPerLine ( CGEventSourceRef source );

    Параметры

    source

    Источник события к доступу.

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

    Масштаб пикселей на строку в событии прокрутки.

    Обсуждение

    Эта функция возвращает масштаб пикселей на строку в указанном источнике события. Например, если бы масштаб в конечном счете источник составляет 10,5 пикселей за строку, эта функция возвратилась бы 10.5. Каждое событие прокрутки может быть интерпретировано для прокрутки пикселем или с методической точностью. По умолчанию масштаб составляет приблизительно десять пикселей за строку. Можно изменить масштаб с функцией CGEventSourceSetPixelsPerLine.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGEventSourceSetPixelsPerLine

  • CGEventSourceSetPixelsPerLine (_: _:) CGEventSourceSetPixelsPerLine

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

    Объявление

    Swift

    func CGEventSourceSetPixelsPerLine(_ source: CGEventSource!, _ pixelsPerLine: Double)

    Objective C

    void CGEventSourceSetPixelsPerLine ( CGEventSourceRef source, double pixelsPerLine );

    Параметры

    source

    Источник события к доступу.

    pixelsPerLine

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

    Обсуждение

    Эта функция устанавливает масштаб пикселей на строку в указанном источнике события. Например, если Вы передаете значение 12.0 в pixelsPerLine параметр, масштаб пикселей на строку в конечном счете источник был бы изменен на 12,0. Каждое событие прокрутки может быть интерпретировано для прокрутки пикселем или с методической точностью. По умолчанию масштаб составляет приблизительно десять пикселей за строку. Можно получить масштаб с функцией CGEventSourceGetPixelsPerLine.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

    См. также

    CGEventSourceGetPixelsPerLine

Устаревшие функции
  • CGEventGetSource CGEventGetSource Доступный в OS X v10.4 через OS X v10.4

    Возвращает Кварцевый источник события, создаваемый из существующего события Quartz.

    Оператор осуждения

    Использовать CGEventCreateSourceFromEvent вместо этого.

    Объявление

    Objective C

    CGEventSourceRef CGEventGetSource ( CGEventRef event );

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

    Objective C

    @import ApplicationServices;

    Доступность

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

    Осуждаемый в OS X v10.4.

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

  • CGPostKeyboardEvent CGPostKeyboardEvent (OS X v10.6)

    Синтезирует низкоуровневое событие клавиатуры на локальной машине.

    Объявление

    Objective C

    CGError CGPostKeyboardEvent ( CGCharCode keyChar, CGKeyCode virtualKey, boolean_t keyDown );

    Параметры

    keyChar

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

    virtualKey

    Код виртуальной клавиши для события. Посмотрите CGKeyCode.

    keyDown

    Передача true указать, что снижается ключевая позиция; иначе, передача false.

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

    Код результата. Посмотрите коды результата, описанные в Ссылке Quartz Display Services.

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • CGPostMouseEvent CGPostMouseEvent (OS X v10.6)

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

    Объявление

    Objective C

    CGError CGPostMouseEvent ( CGPoint mouseCursorPosition, boolean_t updateMouseCursorPosition, CGButtonCount buttonCount, boolean_t mouseButtonDown, ... );

    Параметры

    mouseCursorPosition

    Новые координаты мыши в глобальном выставочном пространстве.

    updateMouseCursorPosition

    Передача true если экранный курсор должен быть перемещен в расположение, указанное в mouseCursorPosition параметр; иначе, передача false.

    buttonCount

    Число кнопок мыши, максимум до 32.

    mouseButtonDown

    Передача true указать, что снижаются основная кнопка мыши или левая кнопка мыши; иначе, передача false.

    ...

    Нулевые или более булевы значения, указывающие, снижаются ли остающиеся кнопки мыши (true) или (false). Второе значение, если таковые имеются, должно указать состояние вторичной кнопки мыши (право). Третье значение указало бы состояние центральной кнопки, и остающиеся кнопки будут в порядке USB-устройства.

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

    Код результата. Посмотрите коды результата, описанные в Ссылке Quartz Display Services.

    Обсуждение

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

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • CGPostScrollWheelEvent CGPostScrollWheelEvent (OS X v10.6)

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

    Объявление

    Objective C

    CGError CGPostScrollWheelEvent ( CGWheelCount wheelCount, int32_t wheel1, ... );

    Параметры

    wheelCount

    Число прокрутки устройств, максимум до 3.

    wheel1

    Значение, отражающее перемещение основного устройства прокрутки на мыши.

    ...

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

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

    Код результата. Посмотрите коды результата, описанные в Ссылке Quartz Display Services.

    Обсуждение

    Прокрутка перемещения обычно представляется маленькими значениями целого числа со знаком, обычно в диапазоне от-10 до +10. Большие значения могут иметь неожиданные результаты, в зависимости от приложения, обрабатывающего событие.

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • CGEnableEventStateCombining CGEnableEventStateCombining (OS X v10.6)

    Включает или отключает слияние фактического ключа и состояния мыши с указанным приложением состоянием в синтетическом событии.

    Объявление

    Objective C

    CGError CGEnableEventStateCombining ( boolean_t combineState );

    Параметры

    doCombineState

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

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

    Код результата. Посмотрите коды результата, описанные в Ссылке Quartz Display Services.

    Обсуждение

    По умолчанию флаги, указывающие состояние модифицирующей клавиши (Команда, Опция, Сдвиг, Управление, и т.д.) с клавиатуры системы и с других источников событий, являются ORed вместе, поскольку событие отправляется в систему, и текущее состояние ключевой и кнопки мыши рассматривают в генерации новых событий. Эта функция позволяет Вашему приложению включать или отключать слияние состояния события. Когда объединение выключено, состояние события, распространенное в событиях, отправленных Вашим приложением, отражают состояние, накопленное только Вашим приложением. Состояние в сгенерированном событии Вашего приложения не будет объединено с текущим состоянием системы, таким образом, отражение состояния в масштабе всей системы состояние ключевой и кнопки мыши останется неизменным. Когда вызвано с doCombineState равный false, эта функция инициализирует локальный (на приложение) информация об отслеживании состояния к состоянию всех ключей, модификаторов и кнопок мыши. Когда вызвано с doCombineState равный true, текущее глобальное состояние ключей, модификаторов и кнопок мыши используется в генерации событий.

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • CGInhibitLocalEvents CGInhibitLocalEvents (OS X v10.6)

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

    Объявление

    Objective C

    CGError CGInhibitLocalEvents ( boolean_t inhibit );

    Параметры

    doInhibit

    Передача true указать, что должны быть запрещены события локального оборудования в удаленной системе; иначе, передача false.

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

    Код результата. Посмотрите коды результата, описанные в Ссылке Quartz Display Services.

    Обсуждение

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

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

    Специальные замечания

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • CGSetLocalEventsFilterDuringSuppressionState CGSetLocalEventsFilterDuringSuppressionState (OS X v10.6)

    События локального оборудования фильтров с клавиатуры и мыши во время короткого интервала после синтетического события отправляются.

    Объявление

    Objective C

    CGError CGSetLocalEventsFilterDuringSuppressionState ( CGEventFilterMask filter, CGEventSuppressionState state );

    Параметры

    filter

    Класс событий локального оборудования для включения после синтетического события отправляется. Передайте одну из констант, перечисленных в Масках Фильтра События.

    state

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

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

    Код результата. Посмотрите коды результата, описанные в Ссылке Quartz Display Services.

    Обсуждение

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

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

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

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

    Осуждаемый в OS X v10.6.

  • CGSetLocalEventsSuppressionInterval CGSetLocalEventsSuppressionInterval (OS X v10.6)

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

    Объявление

    Objective C

    CGError CGSetLocalEventsSuppressionInterval ( CFTimeInterval seconds );

    Параметры

    seconds

    Желаемый временной интервал в секундах. Значение должно быть числом в диапазоне [0.0, 10.0].

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

    Код результата. Если seconds параметр вне позволенного диапазона, возвратов kCGErrorRangeCheck.

    Обсуждение

    Эта функция определяет, сколько времени локальные события, соответствующие фильтр события, должны быть подавлены после регистрации синтетического события. Временной интервал по умолчанию для утаивания события составляет 0,25 секунды.

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

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

    Objective C

    @import CoreGraphics;

    Доступность

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

    Осуждаемый в OS X v10.6.

Обратные вызовы

Кварцевые разные обратные вызовы служб события
  • CGEventTapCallBack CGEventTapCallBack

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

    Объявление

    Swift

    typealias CGEventTapCallBack = CFunctionPointer<((CGEventTapProxy, CGEventType, CGEvent!, UnsafeMutablePointer<Void>) -> Unmanaged<CGEvent>!)>

    Objective C

    typedef CGEventRef (*CGEventTapCallBack) ( CGEventTapProxy proxy, CGEventType type, CGEventRef event, void *refcon );

    Параметры

    proxy

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

    type

    Тип события этого события. Посмотрите Типы событий.

    event

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

    refcon

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

    Обсуждение

    Если касание события является активным фильтром, Ваша функция обратного вызова должна возвратить одно из следующего:

    • (Возможно измененный) событие, передающееся в. Это событие пасуется назад к системе событий.

    • Недавно созданное событие. После того, как новое событие пасовалось назад к системе событий, новое событие будет выпущено вместе с исходным событием.

    • NULL если бы событие передало в, то должен быть удален.

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

Типы данных

  • CGButtonCount CGButtonCount

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

    Объявление

    Swift

    typealias CGButtonCount = UInt32

    Objective C

    typedef uint32_t CGButtonCount;

    Обсуждение

    В событиях от нажатия мыши параметр количества кнопки колеблется от 0 до 31. Посмотрите функцию CGPostMouseEvent.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGCharCode CGCharCode

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

    Объявление

    Swift

    typealias CGCharCode = UInt16

    Objective C

    typedef uint16_t CGCharCode;

    Обсуждение

    Этот тип данных представляет 16-разрядный код символа. Значения этого типа могут или могут не соответствовать кодам символов UTF-16. Посмотрите функцию CGPostKeyboardEvent.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventMask CGEventMask

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

    Объявление

    Swift

    typealias CGEventMask = UInt64

    Objective C

    typedef uint64_t CGEventMask;

    Обсуждение

    Когда Вы вызываете также CGEventTapCreate или CGEventTapCreateForPSN для регистрации касания события Вы предоставляете немного маски, идентифицирующей набор событий, которые будут наблюдаться. Вы указываете каждое событие с помощью одной из констант типа события, перечисленных в Типах событий. Для формирования битовой маски используйте CGEventMaskBit макрос для преобразования каждой константы в маску события и затем OR отдельные маски вместе. Например:

    • CGEventMask mask = CGEventMaskBit(kCGEventLeftMouseDown) |
    • CGEventMaskBit(kCGEventLeftMouseUp);

    Можно также предоставить маску для наблюдения всех событий:

    • CGEventMask mask = kCGEventMaskForAllEvents;

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventRef CGEventRef

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

    Объявление

    Swift

    typealias CGEventRef = CGEvent

    Objective C

    typedef struct __CGEvent *CGEventRef;

    Обсуждение

    Низкоуровневые аппаратные события этого типа упоминаются как события Quartz. Когда пользователь управляет устройством ввода данных, таким как мышь или клавиатура, типичное событие в OS X происходит. Драйвер устройства, связанный с тем устройством, через Набор I/O, создает низкоуровневое событие, помещает его в очередь событий сервера окна и уведомляет сервер окна. Сервер окна создает событие Quartz, аннотирует событие и диспетчеризирует событие надлежащему порту цикла выполнения целевого процесса. Там событие взято менеджером событий Углерода и передано к механизму обработки событий, надлежащему среде приложения. Можно использовать касания события для получения доступа к событиям Quartz на нескольких различных шагах в этом процессе.

    Этот непрозрачный тип получен из CFType и наследовал свойства, которые все Базовые типы Основы имеют вместе. Для получения дополнительной информации см. Ссылку CFType.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceKeyboardType CGEventSourceKeyboardType

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

    Объявление

    Swift

    typealias CGEventSourceKeyboardType = UInt32

    Objective C

    typedef uint32_t CGEventSourceKeyboardType;

    Обсуждение

    Этот код является тем же идентификатором типа клавиатуры, используемым с UCKeyTranslate функционируйте для управления переводом клавиатуры.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventSourceRef CGEventSourceRef

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

    Объявление

    Swift

    typealias CGEventSourceRef = CGEventSource

    Objective C

    typedef struct __CGEventSource * CGEventSourceRef;

    Обсуждение

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

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

    Этот непрозрачный тип получен из CFType и наследовал свойства, которые все Базовые типы Основы имеют вместе. Для получения дополнительной информации см. Ссылку CFType.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventTapInformation

    Определяет структуру, используемую для сообщения информации о касаниях события.

    Объявление

    Swift

    typealias CGEventTapInformation = __CGEventTapInformation

    Objective C

    typedef struct CGEventTapInformation { uint32_t eventTapID; CGEventTapLocation tapPoint; CGEventTapOptions options; CGEventMask eventsOfInterest; pid_t tappingProcess; pid_t processBeingTapped; bool enabled; float minUsecLatency; float avgUsecLatency; float maxUsecLatency; } CGEventTapInformation;

    Поля

    eventTapID

    Уникальный идентификатор для касания события.

    tapPoint

    Расположение касания события. Посмотрите Расположения Касания События.

    options

    Тип касания события (пассивный слушатель или активный фильтр).

    eventsOfInterest

    Маска, идентифицирующая набор событий, которые будут наблюдаться.

    tappingProcess

    ID процесса приложения, создавшего касание события.

    processBeingTapped

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

    enabled

    TRUE если в настоящее время включается касание события; иначе FALSE.

    minUsecLatency

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

    avgUsecLatency

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

    maxUsecLatency

    Максимальная задержка в микросекундах.

    Обсуждение

    Чтобы изучить, как получить информацию о касаниях события, посмотрите функцию CGGetEventTapList.

    Доступность

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

  • CGEventTapProxy CGEventTapProxy

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

    Объявление

    Swift

    typealias CGEventTapProxy = COpaquePointer

    Objective C

    typedef struct __CGEventTapProxy * CGEventTapProxy;

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGEventTimestamp CGEventTimestamp

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

    Объявление

    Swift

    typealias CGEventTimestamp = UInt64

    Objective C

    typedef uint64_t CGEventTimestamp;

    Обсуждение

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

    Для получения информации о том, как метки времени события используются, видят функции CGEventGetTimestamp и CGEventSetTimestamp.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGKeyCode CGKeyCode

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

    Объявление

    Swift

    typealias CGKeyCode = UInt16

    Objective C

    typedef uint16_t CGKeyCode;

    Обсуждение

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

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • CGWheelCount CGWheelCount

    Представляет число колес, устанавливаемых в событии колесика прокрутки.

    Объявление

    Swift

    typealias CGWheelCount = UInt32

    Objective C

    typedef uint32_t CGWheelCount;

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

Константы

  • Поля события

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

    Объявление

    Swift

    typealias CGEventField = UInt32

    Objective C

    enum _CGEventField { kCGMouseEventNumber = 0, kCGMouseEventClickState = 1, kCGMouseEventPressure = 2, kCGMouseEventButtonNumber = 3, kCGMouseEventDeltaX = 4, kCGMouseEventDeltaY = 5, kCGMouseEventInstantMouser = 6, kCGMouseEventSubtype = 7, kCGKeyboardEventAutorepeat = 8, kCGKeyboardEventKeycode = 9, kCGKeyboardEventKeyboardType = 10, kCGScrollWheelEventDeltaAxis1 = 11, kCGScrollWheelEventDeltaAxis2 = 12, kCGScrollWheelEventDeltaAxis3 = 13, kCGScrollWheelEventFixedPtDeltaAxis1 = 93, kCGScrollWheelEventFixedPtDeltaAxis2 = 94, kCGScrollWheelEventFixedPtDeltaAxis3 = 95, kCGScrollWheelEventPointDeltaAxis1 = 96, kCGScrollWheelEventPointDeltaAxis2 = 97, kCGScrollWheelEventPointDeltaAxis3 = 98, kCGScrollWheelEventInstantMouser = 14, kCGTabletEventPointX = 15, kCGTabletEventPointY = 16, kCGTabletEventPointZ = 17, kCGTabletEventPointButtons = 18, kCGTabletEventPointPressure = 19, kCGTabletEventTiltX = 20, kCGTabletEventTiltY = 21, kCGTabletEventRotation = 22, kCGTabletEventTangentialPressure = 23, kCGTabletEventDeviceID = 24, kCGTabletEventVendor1 = 25, kCGTabletEventVendor2 = 26, kCGTabletEventVendor3 = 27, kCGTabletProximityEventVendorID = 28, kCGTabletProximityEventTabletID = 29, kCGTabletProximityEventPointerID = 30, kCGTabletProximityEventDeviceID = 31, kCGTabletProximityEventSystemTabletID = 32, kCGTabletProximityEventVendorPointerType = 33, kCGTabletProximityEventVendorPointerSerialNumber = 34, kCGTabletProximityEventVendorUniqueID = 35, kCGTabletProximityEventCapabilityMask = 36, kCGTabletProximityEventPointerType = 37, kCGTabletProximityEventEnterProximity = 38, kCGEventTargetProcessSerialNumber = 39, kCGEventTargetUnixProcessID = 40, kCGEventSourceUnixProcessID = 41, kCGEventSourceUserData = 42, kCGEventSourceUserID = 43, kCGEventSourceGroupID = 44, kCGEventSourceStateID = 45, kCGScrollWheelEventIsContinuous = 88 }; typedef uint32_t CGEventField;

    Константы

    • kCGMouseEventNumber

      kCGMouseEventNumber

      Ключ для доступа к целочисленному полю, содержащему номер события кнопки мыши. Соответствие мыши вниз и событий mouseUp будет иметь тот же номер события.

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

    • kCGMouseEventClickState

      kCGMouseEventClickState

      Ключ для доступа к целочисленному полю, содержащему состояние щелчка кнопкой мыши. Состояние щелчка 1 представляет единственный щелчок. Состояние щелчка 2 представляет двойной щелчок. Состояние щелчка 3 представляет тройной щелчок.

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

    • kCGMouseEventPressure

      kCGMouseEventPressure

      Ключ для доступа к двойному полю, содержащему давление кнопки мыши. Значение давления может колебаться от 0 до 1 с 0 представлениями возросшей мыши. Это значение обычно устанавливается перьями планшета, имитирующими мышь.

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

    • kCGMouseEventButtonNumber

      kCGMouseEventButtonNumber

      Ключ для доступа к целочисленному полю, содержащему число кнопки мыши. Для получения информации о возможных значениях посмотрите Кнопки мыши.

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

    • kCGMouseEventDeltaX

      kCGMouseEventDeltaX

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

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

    • kCGMouseEventDeltaY

      kCGMouseEventDeltaY

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

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

    • kCGMouseEventInstantMouser

      kCGMouseEventInstantMouser

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

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

    • kCGMouseEventSubtype

      kCGMouseEventSubtype

      Ключ для доступа к целочисленному полю, кодирующему подтип события от нажатия мыши a kCFNumberIntType.

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

    • kCGKeyboardEventAutorepeat

      kCGKeyboardEventAutorepeat

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

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

    • kCGKeyboardEventKeycode

      kCGKeyboardEventKeycode

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

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

    • kCGKeyboardEventKeyboardType

      kCGKeyboardEventKeyboardType

      Ключ для доступа к целочисленному полю, содержащему идентификатор типа клавиатуры.

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

    • kCGScrollWheelEventDeltaAxis1

      kCGScrollWheelEventDeltaAxis1

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

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

    • kCGScrollWheelEventDeltaAxis2

      kCGScrollWheelEventDeltaAxis2

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

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

    • kCGScrollWheelEventDeltaAxis3

      kCGScrollWheelEventDeltaAxis3

      Это поле не используется.

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

    • kCGScrollWheelEventFixedPtDeltaAxis1

      kCGScrollWheelEventFixedPtDeltaAxis1

      Ключ для доступа к полю, содержащему прокрутку данных. Данные прокрутки представляют основанное на строке или основанное на пикселе изменение в вертикальной позиции начиная с последнего события прокрутки от Могущественного скроллера Мыши или скроллера мыши единственного колеса. Данные прокрутки используют фиксированную точку 16,16 форматов целого числа со знаком. Например, если поле содержит значение 1,0, целое число 0x00010000 возвращается CGEventGetIntegerValueField. Если этот ключ передается CGEventGetDoubleValueField, значение фиксированной точки преобразовывается в двойное значение.

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

    • kCGScrollWheelEventFixedPtDeltaAxis2

      kCGScrollWheelEventFixedPtDeltaAxis2

      Ключ для доступа к полю, содержащему прокрутку данных. Данные прокрутки представляют основанное на строке или основанное на пикселе изменение в горизонтальной позиции начиная с последнего события прокрутки от Могущественного скроллера Мыши. Данные прокрутки используют фиксированную точку 16,16 форматов целого числа со знаком. Например, если поле содержит значение 1,0, целое число 0x00010000 возвращается CGEventGetIntegerValueField. Если этот ключ передается CGEventGetDoubleValueField, значение фиксированной точки преобразовывается в двойное значение.

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

    • kCGScrollWheelEventFixedPtDeltaAxis3

      kCGScrollWheelEventFixedPtDeltaAxis3

      Это поле не используется.

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

    • kCGScrollWheelEventPointDeltaAxis1

      kCGScrollWheelEventPointDeltaAxis1

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

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

    • kCGScrollWheelEventPointDeltaAxis2

      kCGScrollWheelEventPointDeltaAxis2

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

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

    • kCGScrollWheelEventPointDeltaAxis3

      kCGScrollWheelEventPointDeltaAxis3

      Это поле не используется.

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

    • kCGScrollWheelEventInstantMouser

      kCGScrollWheelEventInstantMouser

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

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

    • kCGTabletEventPointX

      kCGTabletEventPointX

      Ключ для доступа к целочисленному полю, содержащему абсолют X координат в пространстве планшета в полном разрешении планшета.

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

    • kCGTabletEventPointY

      kCGTabletEventPointY

      Ключ для доступа к целочисленному полю, содержащему абсолютную координату Y в пространстве планшета в полном разрешении планшета.

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

    • kCGTabletEventPointZ

      kCGTabletEventPointZ

      Ключ для доступа к целочисленному полю, содержащему абсолютную координату Z в пространстве планшета в полном разрешении планшета.

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

    • kCGTabletEventPointButtons

      kCGTabletEventPointButtons

      Ключ для доступа к целочисленному полю, содержащему состояние кнопки планшета. Бит 0 является первой кнопкой, и набор укусил, представляет закрытую или нажатую кнопку. Поддерживаются до 16 кнопок.

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

    • kCGTabletEventPointPressure

      kCGTabletEventPointPressure

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

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

    • kCGTabletEventTiltX

      kCGTabletEventTiltX

      Ключ для доступа к двойному полю, содержащему горизонтальный перьевой наклон планшета. Значение 0,0 не представляет наклона, и 1.0 представляет максимальный наклон.

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

    • kCGTabletEventTiltY

      kCGTabletEventTiltY

      Ключ для доступа к двойному полю, содержащему вертикальный перьевой наклон планшета. Значение 0,0 не представляет наклона, и 1.0 представляет максимальный наклон.

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

    • kCGTabletEventRotation

      kCGTabletEventRotation

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

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

    • kCGTabletEventTangentialPressure

      kCGTabletEventTangentialPressure

      Ключ для доступа к двойному полю, содержащему тангенциальное давление на устройство. Значение 0,0 не представляет давления, и 1.0 представляет максимальное давление.

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

    • kCGTabletEventDeviceID

      kCGTabletEventDeviceID

      Ключ для доступа к целочисленному полю, содержащему присвоенное системе уникальное устройство ID.

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

    • kCGTabletEventVendor1

      kCGTabletEventVendor1

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

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

    • kCGTabletEventVendor2

      kCGTabletEventVendor2

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

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

    • kCGTabletEventVendor3

      kCGTabletEventVendor3

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

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

    • kCGTabletProximityEventVendorID

      kCGTabletProximityEventVendorID

      Ключ для доступа к целочисленному полю, содержащему определенный поставщиками ID, обычно идентификатор поставщика USB.

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

    • kCGTabletProximityEventTabletID

      kCGTabletProximityEventTabletID

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

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

    • kCGTabletProximityEventPointerID

      kCGTabletProximityEventPointerID

      Ключ для доступа к целочисленному полю, содержащему определенный поставщиками ID манипулятора.

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

    • kCGTabletProximityEventDeviceID

      kCGTabletProximityEventDeviceID

      Ключ для доступа к целочисленному полю, содержащему присвоенное системе устройство ID.

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

    • kCGTabletProximityEventSystemTabletID

      kCGTabletProximityEventSystemTabletID

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

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

    • kCGTabletProximityEventVendorPointerType

      kCGTabletProximityEventVendorPointerType

      Ключ для доступа к целочисленному полю, содержащему присвоенный поставщиками тип указателя.

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

    • kCGTabletProximityEventVendorPointerSerialNumber

      kCGTabletProximityEventVendorPointerSerialNumber

      Ключ для доступа к целочисленному полю, содержащему определенный поставщиками порядковый номер указателя.

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

    • kCGTabletProximityEventVendorUniqueID

      kCGTabletProximityEventVendorUniqueID

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

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

    • kCGTabletProximityEventCapabilityMask

      kCGTabletProximityEventCapabilityMask

      Ключ для доступа к целочисленному полю, содержащему маску функций устройств.

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

    • kCGTabletProximityEventPointerType

      kCGTabletProximityEventPointerType

      Ключ для доступа к целочисленному полю, содержащему тип указателя.

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

    • kCGTabletProximityEventEnterProximity

      kCGTabletProximityEventEnterProximity

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

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

    • kCGEventTargetProcessSerialNumber

      kCGEventTargetProcessSerialNumber

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

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

    • kCGEventTargetUnixProcessID

      kCGEventTargetUnixProcessID

      Ключ для доступа к полю, содержащему событие, предназначается для процесса Unix ID.

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

    • kCGEventSourceUnixProcessID

      kCGEventSourceUnixProcessID

      Ключ для доступа к полю, содержащему источник события процесс Unix ID.

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

    • kCGEventSourceUserData

      kCGEventSourceUserData

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

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

    • kCGEventSourceUserID

      kCGEventSourceUserID

      Ключ для доступа к полю, содержащему источник события Unix эффективный UID.

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

    • kCGEventSourceGroupID

      kCGEventSourceGroupID

      Ключ для доступа к полю, содержащему источник события Unix эффективный GID.

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

    • kCGEventSourceStateID

      kCGEventSourceStateID

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

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

    • kCGScrollWheelEventIsContinuous

      kCGScrollWheelEventIsContinuous

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

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

    Обсуждение

    Эти константы используются в качестве ключей для доступа к определенным специализированным полям события при использовании низкоуровневых функций средства доступа такой как CGEventGetIntegerValueField, CGEventSetIntegerValueField, CGEventGetDoubleValueField, и CGEventSetDoubleValueField.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Маски фильтра события

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

    Объявление

    Swift

    typealias CGEventFilterMask = UInt32

    Objective C

    enum CGEventFilterMask { kCGEventFilterMaskPermitLocalMouseEvents = 0x00000001, kCGEventFilterMaskPermitLocalKeyboardEvents = 0x00000002, kCGEventFilterMaskPermitSystemDefinedEvents = 0x00000004, kCGEventFilterMaskPermitAllEvents = kCGEventFilterMaskPermitLocalMouseEvents | kCGEventFilterMaskPermitLocalKeyboardEvents | kCGEventFilterMaskPermitSystemDefinedEvents }; typedef uint32_t CGEventFilterMask;

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Флаги события

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

    Объявление

    Swift

    typealias CGEventFlags = UInt64

    Objective C

    enum _CGEventFlags { kCGEventFlagMaskAlphaShift = NX_ALPHASHIFTMASK, kCGEventFlagMaskShift = NX_SHIFTMASK, kCGEventFlagMaskControl = NX_CONTROLMASK, kCGEventFlagMaskAlternate = NX_ALTERNATEMASK, kCGEventFlagMaskCommand = NX_COMMANDMASK, kCGEventFlagMaskHelp = NX_HELPMASK, kCGEventFlagMaskSecondaryFn = NX_SECONDARYFNMASK, kCGEventFlagMaskNumericPad = NX_NUMERICPADMASK, kCGEventFlagMaskNonCoalesced = NX_NONCOALSESCEDMASK }; typedef uint64_t CGEventFlags;

    Константы

    • kCGEventFlagMaskAlphaShift

      kCGEventFlagMaskAlphaShift

      Указывает, что клавиша Caps Lock снижается для клавиатуры, мыши или измененного на флаг события.

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

    • kCGEventFlagMaskShift

      kCGEventFlagMaskShift

      Указывает, что клавиша Shift снижается для клавиатуры, мыши или измененного на флаг события.

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

    • kCGEventFlagMaskControl

      kCGEventFlagMaskControl

      Указывает, что Клавиша CTRL снижается для клавиатуры, мыши или измененного на флаг события.

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

    • kCGEventFlagMaskAlternate

      kCGEventFlagMaskAlternate

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

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

    • kCGEventFlagMaskCommand

      kCGEventFlagMaskCommand

      Указывает, что Командная клавиша снижается для клавиатуры, мыши или измененного на флаг события.

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

    • kCGEventFlagMaskHelp

      kCGEventFlagMaskHelp

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

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

    • kCGEventFlagMaskSecondaryFn

      kCGEventFlagMaskSecondaryFn

      Указывает, что ключ Fn (Function) снижается для клавиатуры, мыши или измененного на флаг события. Этот ключ найден прежде всего на клавиатурах ноутбука.

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

    • kCGEventFlagMaskNumericPad

      kCGEventFlagMaskNumericPad

      Идентифицирует ключевые события от области цифровой клавиатуры на расширенных клавиатурах.

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

    • kCGEventFlagMaskNonCoalesced

      kCGEventFlagMaskNonCoalesced

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

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

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Состояния источника события

    Константы, указывающие возможные исходные состояния источника события.

    Объявление

    Swift

    typealias CGEventSourceStateID = UInt32

    Objective C

    enum { kCGEventSourceStatePrivate = -1, kCGEventSourceStateCombinedSessionState = 0, kCGEventSourceStateHIDSystemState = 1 }; typedef uint32_t CGEventSourceStateID;

    Константы

    • kCGEventSourceStatePrivate

      kCGEventSourceStatePrivate

      Указывает, что источник события должен использовать частную таблицу состояния события.

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

    • kCGEventSourceStateCombinedSessionState

      kCGEventSourceStateCombinedSessionState

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

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

    • kCGEventSourceStateHIDSystemState

      kCGEventSourceStateHIDSystemState

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

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

    Обсуждение

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

    Определяются две существующих ранее таблицы состояния события:

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

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

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Маркер источника события

    Указывает любой входной тип события.

    Объявление

    Objective C

    #define kCGAnyInputEventType ((CGEventType)(~0))

    Константы

    • kCGAnyInputEventType

      kCGAnyInputEventType

      Константа, указывающая любой входной тип события.

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

    Обсуждение

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

  • Состояния утаивания события

    Укажите состояния утаивания события, которые могут произойти после регистрации события.

    Объявление

    Swift

    typealias CGEventSuppressionState = UInt32

    Objective C

    enum CGEventSuppressionState { kCGEventSuppressionStateSuppressionInterval = 0, kCGEventSuppressionStateRemoteMouseDrag = 1, kCGNumberOfEventSuppressionStates = 2 }; typedef uint32_t CGEventSuppressionState;

    Константы

    • kCGEventSuppressionStateSuppressionInterval

      kCGEventSuppressionStateSuppressionInterval

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

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

    • kCGEventSuppressionStateRemoteMouseDrag

      kCGEventSuppressionStateRemoteMouseDrag

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

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

    Обсуждение

    Эти константы указывают типы интервалов утаивания события, во время которых фильтр события применяется после регистрации события.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Расположения касания события

    Константы, указывающие возможные точки ответвления для событий.

    Объявление

    Swift

    typealias CGEventTapLocation = UInt32

    Objective C

    enum _CGEventTapLocation { kCGHIDEventTap = 0, kCGSessionEventTap, kCGAnnotatedSessionEventTap }; typedef uint32_t CGEventTapLocation;

    Константы

    • kCGHIDEventTap

      kCGHIDEventTap

      Указывает, что касание события помещается в точку, где системные события HID вводят сервер окна.

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

    • kCGSessionEventTap

      kCGSessionEventTap

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

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

    • kCGAnnotatedSessionEventTap

      kCGAnnotatedSessionEventTap

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

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

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Опции касания события

    Константы, указывающие, является ли новое касание события активным фильтром или пассивным слушателем.

    Объявление

    Swift

    typealias CGEventTapOptions = UInt32

    Objective C

    enum _CGEventTapOptions { kCGEventTapOptionDefault = 0x00000000, kCGEventTapOptionListenOnly = 0x00000001 }; typedef uint32_t CGEventTapOptions;

    Константы

    • kCGEventTapOptionDefault

      kCGEventTapOptionDefault

      Указывает, что новое касание события является активным фильтром. (Приложения, предназначающиеся для OS X v10.4, должны использовать литеральное значение для создания активного касания события фильтра, поскольку эта константа была опущена от заголовка.)

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

    • kCGEventTapOptionListenOnly

      kCGEventTapOptionListenOnly

      Указывает, что новое касание события является пассивным слушателем.

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

    Обсуждение

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Размещение касания события

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

    Объявление

    Swift

    typealias CGEventTapPlacement = UInt32

    Objective C

    enum _CGEventTapPlacement { kCGHeadInsertEventTap = 0, kCGTailAppendEventTap }; typedef uint32_t CGEventTapPlacement;

    Константы

    • kCGHeadInsertEventTap

      kCGHeadInsertEventTap

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

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

    • kCGTailAppendEventTap

      kCGTailAppendEventTap

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

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

    Обсуждение

    Касания события могут быть вставлены в указанном расположении во главе существующих ранее фильтров или добавлены после любых существующих ранее фильтров.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Типы событий

    Константы, указывающие различные типы входных событий.

    Объявление

    Swift

    typealias CGEventType = UInt32

    Objective C

    enum _CGEventType { kCGEventNull = NX_NULLEVENT, kCGEventLeftMouseDown = NX_LMOUSEDOWN, kCGEventLeftMouseUp = NX_LMOUSEUP, kCGEventRightMouseDown = NX_RMOUSEDOWN, kCGEventRightMouseUp = NX_RMOUSEUP, kCGEventMouseMoved = NX_MOUSEMOVED, kCGEventLeftMouseDragged = NX_LMOUSEDRAGGED, kCGEventRightMouseDragged = NX_RMOUSEDRAGGED, kCGEventKeyDown = NX_KEYDOWN, kCGEventKeyUp = NX_KEYUP, kCGEventFlagsChanged = NX_FLAGSCHANGED, kCGEventScrollWheel = NX_SCROLLWHEELMOVED, kCGEventTabletPointer = NX_TABLETPOINTER, kCGEventTabletProximity = NX_TABLETPROXIMITY, kCGEventOtherMouseDown = NX_OMOUSEDOWN, kCGEventOtherMouseUp = NX_OMOUSEUP, kCGEventOtherMouseDragged = NX_OMOUSEDRAGGED, kCGEventTapDisabledByTimeout = 0xFFFFFFFE, kCGEventTapDisabledByUserInput = 0xFFFFFFFF }; typedef uint32_t CGEventType;

    Константы

    • kCGEventNull

      kCGEventNull

      Указывает нулевое событие.

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

    • kCGEventLeftMouseDown

      kCGEventLeftMouseDown

      Указывает мышь вниз событие с левой кнопкой.

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

    • kCGEventLeftMouseUp

      kCGEventLeftMouseUp

      Указывает мышь событие с левой кнопкой.

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

    • kCGEventRightMouseDown

      kCGEventRightMouseDown

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

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

    • kCGEventRightMouseUp

      kCGEventRightMouseUp

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

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

    • kCGEventMouseMoved

      kCGEventMouseMoved

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

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

    • kCGEventLeftMouseDragged

      kCGEventLeftMouseDragged

      Указывает, что мышь перетаскивает событие со сниженной кнопкой.

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

    • kCGEventRightMouseDragged

      kCGEventRightMouseDragged

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

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

    • kCGEventKeyDown

      kCGEventKeyDown

      Указывает ключ вниз событие.

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

    • kCGEventKeyUp

      kCGEventKeyUp

      Указывает ключ событие.

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

    • kCGEventFlagsChanged

      kCGEventFlagsChanged

      Указывает, что ключ изменил событие для ключа состояния или модификатора.

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

    • kCGEventScrollWheel

      kCGEventScrollWheel

      Указывает, что колесико прокрутки переместило событие.

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

    • kCGEventTabletPointer

      kCGEventTabletPointer

      Указывает событие указателя планшета.

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

    • kCGEventTabletProximity

      kCGEventTabletProximity

      Указывает событие близости планшета.

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

    • kCGEventOtherMouseDown

      kCGEventOtherMouseDown

      Указывает мышь вниз событие с одной из кнопок 2-31.

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

    • kCGEventOtherMouseUp

      kCGEventOtherMouseUp

      Указывает мышь событие с одной из кнопок 2-31.

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

    • kCGEventOtherMouseDragged

      kCGEventOtherMouseDragged

      Указывает, что мышь перетаскивает событие с одной из кнопок 2-31 вниз.

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

    • kCGEventTapDisabledByTimeout

      kCGEventTapDisabledByTimeout

      Указывает событие, указывающее, что касание события отключено из-за тайм-аута.

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

    • kCGEventTapDisabledByUserInput

      kCGEventTapDisabledByUserInput

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

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

    Обсуждение

    Эти константы используются:

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

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Маска типа события

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

    Объявление

    Objective C

    #define kCGEventMaskForAllEvents (~(CGEventMask)0)

    Константы

    • kCGEventMaskForAllEvents

      kCGEventMaskForAllEvents

      Маска события, указывающая все типы событий.

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

    Обсуждение

    Эта константа обычно используется с функциями CGEventTapCreate и CGEventTapCreateForPSN зарегистрировать касание события, наблюдающее все входные события.

  • Кнопки мыши

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

    Объявление

    Swift

    typealias CGMouseButton = UInt32

    Objective C

    enum _CGMouseButton { kCGMouseButtonLeft = 0, kCGMouseButtonRight = 1, kCGMouseButtonCenter = 2 }; typedef uint32_t CGMouseButton;

    Константы

    • kCGMouseButtonLeft

      kCGMouseButtonLeft

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

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

    • kCGMouseButtonRight

      kCGMouseButtonRight

      Указывает правую кнопку мыши на мыши с тремя кнопками или с двумя кнопками.

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

    • kCGMouseButtonCenter

      kCGMouseButtonCenter

      Указывает центральную кнопку мыши на мыши с тремя кнопками.

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

    Обсуждение

    Кварц поддерживает до 32 кнопок мыши. Первые три кнопки указаны с помощью этих трех констант. Дополнительные кнопки указаны в порядке USB с помощью целых чисел 3 - 31.

    Эти константы используются:

    • В функции CGEventCreateMouseEvent для указания кнопки, это изменяет состояние.

    • В функции CGEventSourceButtonState для указания кнопки, это тестируется.

    • Указать значение kCGMouseEventButtonNumber поле события при изменении события.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Подтипы мыши

    Константы, используемые с kCGMouseEventSubtype поле события.

    Объявление

    Swift

    typealias CGEventMouseSubtype = UInt32

    Objective C

    enum _CGEventMouseSubtype { kCGEventMouseSubtypeDefault = 0, kCGEventMouseSubtypeTabletPoint = 1, kCGEventMouseSubtypeTabletProximity = 2 }; typedef uint32_t CGEventMouseSubtype;

    Константы

    • kCGEventMouseSubtypeDefault

      kCGEventMouseSubtypeDefault

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

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

    • kCGEventMouseSubtypeTabletPoint

      kCGEventMouseSubtypeTabletPoint

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

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

    • kCGEventMouseSubtypeTabletProximity

      kCGEventMouseSubtypeTabletProximity

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

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

    Обсуждение

    Планшеты могут генерировать специально аннотируемые события от нажатия мыши, содержащие значения, связанные с kCGMouseEventSubtype поле события. Чтобы изучить, как установить эти значения, посмотрите функцию CGEventSetIntegerValueField.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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

  • Прокрутка модулей события

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

    Объявление

    Swift

    typealias CGScrollEventUnit = UInt32

    Objective C

    enum { kCGScrollEventUnitPixel = 0, kCGScrollEventUnitLine = 1 }; typedef uint32_t CGScrollEventUnit;

    Константы

    • kCGScrollEventUnitPixel

      kCGScrollEventUnitPixel

      Указывает, что единица измерения является пикселями.

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

    • kCGScrollEventUnitLine

      kCGScrollEventUnitLine

      Указывает, что единица измерения является строками.

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

    Обсуждение

    Можно передать одну из этих констант к функции CGEventCreateScrollWheelEvent указать единицу измерения для события. Константа kCGScrollEventUnitPixel производит событие, которое большинство приложений интерпретирует как гладкое событие прокрутки. По умолчанию масштаб составляет приблизительно десять пикселей за строку. Можно изменить масштаб с функцией CGEventSourceSetPixelsPerLine.

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

    Objective C

    @import CoreGraphics;

    Swift

    import CoreGraphics

    Доступность

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