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