Тип 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.