Класс QMouseEvent

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

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

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

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

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

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

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

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

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

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

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

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

Примечание: Если событие мыши передается виджету widget, для которого установлен 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. Кнопка button, вызвавшая событие, задаётся значением из перечисления 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. Кнопка 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)

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

Параметр 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().