QFrame类学习笔记

青旅半醒 2023-10-16 15:07 39阅读 0赞

## 1、QFrame的作用 ##

QFrame类继承于QWidget类，被QAbstractScrollArea, QLabel, QLCDNumber, QSplitter, QStackedWidget, and QToolBox等类继承。 QFrame作为许多基础控件的基类，提供许多成员方法给子类，实现子类的框架样式的设计。框架样式主要由框架形状和用于从视觉上将框架与周围的小部件分开的阴影样式组成。即

1.  QFrame为子类提供了设计框架风格的成员函数，帮助子类设计特有的风格：或边框突起、或边框凹陷、或内容突起、或内容凹陷等效果。
2.  QFrame还可以直接用于创建不包含任何内容的简单占位符框架。

## 2、QFrame的成员类型文档 ##

### 2.1 enum QFrame::Shadow ###

此枚举类型定义了用于给帧提供3D效果的阴影类型。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td>QFrame::Plain</td> 
   <td>0x0010</td> 
   <td>边框或内容与周围控件看起来一样高</td> 
  </tr> 
  <tr> 
   <td>QFrame::Raised</td> 
   <td>0x0020</td> 
   <td>边框或内容比周围控件看起来突起</td> 
  </tr> 
  <tr> 
   <td>QFrame::Sunken</td> 
   <td>0x0030</td> 
   <td>边框或内容比周围控件看起来凹陷</td> 
  </tr> 
 </tbody> 
</table>

### 2.2 enum QFrame::Shape ###

这个enum类型定义了可用帧的形状。

<table style="width:672px;"> 
 <tbody> 
  <tr> 
   <td style="width:130px;">QFrame::NoFrame</td> 
   <td style="width:82px;">0&nbsp;</td> 
   <td style="width:436px;">不画任何内容</td> 
  </tr> 
  <tr> 
   <td style="width:130px;">QFrame::Box</td> 
   <td style="width:82px;">0x0001</td> 
   <td style="width:436px;">画一个边框将内容包起来，凸显边框的阴影效果</td> 
  </tr> 
  <tr> 
   <td style="width:130px;">QFrame::Panel</td> 
   <td style="width:82px;">0x0002</td> 
   <td style="width:436px;">画一个内容平面，凸显内容的阴影效果</td> 
  </tr> 
  <tr> 
   <td style="width:130px;">QFrame::StyledPanel</td> 
   <td style="width:82px;">0x0006</td> 
   <td style="width:436px;">绘制一个外观取决于当前GUI样式的矩形面板。它可以突起也可以凹陷。</td> 
  </tr> 
  <tr> 
   <td style="width:130px;">QFrame::HLine</td> 
   <td style="width:82px;">0x0004</td> 
   <td style="width:436px;">绘制一条水平线，起分隔作用，凸显线的阴影效果</td> 
  </tr> 
  <tr> 
   <td style="width:130px;">QFrame::VLine</td> 
   <td style="width:82px;">0x0005</td> 
   <td style="width:436px;">绘制一条竖线，起分隔作用，凸显线的阴影效果</td> 
  </tr> 
  <tr> 
   <td style="width:130px;">QFrame::WinPanel</td> 
   <td style="width:82px;">0x0003</td> 
   <td style="width:436px;">绘制一个矩形面板，可以像Windows 2000那样向上或向下移动。指定此形状将线宽设置为2像素。WinPanel是为了兼容而提供的。</td> 
  </tr> 
 </tbody> 
</table>

对 于GUI风格的独立性，我们建议使用StyledPanel代替。

### 2.3 enum QFrame::StyleMask ###

该枚举定义了两个常量，可用于提取frameStyle()的两个组件。

<table style="width:500px;"> 
 <tbody> 
  <tr> 
   <td style="width:167px;">QFrame::Shadow_Mask</td> 
   <td style="width:60px;">0x00f0</td> 
   <td style="width:272px;">控件的framStyle()返回值的shadow部分</td> 
  </tr> 
  <tr> 
   <td style="width:167px;">QFrame::Shape_Mask</td> 
   <td style="width:60px;">0x000f</td> 
   <td style="width:272px;">控件的framStyle()返回值的shape部分</td> 
  </tr> 
 </tbody> 
</table>

### 2.4 使用QFrame可实现的样式组合   ![a737577d677c4216bea213365636e78e.png][] ###

## 3、QFrame常用成员函数 ##

###  3.1 成员函数原型介绍 ###

