Тип QML MultiPointTouchArea

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

• Список всех членов, включая унаследованные

Свойства

• maximumTouchPoints : int
• minimumTouchPoints : int
• mouseEnabled : bool
• touchPoints : список<TouchPoint>

Сигналы

• canceled(список<TouchPoint> touchPoints)
• gestureStarted(GestureEvent gesture)
• pressed(список<TouchPoint> touchPoints)
• released(список<TouchPoint> touchPoints)
• touchUpdated(список<TouchPoint> touchPoints)
• updated(список<TouchPoint> touchPoints)

Подробное описание

MultiPointTouchArea — это невидимый элемент, используемый для отслеживания нескольких точек касания.

Свойство Item::enabled используется для включения и отключения обработки касаний. При отключении область касания становится прозрачной для событий мыши и касания.

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

MultiPointTouchArea может использоваться двумя способами:

• устанавливая touchPoints для предоставления объектов точек касания со свойствами, которые могут быть привязаны к ним
• используя обработчики onTouchUpdated или onPressed, onUpdated и onReleased

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

См. также TouchPoint.

Документация по свойствам

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

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

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

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

mouseEnabled : bool

Это свойство контролирует, будет ли MultiPointTouchArea также обрабатывать события мыши. Если оно имеет значение true (по умолчанию), область касания будет рассматривать мышь как одиночную точку касания; если оно имеет значение false, область касания будет игнорировать события мыши и позволит им «проходить сквозь» так, чтобы они могли обрабатываться другими элементами ниже.

touchPoints : список<TouchPoint>

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

Если mouseEnabled имеет значение true (по умолчанию), и левая кнопка мыши нажата, а мышь находится над областью касания, текущее положение мыши будет одной из этих точек касания.

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

import QtQuick 2.0

Rectangle {
    width: 400; height: 400
    MultiPointTouchArea {
        anchors.fill: parent
        touchPoints: [
            TouchPoint { id: point1 },
            TouchPoint { id: point2 }
        ]
    }

    Rectangle {
        width: 30; height: 30
        color: "green"
        x: point1.x
        y: point1.y
    }

    Rectangle {
        width: 30; height: 30
        color: "yellow"
        x: point2.x
        y: point2.y
    }
}

По умолчанию это свойство содержит пустой список.

См. также TouchPoint.

Документация по сигналам

canceled(список<TouchPoint> touchPoints)

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

Этот сигнал предназначен для расширенного использования: он полезен, когда более одного MultiPointTouchArea обрабатывает входные данные или когда MultiPointTouchArea находится внутри Flickable. В последнем случае, если вы выполните некоторый логический код в обработчике сигнала onPressed и затем начнете перетаскивание, Flickable может украсть обработку касания у MultiPointTouchArea. В этих случаях, чтобы сбросить логику, когда MultiPointTouchArea потерял обработку касания для Flickable, canceled следует обрабатывать дополнительно к released.

touchPoints — это список отмененных точек.

Примечание: Соответствующий обработчик — onCanceled.

gestureStarted(GestureEvent gesture)

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

Этот сигнал обычно используется, когда MultiPointTouchArea был вложен в Flickable или другой MultiPointTouchArea. Когда порог достигнут и сигнал обработан, вы можете определить, следует ли области касания захватывать текущие точки касания. По умолчанию они не будут захвачены; чтобы захватить их, вызовите gesture.grab(). Если жест не захвачен, вложенный, например, Flickable, также имеет возможность захвата.

Объект gesture также содержит информацию о текущем наборе touchPoints и dragThreshold.

Примечание: Соответствующий обработчик — onGestureStarted.

pressed(список<TouchPoint> touchPoints)

Этот сигнал излучается, когда добавляются новые точки касания. touchPoints — это список этих новых точек.

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

Примечание: Соответствующий обработчик — onPressed.

released(список<TouchPoint> touchPoints)

Этот сигнал излучается, когда удаляются существующие точки касания. touchPoints — это список удаленных точек.

Примечание: Соответствующий обработчик — onReleased.

touchUpdated(список<TouchPoint> touchPoints)

Этот сигнал излучается, когда точки касания, обрабатываемые MultiPointTouchArea, изменяются. Это включает добавление новых точек касания, удаление или отмену предыдущих точек касания, а также обновление данных текущих точек касания. touchPoints — это список всех текущих точек касания.

Примечание: Соответствующий обработчик — onTouchUpdated.

updated(список<TouchPoint> touchPoints)

Этот сигнал излучается, когда существующие точки касания обновляются. touchPoints — это список обновленных точек.

Примечание: Соответствующий обработчик — onUpdated.