QLabel 类代表标签,它是一个用于显示文本或图像的窗口部件。
构造
QLabel 类支持以下构造函数:
- QLabel(QWidget *parent = 0, Qt::WindowFlags f = 0);
- QLabel(const QString &text, QWidget *parent = 0, Qt::WindowFlags f= 0);
其中第二个构造函数能够同时通过参数 text 给出要显示的文本,因此是最常用的构造方式。
属性
QLabel 对象的显示内容可以通过属性获取或修改,相关成员函数如下:
- QString text() const; // 获取显示的文本
- void settext(const QString &text); // 设置显示的文本,这是一个槽
- const QPixmap *pixmap() const; // 获取显示的图像
- void setPixmap(const QPixmap &pixmap); // 设置显示的图像,这时一个槽
- void setNum(int num); // 设置显示的文本为代表整数 num 的字符串,这是一个槽
- void setNum(double num); // 设置显示的文本为代表浮点数 num 的字符串,这时一个槽
其中进行设置的函数同时也都是槽。新设置的内容将取代原来的内容。
用以下的成员函数则可以清空显示内容:
- void clear(); // 清空显示内容
alignment 属性代表内容的对齐方式,相关函数成员如下:
- Qt::Alignment alignment() const; // 获取对齐方式
- void setAlignment(Qt::Alignment align); // 设置对齐方式
这里的 Qt::Alignment 类型有以下取值。
1)Qt::AlignLeft::水平方向靠左。
2)Qt::AlignRight:水平方向靠右。
3)Qt::AlignHCenter:水平方向居中。
4)Qt::AlignJustify:水平方向调整间距两端对齐。
5)Qt::AlignTop:垂直方向靠上。
6)Qt::AlignButton:垂直方向靠下。
7)Qt::AlignVCenter:垂直方向居中。
8)Qt::AlignCenter:等价于 Qt::AlignHCenter | Qt::AlignVCenter。
其中一个水平方向的取值和一个垂直方向的取值可以用 “按位或” 的方式组合起来以同时指定两个方向的对齐方式。默认的对齐方式为水平靠左、垂直居中。
indent 属性代表文本的缩进值,相关的成员函数如下:
- int indent() const; // 获取文本缩进值
- void setIndex(int indent); //设置文本缩进值
margin 属性代表显示内容的边距,相关的成员函数如下:
- int margin() const; // 获取边距
- void setMargin(int margin); // 设置边距
wordWrap 属性代表显示的文本是否允许换行,相关的成员函数如下:
- bool wordWrap() const; // 判断是否允许换行
- void setWordWrap(bool on); // 设置是否允许换行
scaledContents 属性表示显示图像时是否允许缩放,相关的成员函数如下:
- bool hasScaledContenes() const; // 判断是否允许图像缩放
- void setScaledContents(bool on); // 设置是否允许图像缩放
如果允许缩放,则显示图像时会进行缩放以填满整个显示区域。