QT_6-常用控件

QT_6-常用控件

Qt为我们应用程序界面开发提供的一系列的控件，下面我们介绍两种最常用的两种，所有控件的使用方法我们都可以通过帮助文档获取。

QLabel

QLabel是我们最常用的控件之一，其功能很强大，我们可以用来显示文本，图片和动画等。
显示文字 （普通文本、html）
通过QLabel类的setText函数设置显示的内容:
void setText(const QString &)

• 可以显示普通文本字符串
  QLable *label = new QLable;
  label->setText(“Hello, World!”);
• 可以显示HTML格式的字符串
  比如显示一个链接:

QLabel * label = new QLabel(this);
label ->setText("Hello, World");
label ->setText("

百度一下
");
label ->setOpenExternalLinks(true);

其中setOpenExternalLinks()函数是用来设置用户点击链接之后是否自动打开链接，如果参数指定为true则会自动打开，如果设置为false，想要打开链接只能通过捕捉linkActivated()信号，在自定义的槽函数中使用QDesktopServices::openUrl()打开链接，该函数参数默认值为false

QLabel * label = new QLabel(this);
label ->setText("Hello, World");
label ->setText("

百度一下
");
// label->setOpenExternalLinks(true);
connect(label, &QLabel::linkActivated, 
this, &MyWidget::slotOpenUrl);

//槽函数   
void MyWidget::slotOpenUrl(const QString &link)
{
    QDesktopServices::openUrl(QUrl(link));
}

• 显示图片
  可以使用QLabel的成员函数setPixmap设置图片
  void setPixmap(const QPixmap &)
  首先定义QPixmap对象
  QPixmap pixmap;
  然后加载图片
  pixmap.load(":/Image/boat.jpg");
  最后将图片设置到QLabel中
  QLabel *label = new QLabel;
  label.setPixmap(pixmap);
• 显示动画
  可以使用QLabel 的成员函数setMovie加载动画，可以播放gif格式的文件
  void setMovie(QMovie * movie)
  首先定义QMovied对象，并初始化:
  QMovie movie = new QMovie(":/Mario.gif");
  播放加载的动画：
  movie->start();
  将动画设置到QLabel中：
  QLabel label = new QLabel；
  label->setMovie(movie);

QLineEdit

Qt提供的单行文本编辑框。
设置/获取内容

获取编辑框内容使用text（），函数声明如下：

QString text() const

设置编辑框内容

void setText(const QString &)

设置显示模式

使用QLineEdit类的setEchoMode () 函数设置文本的显示模式,函数声明:
void setEchoMode(EchoMode mode)
EchoMode是一个枚举类型,一共定义了四种显示模式:

• QLineEdit::Normal 模式显示方式，按照输入的内容显示。
• QLineEdit::NoEcho 不显示任何内容，此模式下无法看到用户的输入。
• QLineEdit::Password 密码模式，输入的字符会根据平台转换为特殊字符。
• QLineEdit::PasswordEchoOnEdit 编辑时显示字符否则显示字符作为密码。

另外，我们再使用QLineEdit显示文本的时候，希望在左侧留出一段空白的区域，那么，就可以使用QLineEdit给我们提供的setTextMargins函数：
void setTextMargins(int left, int top, int right, int bottom)
用此函数可以指定显示的文本与输入框上下左右边界的间隔的像素数。

设置输入提示

如果我们想实现一个与百度的搜索框类似的功能：输入一个或几个字符，下边会列出几个跟输入的字符相匹配的字符串，QLineEdit要实现这样的功能可以使用该类的成员函数setComleter()函数来实现:

void    setCompleter(QCompleter * c)
//创建QCompleter对象，并初始化
QStringList tipList;
tipList<< “Hello” << “how are you” << “Haha” << “oh, hello”;
// 不区分大小写
completer->setCaseSensitivity(Qt::CaseInsensitive);
QCompleter *completer = new QCompleter(tipList, this);
/*
QCompleter类的setCaseSensitivity()函数可以设置是否区分大小写，它的参数是一个枚举类型：
Qt::CaseInsensitive 不区分大小写
Qt::CaseSensitive    区分大小写
如果不设置该属性，默认匹配字符串时是区分大小写的。
另外我们还可以设置字符串其中某一部分匹配，此功能可通过QCompleter类的setFilterMode函数来实现,函数声明如下
void    setFilterMode(Qt::MatchFlags filterMode)
其参数为Qt定义的宏,有多重类型,具体可参考Qt帮助稳定，要实现我们上边提到的功能，参数可以使用 Qt::MatchContains：: */
completer->setFilterMode(Qt::MatchContains);
//属性设置完成之后，将QCompleter对象设置到QLineEdit中：
QLineEdit *edit = new QLineEdit(this);
edit->setCompleter(completer);

布局管理器

所谓 GUI 界面，归根结底，就是一堆组件的叠加。我们创建一个窗口，把按钮放上面，把图标放上面，这样就成了一个界面。在放置时，组件的位置尤其重要。我们必须要指定组件放在哪里，以便窗口能够按照我们需要的方式进行渲染。这就涉及到组件定位的机制。
Qt 提供了两种组件定位机制：绝对定位和布局定位。

• 绝对定位就是一种最原始的定位方法：给出这个组件的坐标和长宽值。
  这样，Qt 就知道该把组件放在哪里以及如何设置组件的大小。但是这样做带来的一个问题是，如果用户改变了窗口大小，比如点击最大化按钮或者使用鼠标拖动窗口边缘，采用绝对定位的组件是不会有任何响应的。这也很自然，因为你并没有告诉 Qt，在窗口变化时，组件是否要更新自己以及如何更新。或者，还有更简单的方法：禁止用户改变窗口大小。但这总不是长远之计。

• 布局定位：你只要把组件放入某一种布局，布局由专门的布局管理器进行管理。当需要调整大小或者位置的时候，Qt 使用对应的布局管理器进行调整。
  布局定位完美的解决了使用绝对定位的缺陷。

• Qt 提供的布局中以下三种是我们最常用的：
  QHBoxLayout：按照水平方向从左到右布局；
  QVBoxLayout：按照竖直方向从上到下布局；
  QGridLayout：在一个网格中进行布局，类似于 HTML 的 table；

例:

int main(int argc, char *argv[])
{
    QApplication app(argc, argv);

    QWidget window;
    window.setWindowTitle("Enter your age");

    QSpinBox *spinBox = new QSpinBox(&window);
    QSlider *slider = new QSlider(Qt::Horizontal, &window);
    spinBox->setRange(0, 130);
    slider->setRange(0, 130);

QObject::connect(slider, &QSlider::valueChanged, 
spinBox, &QSpinBox::setValue);
    void (QSpinBox:: *spinBoxSignal)(int) = &QSpinBox::valueChanged;
QObject::connect(spinBox, spinBoxSignal, 
slider, &QSlider::setValue);
    spinBox->setValue(35);

      //给控件设置布局
    QHBoxLayout *layout = new QHBoxLayout;
    layout->addWidget(spinBox);
    layout->addWidget(slider);
window.setLayout(layout);

    window.show();
    return app.exec();
}

我们在这段代码中引入了两个新的组件：QSpinBox和QSlider。QSpinBox就是只能输入数字的输入框，并且带有上下箭头的步进按钮。QSlider则是带有滑块的滑竿
上面的代码中window.setLayout(layout); 是将布局设置到窗口window中，在窗口中设置布局还有另一种写法：
//给控件设置布局
QHBoxLayout *layout = new QHBoxLayout（window）;
layout->addWidget(spinBox);
layout->addWidget(slider);
在创建布局对象的时候给新对象指定父窗口，就等于给传入的窗口设置了布局。
另外布局与布局之间是可以嵌套使用的，使用addLayout（）方法。QVBoxLayout的使用方法与QHBoxLayout完全相同。

• 关于上述代码中信号和槽连接的解释：
  当数字输入框显示的内容发生改变的时候，会发出一股信息，滑块会接收这一信号，并作出改变。如果二者的信号槽连接写成下边这样：
  QObject::connect(spinBox, &QSpinBox::valueChanged,
  slider, &QSlider::setValue);
  编译器却会报错
  no matching function for call to 'QObject::connect(QSpinBox&, , QSlider &, void (QAbstractSlider::)(int))'
  这是怎么回事呢？从出错信息可以看出，编译器认为QSpinBox::valueChanged是一个 overloaded 的函数。我们看一下QSpinBox的文档发现，QSpinBox的确有两个信号：
  void valueChanged(int)
  void valueChanged(const QString &)
  当我们使用&QSpinBox::valueChanged取函数指针时，编译器不知道应该取哪一个函数（记住前面我们介绍过的，signal 也是一个普通的函数。）的地址，因此报错。解决的方法很简单，编译器不是不能确定哪一个函数吗？那么我们就显式指定一个函数。方法就是，我们创建一个函数指针，这个函数指针参数指定为 int：
  void (QSpinBox:: spinBoxSignal)(int) = &QSpinBox::valueChanged;
  然后我们将这个函数指针作为 signal，与 QSlider 的函数连接：
  QObject::connect(spinBox, spinBoxSignal,
  slider, &QSlider::setValue);
  这样便避免了编译错误。