Chatper 6 Layout Management
6.1 Laying Out Widgets on a Form
Qt提供的的基本的Layout Manager包括:QHBoxLayout,QVBoxLayout,QGridLayout和QStackLayout。
Qt中其它能完成Layout management功能的类包括 QSplitter,QScrollArea,QMainWindow和QWorkspace。
Qt中管理child widget的layout共有三种方式:absolute positioning, manual layout和layout managers。
Absolute positioning:即由程序员通过hard-coded的形式管理child widget的位置和尺寸。
Manual Layout:child widget的位置依然由程序员通过hard-coded的方式确定,而尺寸与父窗口的大小成一定比例,而不是完全的hard-coded。这种方式通过对form的resizeEvent()进行再实现来对child widget的定位。
最重要的三个Layout Manger是QHBoxLayout,QVBoxLayout,QGridLayOut,他们都是派生自QLayout
QGridLayout的使用略微有些复杂,它工作在一个由Cell组成的二维grid上。对于QGridLayout,为其添加widget的方式如下:
layout->addWidget(widget,row ,colum,rowSpan,columnSpan)
其中widget为待添加的child widget, row和clomun确定该widget所占据空间中左上角那个Cell的位置坐标,rowSpan和columnSpan则指定widget的大小,这两个参数的的缺省值为1。
addStretch()向Layout Manager中添加“占位符”。
每个widget都有自己的size policy,由其告知layout 系统如何处理该widget外形上的stretch或是shrink。Qt中widget的size policy是通过QSizePolicy类来表示的。每个QSizePolicy由水平和竖直两组size policy组成,最常见的值包括:
Fixed Minimum Maximum Prefered Expanding
除了上述两组size policy外,QSizePolicy中还存储水平和竖直方向的stretch factor,该值用来表明在form尺寸扩展时widget随之扩展的比率。
6.2 Stacked Layouts
QStackLayout 类可以管理多个page,但每次只显示其中之一,而将其他page向用户隐藏。
QStackLayout类本身是不可见的。
为了方便起见,Qt包含有QStackedWidget类,即一个内置了QStackedLayout的QWidget。
6.3 Splitter
类QSplitter是一个能包含其他widget的widget。QSplitter中包含的widget按顺序排列,并被splitter handle相互分隔开。
QSplitter通过构造函数中的参数来来决定是水平方向还是竖直方向。
不同于前面介绍的Layout Mangener们只是负责处理widget的layout而自身没有可视化的表示,QSplitter派生自QWidget,因此可以同其它widget一样的被使用。
QSplitter类提供了存储自身状态的两个函数:savestate()和restorestate()。
6.4 Scrolling Areas
QScrollArea类提供了1个可滑动的viewport和2个滑动条。
QScrollArea的使用方法是调用其提供的setWidget()函数,将希望为其添加滑动条的widget添加。QScrollArea自动将添加进来的widget的parent设定为其viewport,而其viewpoint可通过QScrollArea::viewport()进行访问。
QScrollArea的多数功能是通过继承QAbstraceScrollArea类而获得的。而诸如QTextEdit和 QAbstractIterView这样的类是派生自QAbstractScrollArea的,因此不需要将其用QScrollArea类包裹起来以获得scroll bar。
6.5 Dock Widgets and Toolbars
在Qt中,dock widget是通过QDockWidget类来实现的。
每个dock widget都有自己的title bar。
从Qt4开始,toolbar拥有自己专属的显示空间,而不再是如之前的版本中允许dock widget与其分享。
对一个widget调用setAllowedArea()可以指定允许在那些dock areas上放置该widget。
6.6 Multiple Document Interface
Qt中,编写MDI程序是通过使用QWorkspace类,将其作为程序的central widget,并把每个文档窗口都作为QWorkspace的child。
Qt程序的命令行参数中与Qt相关的参数,会由QApplication的构造函数负责自动移除掉,不会传递给Qt程序的main()函数。
Chapter 7 Event Processing
Qt中大多数event都是作为对用户操作的响应而产生的,但也有一些是系统内部独立生成的。
在使用Qt进行编程时,通常很少需要考虑event,因为Qt中的widget会在有重要事件发生时emit signal。Event在我们要编写自定义widget或是要修改现有Qt widget的特性时,则变得很重要。
不要在概念上将event和signal两个概念混淆。当程序员操纵使用widget时,signal是需要关注的对象;而当程序员需要实现一个widget时,event则是需要关注的对象。
例如,当使用QPushButton时,我们更关注其提供的clicked() signal 而不是导致该signal被QPushButton emit的低层次的鼠标或键盘event。但是如果我们要自己实现一个类似于QPushButton的类,那就轮到我们编写代码来处理鼠标和键盘操作,并在必要时emit clicked() signal。
7.1 Reimplementing Event Handles
Qt中,每个event都是一个派生自QEvent的对象。Qt中包含超过100种的event,每种event有一个enum value进行标识。
QEvent::type()返回event type。
所有event都是通过其对应类中的event()函数,来向对象发送通告的;这个event()函数继承自QObject。QWidget中 event()的实现是将最常见类型的event转发给对应的event handlers,例如mousePressEvent(),keyPress-Event,painEvent()。
键盘event对应的event handler是keyPressEvent()和keyReleaseEvent()。
QKeyEvent::modifiers()
Tab键和Shift+Tab键的处理有些特殊,它们不是由keyPressEvent()负责处理,而是在QWidget::event()中进行处理,而且发生在调用keyPressEvent()之前,处理方式是将输入焦点按照链中的顺序向后或向前传递。
实现key binding的更高层次的实现方式是利用QAction。QAction类内部使用了QShortCut类来实现key binding。
QObject::startTimer() 用于创建定时器,并返回相应的ID。QObject支持多个定时器同时存在。
killTimer()用于销毁定时器,参数为定时器的ID。
Timer event位于底层,实现定时功能更简单的方式是使用QTimer类,QTimer会定期的emit timeout() siganl。
7.2 Installing Event Filter
Qt的evnet model中很强大的一个特性,就是可以设定某个对象来监控另外一个对象,后者所有的event在对其可见前都要先通过前一个对象的监控和处理。
Qt中设置event filter涉及到两步操作:
1. 在要被监控的对象中调用installEventFilter() 来完成对监控者的注册。
2 在监控者的eventFilter() 中对被监控者的event进行处理。
Qt的event model中,一个event若未得到处理(event handler的返回值为false),则Qt会负责将该event向上传递,即交由其parent负责处理
Qt中对event的处理可以分为下面5个层次:
1. 对某个特定的event handler进行重实现
2. 对Widget中的QObject::event()进行重实现,这样在event被传递给特定的event handler之前就得到了处理。
3. 为某个对象安装event filter
4. 为QApplication object安装filter,这样可以监控应用程序中所有对象收到的所有event,在进行debug是非常有用。
5. 派生QAapplication的子类,并对notify()进行重实现。Qt调用notify()来发送event的。这是捕获所有event的唯一方法。
7.3 Staying Responsive During Intensive Processing
在完成耗时操作的同时,还要保证程序能够对用户操作正常相应,常见的解决机制是多线程。
一种简单的解决方案是在耗时操作的过程中有规律的调用QApplication::processEvnets()。该函数通知Qt处理pending events,处理结束后再将控制权返回至调用者。
Qt中的进度对话框是由QProgressDialog类来实现的。
除了使用多线程和进度对话框外,还存在一种完全不同的处理耗时操作的方法:操作只在程序空闲(无用户交互)时再进行,而不是立刻开始执行。
这种方法可以利用0-milisecond timer来实现,每次定时器触发时,检查是否有pending event,若无则继续好事操作,若有则处理event,完成与用户的交互。
Chapter 9 Drag and Drop
9.1 Enabling Drag and Drop
默认情况下,QTextEdit这个widget接受来自于其他程序的文本拖拽的;如果用户将一个文件拖拽至其上,它会将文件名插入显示文本。可以调用setAcceptDrops()来允许或禁止接受拖拽。
dragEnterEvent() ,该函数在用户将一个对象拖(drag)至widget之上时被调用,其参数为QDragEnterEvent类型的指针。
默认情况下,widget不接受用户的拖拽行为;若对该指针调用acceptProposedAction(),则是告知Qt允许该widget接受用户的拖拽行为,Qt会通过改变鼠标形状来提示用户。
dropEvent() ,该函数在用户将一个对象拽(drop)至widget之上时被调用,参数为QDropEvent类型的指针。
QWidget类还提供了dragMoveMent()和dragLeaveEvent()这两个函数,但对于大多数应用而言不需要对其进行再实现。
mousePressEvent(): 鼠标被按下时该函数被调用
mouseMoveEvent() :鼠标保持按下的状态且移动时,该函数被调用。
QDrag类使用QMimeData类来存储与拖拽操作相关的信息。
9.2 Supporting Custom Drag Types
可以从以下三种机制中进行选择:
1. 在源这一边调用QMimeData::setData(),将信息存储在QByteArray中,而在接受者这一方,调用QMimeData::data()将信息提取出来。
2. 对QMimeData进行派生,在子类中对formats()和retrieveData()这两个函数进行重新实现,来处理自定义数据。
3. 如果拖拽动作发生在一个应用程序的内部,那么可以对QMimeData进行派生,将信息存储在该子类中。
QMimeData::formats()返回其支持的MIME类型列表。
QMimeData::retrieveData()将某个指定MIME类型的数据以QVariant的形式返回。QMimeData所提供 text()、html()、urls()、data()等接口函数,都是依靠retrieveData()来完成底层操作的。
9.3 Clipboadr Handling
Qt中通过QApplication::clipboard()来获得对QClipboard的指针。对系统clipboard的写操作通过 setText(),setImage或setPixmap()完成,而读操作则通过text(),image()和pixmap()来完成。
QClipboard::setMimeData()
QClipboard::MimeData()
QClipboard::supportsSelection() 在X11平台下返回true,其他环境下返回fasle。
如果希望每当clipboard中的内容发生变动时收到通知,可以利用Qt提供的QClipboard::dataChanged()这个slot
Chapter 10 Item View Classes
MVC机制:Model-View-Controller
Qt中提供一种模仿MVC的model/viewer机制。
Qt中的delegate这个抽象概念与Controller略微不同,它负责为item的生成和编辑提供良好的控制。
Qt为每种类型的view都提供了默认的delegate,这对于大多数应用程序已经足够了,通常情况下程序员不需要考虑delegatd的问题。
可以为一个model注册两个或更多的view,Qt自动保持多个view之间数据的同步和一致性,当数据在某个view中被修改后,会自动在其他相关view中反映出来。
大多数情况下,程序向用户提供的item的数量并不庞大,因此可以简单的使用Qt内置的item view clas(QListWidget,QTableWidget和QtreeView),而没有必要使用Qt提供的model/view 机制。但对于成员数量很大的数据集,采用model/view机制则是明智的选择。
10.1 Using Item View Convenience Classes
QListWidget
QListWidget中包含多个roles,每个都与一个QVariant变量关联。最常用的roles由Qt::DisplayRole,Qt::EditRole,Qt::IconRole
对于上述role,Qt都提供了方便的接口函数用于读写数据。程序员还可以对role进行自定义,通过Qt::UserRole或更大的数值进行标识。
默认情况下QListWidget是只读的,需要调用QAbstractItemView::setEditTriggers()为其设定能引发编辑操作的动作。
QTableWidget
默认情况下QTableWidget是允许编辑的,可以调用QAbstractItemView::setEditTriggers(QAbstractItemView::NoEditTriggers)来禁止编辑。
QtreeWidget
默认情况下,QtreeWidget是只读的。
10.2 Using Predefined Models
Qt提供的预定义model有以下几种:
QStringListModel 存储一组字符串
QStandardItemModel 存储任意层次结构的数据
QDirModel 对文件系统进行封装
QSqlQueryModel 对SQL的查询结果集进行封装
QSqlTableModel 对SQL中的table进行封装
QSqlRelationalTableModel 对带有foreign key的SQL table进行封装
QSortFilterProxyModel 对另一个model执行sort and/or filter
model中存放的每项数据都有相应的"model index",由QModelIndex类来表示。
每个index由三个部分构成:row,column和表明所属model的指针。对于一维的list model,column部分永远为0。
在model/view 机制中,对数据的操作都是通过model执行的,而model负责保证在数据发生变动时view自动更新。
QDirModle::mkdir()——创建文件夹的工作可以通过QDir类来完成,不过QDirModel提供了工作于QModelIndex之上更方便的函数。
不同于其它model,QSortFilterProxyModel对一个已有的model进行封装,并完成数据在底层modle和view之间的传递。
setSourceModel()
10.3 Implementing Custom Models
model中的每项数据都有对应的index和一组称为“role”的属性,其中最常用的有Qt::DisplayRole和Qt::EditRole。
对于list和table这两类model,其中每个元素的parent都是root,即表示为一个invalid QModelIndex。
而对于tree model,某些元素的parent为root,而有些元素的parent为model中的其它元素。
Qt中提供了几种model 基类,包括 QAbstractListModel,QAbstractTableModel和QAbstractItemModel ,其中QAbstractItemModel是另外两者的基类,用于支持范围很广的modles,包括具备递归层次结构的;而 QAbstractListModel用于支持一维数据集,QAbstractTableModel用于支持二维数据集。
实际上要创建只读的自定义model的话,并不是件困难的事情。
要自定义只读的table model的话,需要重新实现rowCount(),columnCount()和data()这三个函数。
createIndex() 用于创建并返回一个model index
flags()被model用于表示可以对数据执行的操作(例如,是否可编辑),从QAbstractTableModel继承而来的默认实现是返回Qt::ItemSelectable | Qt::ItemIsEnabled
qDeleteALl()对一个含有指针的容器进行迭代,并对其中每个指针元素执行delete操作。
10.4 Implementing Custom Delegates
view中的每个item是由delegate负责显示和编辑的,在大多数情况下,view默认的delegate足够满足用户需求。
setItemDelegate() 为view指定其delegate。
QItemDelegate & QAbstractItemDelegate
要提供一个允许编辑的自定义delegate,我们必须对createEditor(),setEditorData(),setModelData()进行重新实现,而且还必须重新实现paint()以改变item的显示。
QTimeEdit & QTime
当用户开始编辑操作时,view会调用createEditor()来创建一个Editor,然后调用setEditorData()来用item的当前值对Editor进行初始化。
Chapter 11 Container Class
Qt提供的容器类的最大优点在于平台无关性和隐式共享特性