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