用Qt写软件系列五：一个安全防护软件的制作（2）

引言

       在上一篇中讲述了主窗体的创建和设计。主窗体的无边框效果、阴影效果、拖动事件处理、窗体美化等工作在前面的博客中早就涉及，因此上篇博文中并未花费过多笔墨。这一篇继续讲述工具箱（Tool Button）的实现。另外，在实现的过程中还做了另外一个贴心的小功能：可伸缩的侧边栏。不过后来发现应用起来后效果不佳，于是就没在主窗体中加入这个功能了，单独做了一个demo作为示范。

工具箱的实现

       工具箱是将若干的工具按钮组织在一起，为用户提供简便导航功能的一个组件。在Qt中实现这个功能不难，Qt库本身就提供了QToolButton和QToolBox两个类用于类似功能。在这里我们从QToolButton类派生一个子类自定义按钮动作。QToolButton类本身只提供了一些基本功能。因此我们需要实现一些事件处理器来自定义工具按钮的动作和外观。

       看码说话：

CustomToolButton::CustomToolButton(const QString& path, QWidget *parent)
	: QToolButton(parent), m_filePath(path)
{
	// Get the widget's palette, we do have to change the color of the tool button.
	QPalette text_palette = palette();
	text_palette.setColor(QPalette::ButtonText, QColor(230, 230, 230));
	setPalette(text_palette);
	// set the style of QToolButton.
	setToolButtonStyle(Qt::ToolButtonTextUnderIcon);
	// set the font style of tool buttons
	// since the return value has the type of const, we have to remove the
	// constness if we want to modify.
	QFont text_font = const_cast<QFont&>(font());
	text_font.setBold(true);
	setFont(text_font);
	// set the fixed size for tool buttons.
	QPixmap background(m_filePath);
	setIcon(background);
	setIconSize(background.size());
	setFixedSize(background.width()+25, background.height()+25);

	setAutoRaise(true);
	m_mousePressed = false;
	m_mouseHover = false;
}
/*
 * Arguments topColor, centerColor, bottomColor are alpha values for QColor.
 */
void CustomToolButton::doPaintStuff(int topColor, int centerColor, int bottomColor)
{
	QPainter painter(this);
	QPen p(Qt::NoBrush, 1);
	painter.setPen(p);
	// create linear gradient brush to draw the widget
	QLinearGradient linear(rect().topLeft(), rect().bottomLeft());
	linear.setColorAt(0, QColor(230, 230, 230, topColor));
	linear.setColorAt(0.5, QColor(230, 230, 230, centerColor));
	linear.setColorAt(1, QColor(230, 230, 230, bottomColor));

	// paint the widget.
	painter.setBrush(linear);
	painter.drawRect(rect());
}

void CustomToolButton::setButtonPressed(bool isPressed)
{
	m_mousePressed = isPressed;
	update();
}

void CustomToolButton::enterEvent(QEvent *)
{
	m_mouseHover = true;
	update();
}

void CustomToolButton::leaveEvent(QEvent *)
{
	m_mouseHover = false;
	update();
}

void CustomToolButton::paintEvent(QPaintEvent *event)
{
	if (m_mouseHover)
	{
		doPaintStuff(0, 100, 150);
	}
	else
	{
		if (m_mousePressed)
		{
			doPaintStuff(0, 100, 150);
		}
	}
	QToolButton::paintEvent(event);
}

void CustomToolButton::mousePressEvent(QMouseEvent *event)
{
	if (event->button() == Qt::LeftButton)
	{
		emit clicked();
	}
}

　　 在该子类中我们重写了enterEvent()，leaveEvent(), paintEvent(), mousePressEvent()这几个事件处理函数。分别对应鼠标进入、离开、点击按钮区域事件，paintEvent()则用于绘制按钮的外观。此外，还是用了几个状态变量，用于记录鼠标当前的移动状态。利用这些状态，我们就能顺利实现不同状态的外观绘制。值得注意的是doPaintStuff()这个函数。这个函数实际做的工作是给工具按钮添加垂直的渐变效果。使用了QLinearGradient这个类，可以实现线性的渐变效果，这在很多界面元素设计中都非常有用。

       在主函数中怎么调用这个自定义的按钮类呢？

