Класс QContextMenuEvent
Класс QContextMenuEvent содержит параметры, описывающие событие контекстного меню. Подробнее...
| Заголовок: | #include <QContextMenuEvent> |
| CMake: | find_package(Qt6 COMPONENTS Gui REQUIRED) target_link_libraries(mytarget PRIVATE Qt6::Gui) |
| 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, Qt::KeyboardModifiers modifiers = Qt::NoModifier) | |
| 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)
Создаёт объект события контекстного меню со флагом принятия, установленным в false.
Параметр reason должен быть QContextMenuEvent::Mouse или QContextMenuEvent::Keyboard.
Параметр pos указывает положение курсора мыши относительно получающего виджета.
Значение globalPos() инициализируется значением QCursor::pos(), что может быть неподходящим. Используйте другой конструктор, чтобы явно указать глобальное положение.
QContextMenuEvent::QContextMenuEvent(QContextMenuEvent::Reason reason, const QPoint &pos, const QPoint &globalPos, Qt::KeyboardModifiers modifiers = Qt::NoModifier)
Создаёт объект события контекстного меню со флагом принятия, установленным в 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-6.0/qcontextmenuevent.html