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

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

Разработчик

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

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

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

NSPanGestureRecognizer

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

После создания устройство распознавания жеста сконфигурировано для распознавания жестов панорамирования, включающих только основную кнопку. Это также задерживает передающие основные события кнопки к представлению путем установки delaysPrimaryMouseButtonEvents свойство к YEStrue. Для изменения набора кнопок для отслеживания измените buttonMask свойство.

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

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

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

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

Swift

import AppKit

Objective C

@import AppKit;

Доступность

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

Конфигурирование устройства распознавания жеста
  • buttonMask buttonMask Свойство

    Немного маски кнопки (или кнопок) требуемый распознать этот жест.

    Объявление

    Swift

    var buttonMask: Int

    Objective C

    @property NSUInteger buttonMask

    Обсуждение

    Бит 0 представляет основную кнопку, бит 1 является вторичной кнопкой и т.д. Таким образом для отслеживания щелчков вторичной кнопки присвойте значение 0x2 (который соответствует a 1 в бите 1) к этому свойству. Значение по умолчанию этого свойства является 0x1, обнаруживающим щелчки в основной кнопке мыши.

    Изменение значения этого свойства также устанавливает значения delaysPrimaryMouseButtonEvents, delaysSecondaryMouseButtonEvents, и delaysOtherMouseButtonEvents свойства к YEStrue для каждой из кнопок Вы указали.

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

Отслеживание расположения и скорости жеста
  • translationInView (_:) - translationInView:

    Расстояние переместилось мышью во время жеста.

    Объявление

    Swift

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

    Objective C

    - (NSPoint)translationInView:(NSView *)view

    Параметры

    view

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

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

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

    См. также

    – locationInView:

  • setTranslation (_: inView:) - setTranslation:inView:

    Изменяет текущее значение перевода устройства распознавания жеста.

    Объявление

    Swift

    func setTranslation(_ translation: NSPoint, inView view: NSView?)

    Objective C

    - (void)setTranslation:(NSPoint)translation inView:(NSView *)view

    Параметры

    translation

    Новые значения перевода для использования в устройстве распознавания жеста.

    view

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

    Обсуждение

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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

  • velocityInView (_:) - velocityInView:

    Скорость панорамирования, измеренного в точках в секунду.

    Объявление

    Swift

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

    Objective C

    - (NSPoint)velocityInView:(NSView *)view

    Параметры

    view

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

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

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

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

    Objective C

    @import AppKit;

    Swift

    import AppKit

    Доступность

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