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

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

Разработчик

Ссылка платформы AppKit ссылка класса NSGestureRecognizer

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

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

NSGestureRecognizer

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

Конкретные подклассы NSGestureRecognizer следующее:

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

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

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

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

Swift

  • func handleGesture() { }
  • func handleGesture(gestureRecognizer: NSGestureRecognizer) { }

Objective C

  • - (void)handleGesture;
  • - (void)handleGesture:(NSGestureRecognizer *)gestureRecognizer;

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

Изменения состояния

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

Дискретный переход жестов от Возможного состояния непосредственно к Распознанному (NSGestureRecognizerStateRecognized) или Неработающий (NSGestureRecognizerStateFailed) состояние, в зависимости от того, интерпретируют ли они успешно жест. Когда дискретное устройство распознавания жеста переходит к Распознанному состоянию, оно вызывает метод действия своего целевого объекта.

Для непрерывных жестов изменения состояния следующие:

  • Возможный —> Начался —> [Измененный] —> Отмененный

  • Возможный —> Начался —> [Измененный] —> Законченный

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

Для списка возможных состояний посмотрите константы в NSGestureRecognizerState.

Разделение на подклассы примечаний

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

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

Методы для переопределения

При создании собственного подкласса устройства распознавания жеста:

  • Реализуйте reset метод и любые другие соответствующие методы в Методах для Подклассов.

  • Переопределите locationInView: метод по мере необходимости для указания надлежащей точки для жеста.

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

Альтернативы разделению на подклассы

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

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

Наследование

Соответствует

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Инициализация устройства распознавания жеста
  • init (target:action:) - initWithTarget:action: Определяемый инициализатор

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

    Объявление

    Swift

    init(target target: AnyObject, action action: Selector)

    Objective C

    - (instancetype)initWithTarget:(id)target action:(SEL)action

    Параметры

    target

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

    action

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

    Swift

    • func handleGesture() { }
    • func handleGesture(gestureRecognizer: NSGestureRecognizer) { }

    Objective C

    • - (void)handleGesture;
    • - (void)handleGesture:(NSGestureRecognizer *)gestureRecognizer;

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

    Инициализированное устройство распознавания жеста возражает или nil если произошла ошибка.

    Обсуждение

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

    Этот метод записывает указанное target и action значения и подготавливают устройство распознавания жеста к использованию.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    действие
    цель

Доступ к Target и действию
  • действие действие Свойство

    Метод действия вызвать, когда распознан жест.

    Объявление

    Swift

    var action: Selector

    Objective C

    @property SEL action

    Обсуждение

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

    Подпись этого метода должна быть одним из следующего:

    Swift

    • func handleGesture() { }
    • func handleGesture(gestureRecognizer: NSGestureRecognizer) { }

    Objective C

    • - (void)handleGesture;
    • - (void)handleGesture:(NSGestureRecognizer *)gestureRecognizer;

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    цель

  • цель цель Свойство

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

    Объявление

    Swift

    weak var target: AnyObject?

    Objective C

    @property(weak) id target

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    действие

