QWidget类 简介

QWidget 类

定义：代表一般的窗口，其他窗口类都是从 QWidget 类继承出来的。

继承关系

同时继承：QObject 类 和 QPaintDevice类

构造函数如下

QWidget(QWidget *parent = 0, Qt::WindowFlags f = 0);
参数： parent 指向父窗口，如果这个参数为 0，则窗口就成为一个顶级窗口
参数 ：f 是构造窗口的标志，主要用于控制窗口的类型和外观等，有以下常用值。
1）Qt::FramelessWindowHint：没有边框的窗口。
2）Qt::WindowStaysOnTopHint：总是最上面的窗口。
3）Qt::CustomizeWindowHint：自定义窗口标题栏，以下标志必须与这个标志一起使用才有效，否则窗口将有默认的标题栏。
4）Qt::WindowTitleHint：显示窗口标题栏。
5）Qt::WindowSystemMenuHint：显示系统菜单。
6）Qt::WindowMinimizeButtonHint：显示最小化按钮。
7）Qt::WindowMaximizeButtonHint：显示最大化按钮。
8）Qt::WindowMinMaxbuttonHint：显示最小化按钮和最大化按钮。
9）Qt::WindowCloseButtonHint：显示关闭按钮。

 // 其它方法
setWindowFlags(Qt::WindowCloseButtonHint | Qt::WindowStaysOnTopHint);//设置只有关闭按钮且置顶

常用函数

bool isWindow() const; // 判断是否为独立窗口
QWidget *window() const; // 所得所在的独立窗口
QWidget *parentWidget() const; // 得到父窗口
QString windowTitle() const; // 获得窗口标题
void setWindowTitle(const QString &text); // 设置窗口标题为 text

几何参数

const QRect &geometry() const; // 获取客户区几何参数
void setGeometry(int x, int y, int w, int h); // 设置客户区几何参数
void setGeometry(const QRect &rect); // 设置客户区几何参数
QRect frameGeometry() const; // 获取外边框几何参数
相关参数
QPoint pos() const; // 获得窗口左上角的坐标(外边框几何参数)
QSize size() const; // 窗口大小 （客户区几何参数）
int x() const; // 窗口左上角横坐标 （外边框几何参数）
int y() const; // 窗口左上角纵坐标 （外边框几何参数）
int height() const; // 窗口高度 （客户区几何参数）
int width() const; // 窗口宽度 （客户区几何参数）
QSize frameSize() const; // 窗口大小 （外边框几何参数）
改变大小
void move(int x, int y); // 将窗口左上角移动到坐标（x, y）处；
void move(const QPoint &pos); // 将窗口左上角移动到 pos 处；
void resize(int w, int h); // 将窗口的宽度改为 w， 高度改为 h
void resize(const QSize &size); // 将窗口的大小改为 size
void setFixedSize(int w, int h); // 将窗口设置 固定大小改为 size

//移动至左上角，固定长200，高500
setFixedSize(200,500);
move(0,0);

窗口可见

bool isVisible() const; // 判断窗口是否可见
bool isHidden() const; // 判断窗口是否隐藏
virtual void setVisible(bool visible); // 设置窗口是否隐藏
void setHidden(bool hidden); // 等价于 setvisible(!hidedn);
setVisible 和 setHidden 同时也是槽，它们一般并不直接使用，而是使用以下几个槽：
void show(); // 显示窗口，等价于 setVisible(true);
void hide(); // 隐藏窗口，等价于 setHidden(true);

窗口状态

bool isMinimized() const; // 判断窗口是否为最小化
bool isMaximized() const; // 判断窗口是否为最大化
bool isFullScreen() const; // 判断窗口是否为全屏
void showMinimized(); // 以最小化方式显示窗口，这是一个槽
void showMaximized(); // 以最大化方式显示窗口，这是一个槽
void showFullScreen(); // 以全屏方式显示窗口，这是一个槽
void showNormal(); // 以正常方式显示窗口，这是一个槽 Qt::WindowStates windowState() const; // 获取窗口状态 void
setWindowState(Qt::WindowStates windowState); // 设置窗口状态
这里的 Qt::WindowStates 类型有以下几个取值。
1）Qt::WindowNoState：无标志，正常状态。
2）Qt::WindowMinimized：最小化状态。
3）Qt::WindowMaxmized：最大化状态。
4）Qt::WindowFullScreen：全屏状态。
5）Qt::WindowActive：激活状态。
这里取值可以用 “按位或” 的方式组合起来使用。

