Класс QContextMenuEvent
Класс QContextMenuEvent содержит параметры, описывающие событие контекстного меню. Подробнее...
| Заголовок: | #include <QContextMenuEvent> |
| qmake: | QT += gui |
| Наследует: | QInputEvent |
Типы публичного доступа
| перечисление | Reason { Mouse, Keyboard, Other } |
Открытые функции
| QContextMenuEvent(QContextMenuEvent::Reason reason, const QPoint &pos) | |
| QContextMenuEvent(QContextMenuEvent::Reason reason, const QPoint &pos, const QPoint &globalPos) | |
| QContextMenuEvent(QContextMenuEvent::Reason reason, const QPoint &pos, const QPoint &globalPos, Qt::KeyboardModifiers modifiers) | |
| const QPoint & | globalPos() const |
| int | globalX() const |
| int | globalY() const |
| const QPoint & | pos() const |
| QContextMenuEvent::Reason | reason() const |
| int | x() const |
| int | y() const |
Подробное описание
События контекстного меню отправляются виджетам, когда пользователь выполняет действие, связанное с открытием контекстного меню. Действия, необходимые для открытия контекстных меню, различаются в зависимости от платформы; например, в Windows нажатие кнопки меню или щелчок правой кнопкой мыши приведет к отправке этого события.
При возникновении этого события обычно отображается QMenu с контекстным меню, если это уместно в данном контексте.
События контекстного меню содержат специальный флаг подтверждения, который указывает, принял ли получатель событие. Если обработчик события не принимает событие, то, если это возможно, то, что вызвало событие, будет обработано как обычное событие ввода.
Документация по типам членов
перечисление QContextMenuEvent::Reason
Это перечисление описывает причину отправки события.
| Постоянная | Значение | Описание |
|---|---|---|
QContextMenuEvent::Mouse |
0 |
Мышь вызвала отправку события. Обычно это означает, что была нажата правая кнопка мыши, но это зависит от платформы. |
QContextMenuEvent::Keyboard |
1 |
Клавиатура вызвала отправку события. В Windows это означает, что была нажата кнопка меню. |
QContextMenuEvent::Other |
2 |
Событие было отправлено другим способом (т.е. не мышкой и не клавиатурой). |
Документация по документации функций членов
QContextMenuEvent::QContextMenuEvent(QContextMenuEvent::Reason reason, const QPoint &pos)
Конструктор объекта события контекстного меню со значением флага accept установленным в false.
Параметр reason должен быть QContextMenuEvent::Mouse или QContextMenuEvent::Keyboard.
Параметр pos указывает положение мыши относительно принимающего виджета.
Метод globalPos() инициализирован значением QCursor::pos(), что может быть некорректно. Используйте другой конструктор для явного задания глобального положения.
QContextMenuEvent::QContextMenuEvent(QContextMenuEvent::Reason reason, const QPoint &pos, const QPoint &globalPos)
Создаёт объект события контекстного меню со значением флага accept, установленным в false.
Параметр reason должен быть равен QContextMenuEvent::Mouse или QContextMenuEvent::Keyboard.
Параметр pos задаёт положение курсора мыши относительно обрабатывающего виджета. globalPos — это положение курсора мыши в абсолютных координатах.
QContextMenuEvent::QContextMenuEvent(QContextMenuEvent::Reason reason, const QPoint &pos, const QPoint &globalPos, Qt::KeyboardModifiers modifiers)
Создаёт объект события контекстного меню со значением флага accept, установленным в false.
Параметр reason должен быть равен QContextMenuEvent::Mouse или QContextMenuEvent::Keyboard.
Параметр pos задаёт положение курсора мыши относительно обрабатывающего виджета. globalPos — это положение курсора мыши в абсолютных координатах. modifiers содержит модификаторы клавиш.
const QPoint &QContextMenuEvent::globalPos() const
Возвращает глобальное положение указателя мыши в момент события.
int QContextMenuEvent::globalX() const
Возвращает глобальную x-координату указателя мыши в момент события.
См. также globalY() и globalPos().
int QContextMenuEvent::globalY() const
Возвращает глобальную y-координату указателя мыши в момент события.
См. также globalX() и globalPos().
const QPoint &QContextMenuEvent::pos() const
Возвращает положение указателя мыши относительно виджета, получившего событие.
См. также x(), y() и globalPos().
QContextMenuEvent::Reason QContextMenuEvent::reason() const
Возвращает причину возникновения события контекстного меню.
int QContextMenuEvent::x() const
Возвращает x-координату указателя мыши относительно виджета, получившего событие.
int QContextMenuEvent::y() const
Возвращает y-координату указателя мыши относительно виджета, получившего событие.
© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/qt-5.15/qcontextmenuevent.html