在上一篇 Qt 地址薄 (一) 界面设计 中,主要是实现了地址簿的界面,使用布局管理器进行元素的布局,并解释了 “子类化” 和 “所有权” 的概念。
本篇将在上面的基础上,在界面中新加三个 QPushButton 按钮,通过 “信号 - 槽函数” 机制,实现保存 Name 和 Address 内容的功能。
1 三个按钮
如下所示,在 AddressBook 的右侧,添加三个按钮,分别命名为 “Add”、“Submit” 和 "Cancel"
1.1 数据成员
这三个按钮与 AddressBook 是 "包含" 关系 (has-a),因此,可声明为 AddressBook 的数据成员
QPushButton *add_btn_;
QPushButton *submit_btn_; QPushButton *cancel_btn_;
为了保存输入的 Name 和 Address,声明一个 QMap<QString, QString> 类型的数据成员
QMap<QString, QString> contacts_;
为了保存 Name 和 Address 之前的内容,再声明两个 QString 类型的数据成员
QString old_name_;
QString old_addr_;
1.2 布局
新建 QVBoxLayout 型 layout_btn,将这三个按钮组合成一列,再将 layout_btn 加入到 主布局管理器 layout 中
// three btn
add_btn_ = new QPushButton(tr("Add"));
submit_btn_ = new QPushButton(tr("Submit"));
cancel_btn_ = new QPushButton(tr("Cancel"));
// new layout_btn
QVBoxLayout *layout_btn = new QVBoxLayout;
layout_btn->addWidget(add_btn_, Qt::AlignTop);
layout_btn->addWidget(submit_btn_);
layout_btn->addWidget(cancel_btn_);
layout_btn->addStretch();
// add layout_btn into layout
layout->addLayout(layout_btn,1,2);
1.3 addStrech() 函数
下图是布局管理器,调用 addStretch() 函数和未调用的区别
2 信号槽
2.1 功能描述
1) Add 功能
QLineEdit 和 QTextEdit 的默认为只读,若点击 Add 按钮,二者状态变为可编辑。此时,用户可输入 Name 和 Address 的内容。同时,显示出 Submit 和 Cancel 两个按钮
2) Submit 功能
点击 Submit 按钮,可将用户输入的 Name 和 Address 保存到程序中。若输入为空,则提示请输入的信息;若该 Name 已经添加过,则提示已经添加
3) Cancel 功能
点击 Cancel 按钮,可将用户输入的 Name 和 Address 取消掉,不进行保存,同时显示出之前的 Name 和 Address
2.2 信号槽机制
信号槽机制,主要用于 类对象之间的通信,是 Qt 的精髓所在,与之类似的有:观察者模式,回调机制等
当特定的事件发生后,相应的信号被发出,则与该信号 connect 的槽函数,随后被调用
2.3 connect 函数
使用 connect 函数,将发射信号的 类对象 + 信号,以及接收信号的 类对象 + 槽函数,连接起来
具体的实现代码如下:
connect(add_btn_, SIGNAL(clicked()), this, SLOT(OnAdd()));
connect(submit_btn_, SIGNAL(clicked()), this, SLOT(OnSubmit()));
connect(cancel_btn_, SIGNAL(clicked()), this, SLOT(OnCancel()));
3 槽函数
头文件中声明了三个槽函数,如下所示:
public slots:
void OnAdd();
void OnSubmit();
void OnCancel();
3.1 OnAdd() 函数
void AddressBook::OnAdd()
{
old_name_ = name_line_->text(); // 保存以前的 Name 和 Address
old_addr_ = addr_text_->toPlainText();
name_line_->clear();
addr_text_->clear();
name_line_->setReadOnly(false); // 设置 QLineEdit 和 QTextEdit 可编辑
name_line_->setFocus(Qt::OtherFocusReason);
addr_text_->setReadOnly(false);
add_btn_->setEnabled(false); // 显示 Submit 按钮 和 Cancel 按钮
submit_btn_->show();
cancel_btn_->show();
}
3.2 OnSubmit() 函数
void AddressBook::OnSubmit()
{
QString name = name_line_->text();
QString address = addr_text_->toPlainText();
if (name.isEmpty() || address.isEmpty()) {
QMessageBox::information(this, tr("Empty Field"), tr("Please enter a name and address."));
return;
}
if (!contacts_.contains(name)) {
contacts_.insert(name, address);
QMessageBox::information(this, tr("Add Successful"), tr("\"%1\" has been added to your address book.").arg(name));
} else {
QMessageBox::information(this, tr("Add Unsuccessful"), tr("Sorry, \"%1\" is already in your address book.").arg(name));
return;
}
if (contacts_.isEmpty()) {
name_line_->clear();
addr_text_->clear();
}
name_line_->setReadOnly(true);
addr_text_->setReadOnly(true);
add_btn_->setEnabled(true);
submit_btn_->hide();
cancel_btn_->hide();
}
3.3 OnCancel() 函数
void AddressBook::OnCancel()
{
name_line_->setText(old_name_);
name_line_->setReadOnly(true);
addr_text_->setText(old_addr_);
addr_text_->setReadOnly(true);
add_btn_->setEnabled(true); // 设置 Add 按钮使能
submit_btn_->hide(); // 隐藏 Submit 和 Cancel 按钮
cancel_btn_->hide();
}
参考资料:
Qt 5.9 | Qt Widgets | Part 2 - Adding Addresses