使能状态的窗口

bool isEnabled() const; // 获得窗口的使能装态
void setEnabled(bool enable); // 设置窗口的使能状态，这是一个槽
void setDisabled(bool disabled); // 等价于 setEnabled(!disable)，这是一个槽

激活状态
当有多个独立窗口同时存在时，只有一个窗口能够处于激活状态。系统产生的键盘、鼠标等输入事件将被发送给处于激活状态的窗口。一般来说，这样的窗口会被提升到堆叠层次的最上面，除非其他窗口有总在最上面的属性。与激活状态相关的成员函数如下：

bool isActiveWindow() const; // 判断窗口所在的独立窗口是否激活
void activateWindow(); // 设置窗口所在的独立窗口为激活状态

焦点
焦点用来控制同一个独立窗口内哪一个部件可以接受键盘事件，同一时刻只能有一个部件获得焦点。与焦点有关的成员函数如下：

bool hasFocus() const; // 判断窗口是否获得焦点
void setFocus(); // 使窗口获得焦点，这是一个槽
void clearFocus(); // 使窗口失去焦点
QWidget *focusWidget() const; // 得到窗口内获得焦点的子窗口

setFocus 函数同时又是一个槽。窗口部件得到焦点以后，别忘了还需要它所在的独立窗口处于激活状态才能得到键盘事件。

bool hasEditfocus() const; // 判断窗口是否有 editFocus 属性
void QWidget::setEditFocus(bool enable); // 设置窗口的 editFocus 属性

捕获键盘和鼠标事件
窗口部件即使获得焦点，也不一定能获得按键事件，因为其他窗口可能会捕获键盘事件。捕获了键盘事件的窗口将得到所有键盘事件，而其他窗口将完全得到不到键盘事件，直到捕获了键盘事件的窗口释放键盘事件。与键盘事件捕获相关的成员函数如下：

void grabKeyboard(); // 捕获键盘事件
void releaseKeyboard(); // 释放键盘事件

类似的还有鼠标事件的捕获和释放，其成员函数如下：

void grabMouse(); // 捕获鼠标事件
void releaseMouse(); // 释放鼠标事件

对键盘事件和鼠标事件的捕获是相互独立的。这里要注意两点：一是如果有另外一个窗口进行了捕获操作，则当前处于捕获状态的窗口将失去对事件的捕获；二是只有可见的窗口才能进行输入事件捕获。
以下的成员函数能够得到应用程序中正在捕获键盘或鼠标事件的窗口：

QWidget *keyboardGrabber(); // 得到正在捕获键盘事件的窗口
QWidget *mouseGrabber(); // 得到正在捕获鼠标事件的窗口
这两个函数是静态函数。

布局
属性 layout 代表窗口的顶级布局，相关的成员函数如下：

QLayout *layout() const; // 获得顶级布局
void setLayout(QLayout *layout); // 设置顶级布局

字体
font 属性表示所用的字体，相关的成员函数如下：

const QFont &font() const; // 获得字体 void setFont(const
QFont &); // 设置字体

如果没有为窗口设置字体，则窗口自动使用父窗口的字体，顶级窗口则使用应用程序的默认字体。
信号
当窗口要被析构时会发射以下信号：

void destoryed(QObject *obj = 0);

这是一个从 QOjbect 类继承过来的信号。QObject 对象析构时，先发射这个信号，然后才析构它的所有子对象。
槽
在前面的介绍中已经提及了 QWidget 类的许多槽，这里将介绍其他常用的槽。
下面的槽可以关闭窗口：

bool close();

当这个槽被调用时，首先向这个窗口发送一个关闭事件，如果事件被接受，则窗口隐藏，如果被拒绝，则什么也不做。如果窗口设置了 Qt::WA_QuitOnClose 属性，则窗口对象会被析构，大多数类型的窗口都默认设置了这个属性。
这个槽的返回值表示关闭事件是否被接受，也就是窗口是否真的被关闭了。
下面的槽可以提升或降低窗口所在的堆叠层次：

