Тип 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 равно двум, вы можете использовать мышь как одну точку касания и палец как другую точку касания для общего значения 2.

minimumTouchPoints : int

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

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

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

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

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.