Класс 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.1/qcontextmenuevent.html