MainWin::MainWin(QWidget *parent)
	: QWidget(parent)
{
	ui.setupUi(this);
	
	setWindowTitle("Tool Button");
	QStringList string_list;
	string_list<<":/toolWidget/tiJian"<<":/toolWidget/muMa"<<":/toolWidget/repair"<<":/toolWidget/qingLi"
		<<":/toolWidget/jiaSu"<<":/toolWidget/expert"<<":/toolWidget/menZhen"<<":/toolWidget/gongNeng";

	QVBoxLayout *layout = new QVBoxLayout(this);
	QHBoxLayout *button_layout = new QHBoxLayout(this);

	QSignalMapper *signal_mapper = new QSignalMapper(this);
	for(int i=0; i< string_list.size(); i++)
	{
		CustomToolButton *tool_button = new CustomToolButton(string_list.at(i));
		tool_button->setText("Test");
		button_list.append(tool_button);
		connect(tool_button, SIGNAL(clicked()), signal_mapper, SLOT(map()));
		signal_mapper->setMapping(tool_button, QString::number(i, 10));

		button_layout->addWidget(tool_button, 0, Qt::AlignBottom);
	}
	layout->addLayout(button_layout);
	layout->addStretch();
	setLayout(layout);

}

　　 从代码中看，我们用了一个循环生成了若干个自定义按钮，然后全部放到水平布局管理器中进行管理。这个很容易理解，重点内容是QSignalMapper类的应用。QSignalMapper类是一个工具类，它主要的功能是将一组无参数信号集中管理，将信号用整型值或字符串值表示，然后再以一种统一的形式发送出去。其好处是，当有很多的信号需要统一管理的时候非常方便，不用手动调用connect()为信号绑定槽函数，因此代码结构也更为简练。在上面的代码中，我们将按钮点击信号转换为数值形式表示。这样也是很自然的做法，一方面形式简单，另一方面水平排列的工具按钮按序编号符合人类习惯。

可伸缩的侧边栏

       还是看看什么叫做可伸缩的侧边栏，这样的功能在QQ的聊天窗口就可以看见：

       侧边栏的收缩可以在需要的时候隐藏部分组件，从而为其他组件提供更为广阔的视角。如上图中的侧边栏收缩为文本框组件提供更多的空间，整个界面上看起来也更为清爽。稍微一剖析：这个边栏要能点击，点击之后要切换图标，响应的组件要隐藏。如此一分析，代码可如下编写：

TestSideBar::TestSideBar(QWidget *parent)
	: QMainWindow(parent)
{
	ui.setupUi(this);
	flag = false;
	mainLayout = new QHBoxLayout(this);

	mainSplitter = new QSplitter(Qt::Horizontal, this);
	mainSplitter->setFrameStyle(QFrame::NoFrame);
	mainSplitter->setHandleWidth(1);
	mainSplitter->setChildrenCollapsible(false);

	zoomButton = new QPushButton(this);
	zoomButton->setSizePolicy(QSizePolicy::Expanding, QSizePolicy::Expanding);
	zoomButton->setIcon(QIcon(":/right"));
	zoomButton->setFixedWidth(6);
	zoomButton->setFocusPolicy(Qt::NoFocus);
	zoomButton->setStyleSheet("background: #E8E8E8; border: none; padding: 0px;");

	leftWidget = new QWidget(this);
	leftWidget->setStyleSheet("background: yellow;");
	rightWidget = new QWidget(this);
	rightWidget->setStyleSheet("background: blue;");

	mainSplitter->addWidget(leftWidget);
	mainSplitter->addWidget(rightWidget);

	mainLayout->addWidget(zoomButton);
	mainLayout->addWidget(mainSplitter);
	mainLayout->setSpacing(0);
	mainLayout->setContentsMargins(0, 0, 0, 0);

	QWidget* w = new QWidget(this);
	w->setLayout(mainLayout);
	setCentralWidget(w);

	connect(zoomButton, SIGNAL(clicked()), this, SLOT(onZoomClicked()));
}

void TestSideBar::onZoomClicked()
{
	if (flag)   // 根据当前的展开状态，进行切换
	{
		flag = false;
		zoomButton->setIcon(QIcon(":/left"));
		leftWidget->setVisible(true);
	}
	else
	{
		flag = true;
		zoomButton->setIcon(QIcon(":/right"));
		leftWidget->setVisible(false);
	}
}

　　

       可以发现这里的侧边栏果然一直固定在最左侧，要达到QQ聊天界面那要的效果呢，只需要改几行代码就好了：

TestSideBar::TestSideBar(QWidget *parent)
	: QMainWindow(parent)
{
        // 其他保持不变，省略……

	mainSplitter->addWidget(leftWidget);
	mainSplitter->addWidget(zoomButton);
	mainSplitter->addWidget(rightWidget);

	mainLayout->addWidget(mainSplitter, 1);
	mainLayout->setSpacing(0);
	mainLayout->setContentsMargins(0, 0, 0, 0);

        // 其他保持不变，省略……
}

　　

小结

       这一篇主要讲了上篇遗留的一个功能，工具按钮组的开发。另外，实现了另外一个功能：侧边栏的伸缩。下一篇继续树形控件(tree widget)、堆栈式窗口布局(stacked layout)的讲解。