Получение расположения событий
  • locationInView (_:) - locationInView:

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

    Объявление

    Swift

    func locationInView(_ view: NSView?) -> NSPoint

    Objective C

    - (NSPoint)locationInView:(NSView *)view

    Параметры

    view

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

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

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

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Доступ к состоянию устройства распознавания
  • состояние состояние Свойство

    Текущее состояние устройства распознавания жеста. (только для чтения)

    Объявление

    Swift

    var state: NSGestureRecognizerState

    Objective C

    @property(readonly) NSGestureRecognizerState state

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • представление представление Свойство

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

    Объявление

    Swift

    var view: NSView? { get }

    Objective C

    @property(readonly) NSView *view

    Обсуждение

    Для присоединения устройства распознавания жеста к представлению вызовите addGestureRecognizer: метод представления. Если устройство распознавания жеста не присоединено к представлению, значение в этом свойстве nil.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – locationInView:

  • включенный включенный Свойство

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

    Объявление

    Swift

    var enabled: Bool

    Objective C

    @property(getter=isEnabled) BOOL enabled

    Обсуждение

    Когда значение этого свойства YEStrue, когда его жест выполняется, устройство распознавания жеста получает события и использует их для определения. Когда значение NOfalse, устройство распознавания жеста не получает события. Изменение значения от YEStrue к NOfalse в то время как устройство распознавания жеста находится в процессе распознавания, что жест изменяет состояние устройства распознавания жеста к NSGestureRecognizerStateCancelled.

    Значение по умолчанию этого свойства YEStrue.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Задержка событий
  • delaysPrimaryMouseButtonEvents delaysPrimaryMouseButtonEvents Свойство

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

    Объявление

    Swift

    var delaysPrimaryMouseButtonEvents: Bool

    Objective C

    @property BOOL delaysPrimaryMouseButtonEvents

    Обсуждение

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

    Значение по умолчанию этого свойства NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • delaysSecondaryMouseButtonEvents delaysSecondaryMouseButtonEvents Свойство

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

    Объявление

    Swift

    var delaysSecondaryMouseButtonEvents: Bool

    Objective C

    @property BOOL delaysSecondaryMouseButtonEvents

    Обсуждение

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

    Значение по умолчанию этого свойства NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • delaysOtherMouseButtonEvents delaysOtherMouseButtonEvents Свойство

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

    Объявление

    Swift

    var delaysOtherMouseButtonEvents: Bool

    Objective C

    @property BOOL delaysOtherMouseButtonEvents

    Обсуждение

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

    Значение по умолчанию этого свойства NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • delaysKeyEvents delaysKeyEvents Свойство

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

    Объявление

    Swift

    var delaysKeyEvents: Bool

    Objective C

    @property BOOL delaysKeyEvents

    Обсуждение

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

    Значение по умолчанию этого свойства NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • delaysMagnificationEvents delaysMagnificationEvents Свойство

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

    Объявление

    Swift

    var delaysMagnificationEvents: Bool

    Objective C

    @property BOOL delaysMagnificationEvents

    Обсуждение

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

    Значение по умолчанию этого свойства NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • delaysRotationEvents delaysRotationEvents Свойство

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

    Объявление

    Swift

    var delaysRotationEvents: Bool

    Objective C

    @property BOOL delaysRotationEvents

    Обсуждение

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

    Значение по умолчанию этого свойства NOfalse.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Доступ к делегату
  • делегат делегат Свойство

    Делегат устройства распознавания жеста.

    Объявление

    Swift

    weak var delegate: NSGestureRecognizerDelegate?

    Objective C

    @property(weak) id< NSGestureRecognizerDelegate > delegate

    Обсуждение

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

    Делегат должен реализовать NSGestureRecognizerDelegate протокол.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Методы для подклассов
  • сброс () - сброс

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

    Объявление

    Swift

    func reset()

    Objective C

    - (void)reset

    Обсуждение

    AppKit вызывает этот метод после того, как состояние устройства распознавания жеста было установлено в любое из терминальных состояний: NSGestureRecognizerStateEnded, NSGestureRecognizerStateCancelled, NSGestureRecognizerStateFailed, или NSGestureRecognizerStateRecognized. Подклассы должны переопределить этот метод и использовать его для сброса любого внутреннего состояния устройства распознавания жеста в подготовке к новой попытке распознавания. После того, как этот метод вызывают, устройство распознавания жеста не получает дальнейших обновлений для событий, начавшихся, но еще не закончившихся.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • mouseDown (_:) - mouseDown:

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

    Объявление

    Swift

    func mouseDown(_ event: NSEvent)

    Objective C

    - (void)mouseDown:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о событии mouseDown.

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Использование этот метод, чтобы начать отслеживать жест любым способом является надлежащим.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • mouseDragged (_:) - mouseDragged:

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

    Объявление

    Swift

    func mouseDragged(_ event: NSEvent)

    Objective C

    - (void)mouseDragged:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о перетащенном мышью событии.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • mouseUp (_:) - mouseUp:

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

    Объявление

    Swift

    func mouseUp(_ event: NSEvent)

    Objective C

    - (void)mouseUp:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о событии mouseUp.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • otherMouseDown (_:) - otherMouseDown:

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

    Объявление

    Swift

    func otherMouseDown(_ event: NSEvent)

    Objective C

    - (void)otherMouseDown:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о событии mouseDown.

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Использование этот метод, чтобы начать отслеживать жест любым способом является надлежащим.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • otherMouseDragged (_:) - otherMouseDragged:

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

    Объявление

    Swift

    func otherMouseDragged(_ event: NSEvent)

    Objective C

    - (void)otherMouseDragged:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о перетащенном мышью событии.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • otherMouseUp (_:) - otherMouseUp:

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

    Объявление

    Swift

    func otherMouseUp(_ event: NSEvent)

    Objective C

    - (void)otherMouseUp:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о событии mouseUp.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • rightMouseDown (_:) - rightMouseDown:

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

    Объявление

    Swift

    func rightMouseDown(_ event: NSEvent)

    Objective C

    - (void)rightMouseDown:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о событии mouseDown.

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Использование этот метод, чтобы начать отслеживать жест любым способом является надлежащим.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • rightMouseDragged (_:) - rightMouseDragged:

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

    Объявление

    Swift

    func rightMouseDragged(_ event: NSEvent)

    Objective C

    - (void)rightMouseDragged:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о перетащенном мышью событии.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • rightMouseUp (_:) - rightMouseUp:

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

    Объявление

    Swift

    func rightMouseUp(_ event: NSEvent)

    Objective C

    - (void)rightMouseUp:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о событии mouseUp.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • magnifyWithEvent (_:) - magnifyWithEvent:

    Сообщает устройству распознавания жеста, что пользователь выполняет жест повышения.

    Объявление

    Swift

    func magnifyWithEvent(_ event: NSEvent)

    Objective C

    - (void)magnifyWithEvent:(NSEvent *)event

    Параметры

    event

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

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Использование этот метод, чтобы начать отслеживать жест любым способом является надлежащим.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • rotateWithEvent (_:) - rotateWithEvent:

    Сообщает устройству распознавания жеста, что пользователь выполняет жест вращения.

    Объявление

    Swift

    func rotateWithEvent(_ event: NSEvent)

    Objective C

    - (void)rotateWithEvent:(NSEvent *)event

    Параметры

    event

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

    Обсуждение

    Реализация по умолчанию этого метода ничего не делает. Использование этот метод, чтобы начать отслеживать жест любым способом является надлежащим.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • canBePreventedByGestureRecognizer (_:) - canBePreventedByGestureRecognizer:

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

    Объявление

    Swift

    func canBePreventedByGestureRecognizer(_ preventingGestureRecognizer: NSGestureRecognizer) -> Bool

    Objective C

    - (BOOL)canBePreventedByGestureRecognizer:(NSGestureRecognizer *)preventingGestureRecognizer

    Параметры

    preventingGestureRecognizer

    Устройство распознавания жеста, которое может препятствовать текущему объекту распознать его жест.

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

    YEStrue указать это preventingGestureRecognizer может блокировать текущее устройство распознавания жеста от распознавания его жеста, или NOfalse если оба устройства распознавания жеста могут работать одновременно.

    Обсуждение

    Этот метод включает подобное поведение как gestureRecognizerShouldBegin: и gestureRecognizer:shouldRequireFailureOfGestureRecognizer: методы делегата устройства распознавания жеста. Используя этот метод позволяет Вам определить правила, применяющиеся ко всем экземплярам Вашего пользовательского класса устройства распознавания жеста. Например, устройство распознавания жеста данного класса могло бы хотеть препятствовать тому, чтобы экземпляры того же класса распознали одновременно.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • canPreventGestureRecognizer (_:) - canPreventGestureRecognizer:

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

    Объявление

    Swift

    func canPreventGestureRecognizer(_ preventedGestureRecognizer: NSGestureRecognizer) -> Bool

    Objective C

    - (BOOL)canPreventGestureRecognizer:(NSGestureRecognizer *)preventedGestureRecognizer

    Параметры

    preventedGestureRecognizer

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

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

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

    Обсуждение

    Этот метод включает подобное поведение как gestureRecognizerShouldBegin: и gestureRecognizer:shouldRequireFailureOfGestureRecognizer: методы делегата устройства распознавания жеста. Используя этот метод позволяет Вам определить правила, применяющиеся ко всем экземплярам Вашего пользовательского класса устройства распознавания жеста. Например, NSClickGestureRecognizer объект не предотвращает другого NSClickGestureRecognizer объект более высоким щелчком рассчитывает от распознавания его жеста.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • shouldBeRequiredToFailByGestureRecognizer (_:) - shouldBeRequiredToFailByGestureRecognizer:

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

    Объявление

    Swift

    func shouldBeRequiredToFailByGestureRecognizer(_ otherGestureRecognizer: NSGestureRecognizer) -> Bool

    Objective C

    - (BOOL)shouldBeRequiredToFailByGestureRecognizer:(NSGestureRecognizer *)otherGestureRecognizer

    Параметры

    otherGestureRecognizer

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

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

    YEStrue вызвать otherGestureRecognizer ожидать до текущих объектных сбоев прежде, чем начать его собственное распознавание жеста.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • shouldRequireFailureOfGestureRecognizer (_:) - shouldRequireFailureOfGestureRecognizer:

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

    Объявление

    Swift

    func shouldRequireFailureOfGestureRecognizer(_ otherGestureRecognizer: NSGestureRecognizer) -> Bool

    Objective C

    - (BOOL)shouldRequireFailureOfGestureRecognizer:(NSGestureRecognizer *)otherGestureRecognizer

    Параметры

    otherGestureRecognizer

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

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

    YEStrue вызвать текущий объект ожидать для распознавания его собственного жеста до объекта в сбоях otherGestureRecognizer.

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • keyDown (_:) - keyDown:

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

    Объявление

    Swift

    func keyDown(_ event: NSEvent)

    Objective C

    - (void)keyDown:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о ключевом вниз событии.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • keyUp (_:) - keyUp:

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

    Объявление

    Swift

    func keyUp(_ event: NSEvent)

    Objective C

    - (void)keyUp:(NSEvent *)event

    Параметры

    event

    Информация об инкапсуляции объекта о ключевом событии.

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • tabletPoint (_:) - tabletPoint:

    Сообщает пользователю, что событие точки планшета имело место.

    Объявление

    Swift

    func tabletPoint(_ event: NSEvent)

    Objective C

    - (void)tabletPoint:(NSEvent *)event

    Параметры

    event

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

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • flagsChanged (_:) - flagsChanged:

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

    Объявление

    Swift

    func flagsChanged(_ event: NSEvent)

    Objective C

    - (void)flagsChanged:(NSEvent *)event

    Параметры

    event

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

    Обсуждение

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Константы
  • NSGestureRecognizerState

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

    Объявление

    Swift

    enum NSGestureRecognizerState : Int { case Possible case Began case Changed case Ended case Cancelled case Failed }

    Objective C

    typedef enum NSGestureRecognizerState : NSInteger { NSGestureRecognizerStatePossible, NSGestureRecognizerStateBegan, NSGestureRecognizerStateChanged, NSGestureRecognizerStateEnded, NSGestureRecognizerStateCancelled, NSGestureRecognizerStateFailed, NSGestureRecognizerStateRecognized = NSGestureRecognizerStateEnded } NSGestureRecognizerState;

    Константы

    • Possible

      NSGestureRecognizerStatePossible

      Устройство распознавания жеста еще не распознало свой жест, но может оценивать события. Это - состояние по умолчанию.

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

    • Began

      NSGestureRecognizerStateBegan

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

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

    • Changed

      NSGestureRecognizerStateChanged

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

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

    • Ended

      NSGestureRecognizerStateEnded

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

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

    • Cancelled

      NSGestureRecognizerStateCancelled

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

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

    • Failed

      NSGestureRecognizerStateFailed

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

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

    • NSGestureRecognizerStateRecognized

      NSGestureRecognizerStateRecognized

      Устройство распознавания жеста успешно распознало свой жест. Это вызывает свой метод действия в следующем цикле цикла выполнения и сбрасывает его состояние к NSGestureRecognizerStatePossible.

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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