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