Класс QMouseEvent

Класс QMouseEvent содержит параметры, описывающие событие мыши. Подробнее...

• Список всех членов, включая наследуемые
• Устаревшие члены

Открытые функции

• 2 открытых функций, унаследованных от QInputEvent
• 6 открытых функций, унаследованных от QEvent

Дополнительные унаследованные члены

• 1 свойство, унаследованное от QEvent
• 1 статический открытый член, унаследованный от QEvent

Подробное описание

Класс QMouseEvent содержит параметры, описывающие событие мыши.

События мыши происходят при нажатии или отпускании кнопок мыши внутри виджета или при перемещении указателя мыши.

События перемещения мыши будут происходить только при нажатии кнопки мыши, если отслеживание мыши не было включено с помощью QWidget::setMouseTracking().

Qt автоматически захватывает мышь при нажатии кнопки мыши внутри виджета; виджет будет продолжать получать события мыши, пока последняя кнопка мыши не будет отпущена.

Событие мыши содержит специальный флаг подтверждения, который указывает, хочет ли получатель событие. Вы должны вызвать ignore(), если событие мыши не обрабатывается вашим виджетом. Событие мыши распространяется вверх по цепочке родительских виджетов, пока виджет не примет его с помощью accept(), или его не потребляет фильтр событий.

Примечание: Если событие мыши распространяется на виджет, для которого установлен Qt::WA_NoMousePropagation, это событие мыши не будет распространяться дальше по цепочке родительских виджетов.

Состояние клавиш модификаторов клавиатуры можно найти, вызвав функцию modifiers(), унаследованную от QInputEvent.

Функции pos(), x() и y() возвращают положение курсора относительно виджета, который получает событие мыши. Если вы перемещаете виджет в результате события мыши, используйте глобальное положение, возвращаемое функцией globalPos(), чтобы избежать дрожания.

Функция QWidget::setEnabled() может использоваться для включения или отключения событий мыши и клавиатуры для виджета.

Переопределите обработчики событий виджета QWidget, QWidget::mousePressEvent(), QWidget::mouseReleaseEvent(), QWidget::mouseDoubleClickEvent() и QWidget::mouseMoveEvent(), чтобы получать события мыши в собственных виджетах.

См. также QWidget::setMouseTracking(), QWidget::grabMouse() и QCursor::pos().

Документация по функциям-членам

QMouseEvent::QMouseEvent(Type type, const QPointF &localPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers)

Конструирует объект события мыши.

Параметр type должен быть одним из QEvent::MouseButtonPress, QEvent::MouseButtonRelease, QEvent::MouseButtonDblClick или QEvent::MouseMove.

localPos — положение курсора мыши относительно принимающего виджета или элемента. Положение окна устанавливается в то же значение, что и localPos. Кнопка, вызвавшая событие, задается как значение из перечисления Qt::MouseButton. Если тип события type равен MouseMove, соответствующая кнопка для этого события — Qt::NoButton. Состояния мыши и клавиатуры в момент события задаются параметрами buttons и modifiers.

Значение screenPos() инициализируется значением QCursor::pos(), что может быть неподходящим. Используйте другой конструктор для явного указания глобального положения.

QMouseEvent::QMouseEvent(Type type, const QPointF &localPos, const QPointF &screenPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers)

Конструирует объект события мыши.

Параметр type должен быть QEvent::MouseButtonPress, QEvent::MouseButtonRelease, QEvent::MouseButtonDblClick или QEvent::MouseMove.

localPos — положение курсора мыши относительно принимающего виджета или элемента. Положение курсора в координатах экрана задается параметром screenPos. Положение окна устанавливается в то же значение, что и localPos. Кнопка, вызвавшая событие, задается как значение из перечисления Qt::MouseButton. Если тип события type равен MouseMove, соответствующая кнопка для этого события — Qt::NoButton. buttons — состояние всех кнопок в момент события, modifiers — состояние всех модификаторов клавиатуры.

QMouseEvent::QMouseEvent(Type type, const QPointF &localPos, const QPointF &windowPos, const QPointF &screenPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers)

Конструирует объект события мыши.

Параметр type должен быть QEvent::MouseButtonPress, QEvent::MouseButtonRelease, QEvent::MouseButtonDblClick или QEvent::MouseMove.

Точки localPos, windowPos и screenPos указывают положение курсора мыши относительно получающего виджета или элемента, окна и экрана соответственно.

