QContextMenuEvent 类

QContextMenuEvent 类包含上下文菜单事件的描述参数。 更多...

头: #include <QContextMenuEvent>
CMake: find_package(Qt6 COMPONENTS Gui REQUIRED)
target_link_libraries(mytarget PRIVATE Qt6::Gui)
qmake: QT += gui
继承: QInputEvent

公共类型

enum 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

详细描述

上下文菜单事件被发送给 Widget,当用户履行关联打开上下文菜单的动作时。打开上下文菜单要求的动作因平台而异;例如,在 Windows,按下菜单按钮 (或点击鼠标右键) 将导致此事件被发送。

当此事件发生时,习惯上展示 QMenu 带上下文菜单,若这与上下文有关。

成员类型文档编制

enum 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 or QContextMenuEvent::Keyboard .

pos 参数指定相对于接收 Widget 的鼠标位置。

globalPos () 被初始化为 QCursor::pos (),可能不合适。使用其它构造函数以明确指定全局位置。

QContextMenuEvent:: QContextMenuEvent ( QContextMenuEvent::Reason reason , const QPoint & pos , const QPoint & globalPos , Qt::KeyboardModifiers modifiers = Qt::NoModifier)

构造上下文菜单事件对象,采用将 accept (接受) 参数标志设为 false。

reason 参数必须是 QContextMenuEvent::Mouse or QContextMenuEvent::Keyboard .

pos 参数指定相对于接收 Widget 的鼠标位置。 globalPos 是按绝对坐标的鼠标位置。 modifiers 保持键盘修饰符。

const QPoint &QContextMenuEvent:: globalPos () const

返回事件发生时的鼠标指针全局位置。

另请参阅 x (), y (),和 pos ().

int QContextMenuEvent:: globalX () const

返回事件发生时的鼠标指针全局 X 位置。

另请参阅 globalY () 和 globalPos ().

int QContextMenuEvent:: globalY () const

返回事件发生时的鼠标指针全局 Y 位置。

另请参阅 globalX () 和 globalPos ().

const QPoint &QContextMenuEvent:: pos () const

返回指针相对于接收事件 Widget 的的鼠标指针位置。

另请参阅 x (), y (),和 globalPos ().

QContextMenuEvent::Reason QContextMenuEvent:: reason () const

返回此上下文事件的原因。

int QContextMenuEvent:: x () const

返回鼠标指针的 X 位置,相对于接收事件 Widget。

另请参阅 y () 和 pos ().

int QContextMenuEvent:: y () const

返回鼠标指针的 Y 位置,相对于接收事件 Widget。

另请参阅 x () 和 pos ().