void lower(); // 降低窗口到最下面
void raise(); // 提升窗口到最上面

事件
QWidget 类能够处理类型丰富的事件，这里将介绍一些常用的事件处理函数。
窗口事件：

virtual void closeEvent(QCloseEvent *event); // 关闭
virtual void showEvent(QShowEvent *event); // 显示
virtual void hideEvent(QHideEvent *event); // 隐藏
virtual void moveEvent(QMoveEvent *evnet); // 移动
virtual void resizeEvent(QResizeEvent *event); // 改变大小

这里通过 QMoveEvent 类的以下成员函数可以获得窗口的旧坐标和新坐标：

const QPoint &oldPos() const; // 旧坐标 const QPoint &newPos()
constl // 新坐标

通过 QResizeEvent 类的以下成员函数可以获得窗口的旧大小和新大小：

const QSize &oldSize() const; // 旧大小 const QSize &newSize()
const; // 新大小

键盘事件：

virtual void keyPressEvent(QKeyEvent *event); // 键按下
virtual void keyReleaseEvent(QKeyEvent *event); // 键松开

这里通过 QKeyEvent 类的成员函数可以获得关于按键的一些信息，如：

int key() const; // 得到键值

鼠标事件：

virtual void mousePressEvent(QMouseEvent *event);
// 鼠标键按下
virtual void mouseReleaseEvent(QMouseEvent *event); // 鼠标键松开
virtual void mouseDoubleCllckEvent(QMouseEvent *event); // 鼠标键双击
virtual void mouseMoveEvent(QMouseEvent *event); // 鼠标移动
virtual void enterEvent(QEvent *event); // 鼠标进入窗口
virtual void leaveEvent(QEvent *event); // 鼠标离开窗口
virtual void wheelEvent(QWheelEvent *event); // 鼠标滚轮移动

这里通过 QMouseEvent 事件的成员函数可获得关于鼠标的信息，如：

const QPoint &pos() const; // 得到鼠标坐标（相对于接收事件的窗口）
int x() const; // 得到鼠标横坐标（相对于接收事件的窗口）
int y() const; // 得到鼠标纵坐标（相对于接收事件的窗口）
const QPoint &globalPos() const; // 得到鼠标坐标（全局坐标）
int globalX() const; // 得到鼠标横坐标 （全局坐标）
int globalY() const; // 得到鼠标纵坐标 （全局坐标）
Qt::MouseButton button() const; // 得到引起事件的鼠标键
Qt::MouseButtons buttons() const; // 得到事件发生时的鼠标键状态
其中，Qt::MouseButton 是一个枚举类型，有以下常用取值。
1）Qt::NoButton：无键。
2）Qt::LeftButton：左键。
3）Qt::RightButton：右键。
4）Qt::MidButton：中键。

注意，对于鼠标移动事件 QMouseEvent 和 button 函数总是返回 Qt::NoButton，而 buttons 函数返回值则是 Qt::MouseButton 类型的 “按位或” 组合，它能反映事件发生时鼠标键的按下状态。
QWheelEvent 类代表滚轮事件，它有一套与 QMountEvent 类几乎相同的成员函数，但少一个 button 函数，多以下两个函数：

int delta() const; // 获得滚轮转动的角度
Qt::Orientation orientationI() const; // 获得滚轮转动的方向
其中 Qt::Orientation 是一个枚举类型，它有以下取值。
1）Qt::Horizontal：横向。
2）Qt::Vertical：纵向。

焦点事件：

virtual void focusInEvent(QFocusEvent *event); // 获得焦点
virtual void focusOutEvent(QFocusEvent *event); // 时取焦点

这些事件处理函数都没有返回值，因此如果要接受或拒绝和一个事件要调用 QEvent 类的成员函数，如：

event->accept(); // 接受事件
event->ignore(); // 拒绝事件

事件被拒绝后的结果视具体情况而定，比如关闭事件被拒绝后，窗口将不会被关闭，而键盘、鼠标等输入事件被拒绝后会向上传播到父窗口。