button, вызвавший событие, задается как значение из перечисления Qt::MouseButton. Если тип события type равен MouseMove, соответствующая кнопка для этого события равна Qt::NoButton. buttons — состояние всех кнопок в момент события, modifiers — состояние всех модификаторов клавиатуры.

QMouseEvent::QMouseEvent(Type type, const QPointF &localPos, const QPointF &windowPos, const QPointF &screenPos, Qt::MouseButton button, Qt::MouseButtons buttons, Qt::KeyboardModifiers modifiers, Qt::MouseEventSource source)

Создает экземпляр QMouseEvent по умолчанию.

Qt::MouseButton QMouseEvent::button() const

Возвращает кнопку, вызвавшую событие.

Обратите внимание, что для событий перемещения мыши возвращаемое значение всегда равно Qt::NoButton.

См. также buttons() и Qt::MouseButton.

Qt::MouseButtons QMouseEvent::buttons() const

Возвращает состояние кнопок в момент генерации события. Состояние кнопок — это комбинация Qt::LeftButton, Qt::RightButton, Qt::MidButton с использованием оператора OR. Для событий перемещения мыши это все нажатые кнопки. Для событий нажатия и двойного щелчка мыши это включает кнопку, вызвавшую событие. Для событий отпускания мыши это исключает кнопку, вызвавшую событие.

См. также button() и Qt::MouseButton.

Qt::MouseEventFlags QMouseEvent::flags() const

Возвращает флаги события мыши.

Флаги события мыши предоставляют дополнительную информацию о событии мыши.

Эта функция была добавлена в Qt 5.3.

См. также Qt::MouseEventFlag и QGraphicsSceneMouseEvent::flags().

QPoint QMouseEvent::globalPos() const

Возвращает глобальное положение курсора мыши в момент события. Это важно в асинхронных системах окон, таких как X11. Когда вы перемещаете виджеты в ответ на события мыши, globalPos() может сильно отличаться от текущего положения указателя QCursor::pos() и от QWidget::mapToGlobal(pos()).

См. также globalX() и globalY().

int QMouseEvent::globalX() const

Возвращает глобальную x-позицию курсора мыши в момент события.

См. также globalY() и globalPos().

int QMouseEvent::globalY() const

Возвращает глобальную y-позицию курсора мыши в момент события.

См. также globalX() и globalPos().

const QPointF &QMouseEvent::localPos() const

Возвращает положение курсора мыши как QPointF, относительно виджета или элемента, получившего событие.

Если вы перемещаете виджет в результате события мыши, используйте позицию на экране, возвращаемую screenPos(), чтобы избежать дрожания.

Эта функция была добавлена в Qt 5.0.

См. также x(), y(), windowPos() и screenPos().

QPoint QMouseEvent::pos() const

Возвращает положение курсора мыши относительно виджета, получившего событие.

Если вы перемещаете виджет в результате события мыши, используйте глобальную позицию, возвращаемую globalPos(), чтобы избежать дрожания.

См. также x(), y() и globalPos().

const QPointF &QMouseEvent::screenPos() const

Возвращает положение курсора мыши как QPointF, относительно экрана, получившего событие.

Эта функция была добавлена в Qt 5.0.

См. также x(), y(), pos(), localPos() и windowPos().

Qt::MouseEventSource QMouseEvent::source() const

Возвращает информацию о источнике события мыши.

Источник события мыши может использоваться для различения реальных и искусственных событий мыши. Последние — это события, синтезированные из событий касания операционной системой или самим Qt.

Примечание: Многие платформы не предоставляют такой информации. На таких платформах всегда возвращается Qt::MouseEventNotSynthesized.

Эта функция была добавлена в Qt 5.3.

См. также Qt::MouseEventSource и QGraphicsSceneMouseEvent::source().

const QPointF &QMouseEvent::windowPos() const

Возвращает положение курсора мыши как QPointF, относительно окна, получившего событие.

Если вы перемещаете виджет в результате события мыши, используйте глобальную позицию, возвращаемую globalPos(), чтобы избежать дрожания.

Эта функция была добавлена в Qt 5.0.

См. также x(), y(), pos(), localPos() и screenPos().

int QMouseEvent::x() const

Возвращает x-позицию курсора мыши относительно виджета, получившего событие.

См. также y() и pos().

int QMouseEvent::y() const

Возвращает y-позицию курсора мыши относительно виджета, получившего событие.

См. также x() и pos().