<table style="width:672px;"> 
 <tbody> 
  <tr> 
   <td>成员函数原型</td> 
   <td style="width:331px;">&nbsp;描述</td> 
  </tr> 
  <tr> 
   <td>QFrame(QWidget *parent = nullptr, Qt::WindowFlags f = Qt::WindowFlags())</td> 
   <td style="width:331px;">构造函数</td> 
  </tr> 
  <tr> 
   <td>virtual&nbsp; &nbsp;~QFrame()&nbsp; &nbsp; &nbsp;</td> 
   <td style="width:331px;">析构函数</td> 
  </tr> 
  <tr> 
   <td>&nbsp;QRect&nbsp;frameRect() const&nbsp; &nbsp; &nbsp; &nbsp;</td> 
   <td style="width:331px;">获取QFrame的框架大小</td> 
  </tr> 
  <tr> 
   <td>void&nbsp;setFrameRect(const QRect &amp;)</td> 
   <td style="width:331px;">设置QFrame的框架大小</td> 
  </tr> 
  <tr> 
   <td>QFrame::Shadow&nbsp; frameShadow() const</td> 
   <td style="width:331px;">获取阴影样式，</td> 
  </tr> 
  <tr> 
   <td>void&nbsp;setFrameShadow(QFrame::Shadow)</td> 
   <td style="width:331px;">设置阴影样式，</td> 
  </tr> 
  <tr> 
   <td>QFrame::Shape&nbsp; frameShape() const</td> 
   <td style="width:331px;">获取框架的形状</td> 
  </tr> 
  <tr> 
   <td>void&nbsp;setFrameShape(QFrame::Shape)</td> 
   <td style="width:331px;">设置框架的形状</td> 
  </tr> 
  <tr> 
   <td>int&nbsp; frameStyle() const</td> 
   <td style="width:331px;">获取框架的形状和阴影样式</td> 
  </tr> 
  <tr> 
   <td>void&nbsp;setFrameStyle(int style)</td> 
   <td style="width:331px;">设置框架的形状和阴影样式</td> 
  </tr> 
  <tr> 
   <td>int&nbsp;lineWidth() const</td> 
   <td style="width:331px;">获取框架线的宽度</td> 
  </tr> 
  <tr> 
   <td>&nbsp;void&nbsp;setLineWidth(int)</td> 
   <td style="width:331px;">设置框架线的宽度</td> 
  </tr> 
  <tr> 
   <td>int&nbsp;midLineWidth() const</td> 
   <td style="width:331px;">获取框架中线的宽度</td> 
  </tr> 
  <tr> 
   <td>void&nbsp;setMidLineWidth(int)</td> 
   <td style="width:331px;">设置框架中线的宽度</td> 
  </tr> 
 </tbody> 
</table>

### 3.2 简单示例 ###

使用QFrame的子类QLabel完成简易登陆界面的设计，通过对QLabel框架样式的改变使其更符合QLineEdit、QPushButton等控件的风格。

//.h文件
     
    class Widget : public QWidget
    {
        Q_OBJECT
     
    public:
        Widget(QWidget *parent = nullptr);
        ~Widget();
    private:
     
        QLabel *useLabel;
        QLabel *pwLabel;
        QLabel *useEdit;
        QLabel *pwEdit;
        QLabel *checkBtn;
        QLabel *cancelBtn;
     
    };
     
    //.c文件
     
    Widget::Widget(QWidget *parent)
        : QWidget(parent)
    {
        this->resize(400,550);
        useLabel = new QLabel(this);
        useLabel->setText("用户名:");
        useLabel->move(70,150);
        useLabel->resize(50,30);
        //设置"用户名"标签的框架样式为 无边框+无阴影
        useLabel->setFrameShape(QFrame::NoFrame);
        useLabel->setFrameShadow(QFrame::Plain);
     
        useEdit = new QLabel(this);
        useEdit->move(150,150);
        useEdit->resize(200,30);
        //设置"用户名"输入框的框架样式为 边框+突起
        useEdit->setFrameStyle(QFrame::Box|QFrame::Raised);
        useEdit->setLineWidth(2);
     
     
        pwLabel = new QLabel(this);
        pwLabel->setText("密码:");
        pwLabel->move(70,210);
        pwLabel->resize(50,30);
        //设置"密码"标签的框架样式为 无边框+无阴影
        pwLabel->setFrameStyle(QFrame::NoFrame|QFrame::Plain);
     
        pwEdit = new QLabel(this);
        pwEdit->move(150,210);
        pwEdit->resize(200,30);
        //设置"用户名"输入框的框架样式为 内容+凹陷
        pwEdit->setFrameStyle(QFrame::Panel|QFrame::Sunken);
        pwEdit->setLineWidth(2);
     
        checkBtn = new QLabel(this);
        checkBtn->setText("确认");
        checkBtn->setAlignment(Qt::AlignCenter);
        checkBtn->move(100,290);
        checkBtn->resize(80,30);
        //设置"确认"按钮的框架样式为 内容+突起
        checkBtn->setFrameStyle(QFrame::Panel|QFrame::Raised);
        checkBtn->setLineWidth(3);
     
     
        cancelBtn = new QLabel(this);
        cancelBtn->setText("取消");
        cancelBtn->setAlignment(Qt::AlignCenter);
        cancelBtn->move(240,290);
        cancelBtn->resize(80,30);
        //设置"取消"按钮的框架样式为 内容+突起
        cancelBtn->setFrameStyle(QFrame::Panel|QFrame::Raised);
        cancelBtn->setLineWidth(3);
     
    }

效果图：

![c7a01421d3bb40de8e4f7c4d58076b8c.png][]

[a737577d677c4216bea213365636e78e.png]: https://img-blog.csdnimg.cn/a737577d677c4216bea213365636e78e.png
[c7a01421d3bb40de8e4f7c4d58076b8c.png]: https://img-blog.csdnimg.cn/c7a01421d3bb40de8e4f7c4d58076b8c.png