Qt 窗口事件机制
在 Qt 开发中，窗口的关闭、隐藏、显示等事件是常见且重要的功能。不同的事件触发条件、处理方式不同，了解和掌握这些事件有助于我们更好地控制窗口行为。本文将详细讲解这些事件的使用方法，并通过代码实例来展示其应用。
1. done(int r) — 关闭对话框并返回结果
描述: done(int) 是 QDialog 的方法，关闭对话框并返回结果代码。
触发条件: 常用于关闭模态对话框，通过传递整数参数来标识结果状态。
代码示例:
void MyDialog::on_finishButton_clicked() {
done(1); // 关闭对话框，返回结果代码1（成功）
}
常用场景: 用于对话框操作完成后，返回成功或失败等结果代码。
2. closeEvent(QCloseEvent *event) — 窗口关闭事件
描述: 当窗口即将关闭时触发，可以选择接受或忽略关闭操作。
触发条件: 用户点击关闭按钮（“×”）或调用 close() 方法时触发。
代码示例:
void MainWindow::closeEvent(QCloseEvent *event) {
if (maybeSave()) {
event->accept(); // 确认保存后允许关闭窗口
} else {
event->ignore(); // 未保存则阻止关闭
}
}
常用场景: 在用户尝试关闭窗口时检查是否有未保存的更改，弹出确认对话框。
3. hideEvent(QHideEvent *event) — 窗口隐藏事件
描述: 当窗口被隐藏时触发，用于在窗口隐藏时保存状态或暂停操作。
触发条件: 调用 hide() 方法或其他方式使窗口不可见时触发。
代码示例:
void MainWindow::hideEvent(QHideEvent *event) {
qDebug() << "窗口已隐藏";
// 在此执行暂停任务或保存状态的操作
}
常用场景: 当窗口被隐藏时，停止长时间运行的任务，或保存当前的工作状态。
4. showEvent(QShowEvent *event) — 窗口显示事件
描述: 窗口从隐藏状态转为可见时触发，用于恢复被暂停的操作或初始化界面。
触发条件: 调用 show() 或从隐藏状态变为可见时触发。
代码示例:
void MainWindow::showEvent(QShowEvent *event) {
qDebug() << "窗口已显示";
// 恢复被暂停的任务或重新加载数据
}
常用场景: 恢复窗口被隐藏时暂停的后台任务或重新加载内容。
5. moveEvent(QMoveEvent *event) — 窗口移动事件
描述: 当窗口位置改变时触发，通常用于跟踪窗口的位置。
触发条件: 窗口被用户拖动或通过代码改变位置时触发。
代码示例:
void MainWindow::moveEvent(QMoveEvent *event) {
QPoint newPos = event->pos(); // 获取窗口的新位置
qDebug() << "窗口移动到" << newPos;
}
常用场景: 在窗口移动时更新其他子窗口的位置或同步其他UI元素。
6. resizeEvent(QResizeEvent *event) — 窗口调整大小事件
描述: 当窗口大小发生变化时触发，通常用于调整内部控件布局。
触发条件: 窗口大小变化时触发，如通过用户手动调整或代码修改。
代码示例:
void MainWindow::resizeEvent(QResizeEvent *event) {
QSize newSize = event->size(); // 获取窗口的新大小
qDebug() << "窗口调整为大小" << newSize;
}
常用场景: 在窗口大小变化时调整控件的大小和布局，以适应新的窗口尺寸。
7. changeEvent(QEvent *event) — 窗口状态变化事件
描述: 窗口状态（如最小化、最大化、激活等）变化时触发。
触发条件: 窗口状态（最小化、最大化、激活等）发生变化时触发。
代码示例:
void MainWindow::changeEvent(QEvent *event) {
if (event->type() == QEvent::WindowStateChange) {
QWindowStateChangeEvent *stateEvent = static_cast<QWindowStateChangeEvent *>(event);
if (stateEvent->oldState() & Qt::WindowMinimized) {
// 窗口从最小化恢复时的操作
qDebug() << "窗口从最小化状态恢复";
}
}
}
常用场景: 当窗口状态发生变化时，执行特定操作（如暂停/恢复任务）。
8. focusInEvent(QFocusEvent *event) 和 focusOutEvent(QFocusEvent *event) — 窗口获得/失去焦点事件
描述: 当窗口获得或失去焦点时触发，通常用于更新窗口状态。
触发条件: 窗口获得或失去焦点时触发。
代码示例:
void MainWindow::focusInEvent(QFocusEvent *event) {
qDebug() << "窗口获得焦点";
}
void MainWindow::focusOutEvent(QFocusEvent *event) {
qDebug() << "窗口失去焦点";
}
常用场景: 在窗口失去焦点时暂停操作，或在获得焦点时恢复操作。
9. keyPressEvent(QKeyEvent *event) 和 keyReleaseEvent(QKeyEvent *event) — 键盘事件
描述: 当用户按下或释放键盘按键时触发。
触发条件: 按下或释放某个键时触发。
代码示例:
void MainWindow::keyPressEvent(QKeyEvent *event) {
if (event->key() == Qt::Key_Escape) {
close(); // 按下Esc键关闭窗口
}
}
常用场景: 处理键盘快捷键、游戏控制等场景。
10. enterEvent(QEvent *event) 和 leaveEvent(QEvent *event) — 鼠标进入/离开事件
描述: 当鼠标进入或离开窗口区域时触发。
触发条件: 鼠标进入或离开窗口时触发。
代码示例:
void MainWindow::enterEvent(QEvent *event) {
qDebug() << "鼠标进入窗口";
}
void MainWindow::leaveEvent(QEvent *event) {
qDebug() << "鼠标离开窗口";
}
常用场景: 用于更新UI状态，如显示提示信息或更改控件样式。