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