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

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

maximumTouchPoints : int

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

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

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

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

minimumTouchPoints : int

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

Это удобство, которое позволяет, например, иметь вложенные 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, например, также получит возможность захвата.

Объект жеста также содержит информацию о текущем наборе 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.