简介

Qt Assistant也就是我们常说的Qt助手,是一款用于呈现在线文档的工具。

一分钟学会使用

一旦你安装好Qt,便可以随时使用Qt Assistant:

  • 在Windows下,Qt Assistant作为Qt菜单上的菜单选项。

  • 在Mac OS X下,Qt Assistant安装在/Developer/Applications/Qt目录下。

  • 在Unix/Linux下,打开一个终端,输入assistant ,然后按下Enter键。

当启动Qt Assistant后,你会看到一个标准的主窗口应用程序,包含一个菜单栏和工具栏。当然,除了这些以外,左侧导航窗口称里面包含目录、索引、书签、搜索等。右侧文档窗口则占用了大部分空间。默认情况下,Qt Assistant加载Qt参考文档以及其他Qt的手册工具,例如:Qt Designer、Qt Linguist。

Qt Assistant工作原理类似于一个Web浏览器,如果你点击一个超链接(交叉引用),文档窗口将显示相应的页面。可以通过点击工具栏中的BackForward按钮来切换访问过的页面。

Qt Assistant可以像一个Web浏览器一样来浏览文档,当然,更厉害的是它拥有Web浏览器并不拥有的强大导航能力。Qt Assistant采用了先进的全文搜索引擎来索引每个压缩的帮助文件的所有网页,以便可以搜索特定的单词和短语。

要进行索引搜索,点击侧边栏的索引选项卡(或按Alt+I)。在”查找”输入框中输入要查找的内容,例如:”resize”。键入以后,下方列表中就会突出显示所有的匹配结果。如果高亮显示文本与你地搜索相匹配,双击(或按Enter键),文档窗口将显示相关页面。在找到匹配信息之前,最好不要搜索整个单词。注意,对于一些单词可能存在多个相关的网页。

Qt Assistant还提供了全文搜索查找文档中的特定词语。要激活全文搜索,点击侧边栏的搜索选项卡(或按Alt+S)。然后输入要查找的词并点击搜索按钮。所有包含指定词的文档将被列在下面的列表框中。

Qt参考文档

Qt库文档是由开发者自己在线在.cpp中所写。文档团队修正的文档以确保它是准确和可用的,并提供产品质量的控制。该文档团队还写了大量的文本,如类描述-介绍类与类使用的概念,以及类提供的功能和属性。

该文档的重点是API,而不是内部结构,因为需要努力保持API相一致,并与每一个新版本兼容。但可以改变内部结构大大提高性能和增强功能。

Qt参考文档包括近1500个HTML页面(超过2500打印页)。绝大多数的页面文件Qt类。由于开发人员的思考和工作方式不同,所以提供了多种方法来进行文档导航:

  • Qt’s Classes页面列出了Qt公共API中的所有类。
  • Qt’s Main Classes 页面列出最有可能最常使用的类,并提供了比所有类列表更短,更易于管理的列表。
  • Grouped Classes页面显示组的列表,其中每一个组包含相关类别的列表,例如,Advanced Widgets列表。
  • Class Inheritance Hierarchy页面显示Qt类层次结构。
  • Member Function Index 页面列出了所有Qt类,每一个链接到它所在的类所提供的功能。

无论身在Qt参考文档中的何处,你会发现大量的交叉引用。示例代码甚至片段中包含可点击的链接,因此,例如:如果你在代码示例中遇到一个类声明,类名称将是一个类文档的可点击链接。

除了类文档,一些Qt模块具有广泛的描述,并有很多概述文件来描述Qt库的各个方面。所有这些都是从参考文档的首页链接来的,还有很多教程和示例程序。

Qt Assistant详解

命令行选项

Qt Assistant处理以下命令行选项:

命令行选项 简述
-collectionFile <file.qhc> 使用指定的收集文件来代替默认的
-showUrl URL 通过URL显示引用的文件
-enableRemoteControl 使Qt Assistant可以被远程控制
-show <widget> 显示特定的dockwidget(能被”contents”、”index”、”bookmarks”、”search”)
-hide <widget> 隐藏特定的dockwidget(能被”contents”、”index”、”bookmarks”、”search”)
-activate <widget> 激活特定的dockwidget(能被”contents”、”index”、”bookmarks”、”search”)
-register <doc.qch> 在给定的帮助采集器中注册指定压缩的帮助文件
-unregister <doc.qch> 在给定的帮助采集器中释放指定压缩的帮助文件
-quiet 不显示任何错误、警告或成功的消息

工具窗口

工具窗口提供了四种方式来浏览文档:

内容窗口:提供了一个树状结构的可用文件目录。如果点击一个选项,对应的文档将会出现在右侧文档窗口。如果你双击一个选项(或点击控制它的左侧小三角)选项的子项将会进行展开/折叠。选择一个子项,也可以在文档窗口中查看。

索引窗口:用于查找关键词或短语。见一分钟学会使用

书签窗口:列出你添加的所有书签。选择一个书签,使其页面出现在右侧文档窗口。书签窗口提供了显示项目的上下文菜单、删除项目、重命名项目。选择:书签->添加书签(或按Ctrl+D),将当前页面加入到书签中。右键选择书签,可以对书签进行显示、重命名、删除等操作。

查找窗口:在所有已安装的文档中进行查找,可以全文搜索查找文档中的特定词语。见一分钟学会使用

Open Pages窗口:显示标签页,并可以对标签页进行管理。

工具窗口属于停靠窗体,可以将它们拖动到主窗体的左侧、右侧顶部、底部任意一个位置,或者你可以将他们作为独立的窗体。

文档窗口

文档窗口,可以为查看的每个文档页面创建标签。选择:文件->新建标签页,一个新的标签页会出现在文档窗口页面。当使用不同的文档页面之间切换时很方便。可以通过选择:文件->关闭标签页(或在Open Pages窗口关闭)来关闭标签页。

工具栏

工具栏提供快速访问最常用的操作。

动作 描述 菜单项 快捷键
Back 返回至上一页的历史记录 Go|Back Alt+Left
Forward 前进至下一页的历史记录 Go|Forward Alt+Right
Home 跳转至首页(可以在编辑->首选项->选项中设置) Go|Home Ctrl+Home
同步目录 同步内容窗口与当前文档窗口 Go|Sync with Table of Contents  
Copy 把选中的文本复制到剪贴板 Edit|Copy Ctrl+C
Print 打开打印对话框 File|Print Ctrl+P
Find in Text 打开查找文本对话框 Edit|Find in Text Ctrl+F
Zoom in 放大当前页签文本的字体大小 View|Zoom in Ctrl++
Zoom out 缩小当前页签文本的字体大小 View Zoom out
Normal Size 重置前页签文本的字体大小为正常大小 View|Normal Size Ctrl+0

址工具栏提供了一种快速的方法来为一个文档文件输入特定的网址。默认情况下地址栏没有显示,所以它必须通过查看->工具栏->地址工具栏被激活。

过滤器工具栏,可以为当前已安装的文件应用过滤器。与地址栏一样,过滤器工具栏默认情况页没有显示,所以它必须通过查看->工具栏->过滤器工具栏被激活。

菜单

文件菜单

新建标签页:在文档窗口新建一个新的空标签页。
关闭标签页:关闭当前标签页。
页面设置:调用一个对话框,允许定义纸张,方向,页边距。
打印预览:提供打印页面的预览。
打印:打开打印对话框。
退出:关闭Qt Assistant应用程序。

编辑菜单

复制:拷贝任何选定的文本到剪贴板。
查找文本:在文档窗口查找匹配文本。
查找下一个:在文档窗口查找下一个匹配文本。
查找上一个:在文档窗口查找上一个匹配文本。
首选项:设置字体、文档、过滤器、选项

查看菜单

放大:放大当前标签的字体大小。
缩小:缩小当前标签的字体大小。
正常大小:恢复当前标签的字体大小。
内容:切换内容工具窗口的显示。
索引:切换索引工具窗口的显示。
书签:切换书签工具窗口的显示。
搜索:切换搜索工具窗口的显示。
Open Pages:切换Open Pages工具窗口的显示。
工具栏:切换过滤器工具栏地址工具栏 的显示。

前往菜单

Home:跳转至主页。
Back:跳转至所选的上一页。
Forward:跳转至所选的下一页。
同步目录:同步内容窗口与当前文档窗口。
下一页:跳转至下一页。
上一页:跳转至上一页。

书签菜单

管理书签:可以进行书签搜索、显示、删除、重命名、导入/导出等。
添加书签:添加当前页面至书签列表。
书签工具栏:显示已经添加的书签项。

帮助菜单

关于:显示Qt版本、浏览器、版权信息。

对话框

打印对话框

这个对话框是与平台相关的。它可以访问各种打印机选项,可用于打印当前标签页中所示的文件。可以以PDF形式打印到本地,也可以通过打印机打印为纸张。

首选项对话框

字体页面:可以更改浏览器、应用程序的字体设置,可以自定义设置字体风格、字体大小等。

过滤器页面:可以添加和删除过滤器。要添加新的过滤器,单击”添加”按钮,在弹出的对话框中指定过滤器名称,然后单击”确定”,然后选择在右侧列表框中的过滤器属性。要删除过滤器,选中之后点击”删除”即可。

文档页面:可以添加和删除压缩帮助文件。点击”添加”按钮,然后选择Qt压缩缩帮助文件(*.qch)。要删除帮助文件,选中之后点击”删除”即可。

选项页面:可以指定Qt Assistant启动时默认加载的页面,可以设置当前页,也可以设置空白页,选择”恢复默认值”则恢复为最初页面。

查找文本控制

可在当前页面进行文本查找。输入要查找的文本,由于查找是增量的,这意味着当你输入字符后就会显示相关的结果。

如果选中全字匹配复选框,搜索将只考虑全字。例如,如果你搜索”spin”,它不会匹配”spinbox”,但将匹配”spin”。如果选中区分大小写复选框,那么例如,输入”spin”将会匹配”spin”,而不是”Spin”,你可以在页面中点击上一个或下一个按钮从当前位置向前或向后搜索。

全文搜索

Qt Assistant提供了强大的全文搜索引擎。要搜索某个单词或文字,单击文档窗口中的搜索选项卡。然后输入你想查找的文本,按Enter键或点击搜索按钮上。搜索不区分大小写,因此,举例来说,Qt、QT、qt都视为相同。以下是常见的搜索模式的例子:

deep:列出所有包含”deep”单词的文件。
deep* :列出所有以”deep”开头的单词的文件。
deep copy:列出所有同时包含”deep”和”copy”单词的所有文件。
“deep copy”:列出所有包含”deep copy”单词的文件。

另外,也可以使用高级搜索,获得更大的灵活性。可以指定一些单词,让含有这些单词的被排除在外,或者可以搜索一个确切的短语。搜索类似的单词会给这样的结果:

QStin:列出了所有标题与之相似的的文档,比如:QString。
QSting:列出了所有标题与之相似的的文档,比如:QString。
QStrin: 列出了所有标题与之相似的的文档,比如:QString。

选项可以任意组合,以改善搜索结果。

查找文件清单是根据查找它们所包含搜索文本的数量进行排序的,那些含有最高数量出现在最前面。只需在列表中点击任何选项,即可在文档窗口中显示。

如果文件已经改变,例如:如果文件被添加或删除,那么,Qt Assistant将再次对其进行索引。


原文作者:一去丶二三里
作者博客:去作者博客空间

【Qt】Qt Assistant介绍【转】的更多相关文章

  1. Qt Quick 布局介绍

    在 Qt Quick 中有两套与布局管理相关的类库,一套叫作 Item Positioner(定位器),一套叫作 Item Layout(布局). 定位器包括 Row(行定位器).Column(列定位 ...

  2. Qt... configure: error: Qt (>= Qt 2.2.2) (headers…

    转载:http://blog.chinaunix.net/uid-23733724-id-290980.html     昨天开始在自己的fedora12下装qt~ 但是按照教程在/opt/Embed ...

  3. Qt, QT/E, Qtopia 的区别

    转自Qt, QT/E, Qtopia 的区别 Qt泛指Qt的所有桌面版本,比如Qt/X11,Qt Windows,Qt Mac等.由于Qt最早是在Linux中随着KDE流行开来的,因此通常很多人说的Q ...

  4. QT QT creator QTsdk的区别

    Qt是一个跨平台的C++图形用户界面应用程序框架.它提供给应用程序开发者建立艺术级的图形用户界面所需的所用功能.Qt是完全面向对象的,很容易扩展,并且允许真正地组件编程. QT Creator 跨平台 ...

  5. QT,QT SDK, QT Creator 区别

    Qt是一个跨平台的C++图形用户界面应用程序框架.(不仅仅是C++,还包括QML,Qquick,html5)它提供给应用程序开发者建立艺术级的图形用户界面所需的所用功能.Qt是完全面向对象的,很容易扩 ...

  6. Qt Assistant介绍

    简介 Qt Assistant也就是我们常说的Qt助手,是一款用于呈现在线文档的工具. 简介 一分钟学会使用 Qt参考文档 Qt Assistant详解 命令行选项 工具窗口 文档窗口 工具栏 菜单 ...

  7. 界面编程之QT的基本介绍与使用20180722

    /*******************************************************************************************/ 一.qt介绍 ...

  8. 第5课 Qt Creator工程介绍

    1. QT Creator工程管理(一个工程包含不同类型的文件) (1).pro项目文件 (2).pro.user用户配置描述文件 (3).h头文件 (4).cpp源文件 (5).ui界面描述文件 ( ...

  9. Qt容器类之一:Qt的容器类介绍

    一.介绍 Qt库提供了一套通用的基于模板的容器类,可以用这些类存储指定类型的项.比如,你需要一个大小可变的QString的数组,则使用QVector<QString>. 这些容器类比STL ...

随机推荐

  1. 1.5.5 Tokenizers

    Tokenizers <fieldType name="text" class="solr.TextField"> <analyzer typ ...

  2. solr--搜索参数随笔

    1.默认搜索域.查询域的关系 qf字段的配置:query fields,指定solr从哪些field中搜索 在solrj中设置如下: params.setParam("qf", & ...

  3. [PHP] htaccess 探秘

    .htaccess访问控制(Allow/Deny) 1. 验证是否支持.htaccess 在目录下新建一个.htaccess 文件,随笔输入一串字符(毫无意义),看看什么反应,如果是500错误,说明目 ...

  4. emWin使用外部SRAM的方法

    我用的是stm32,加了1MB的外部SRAM,在使用emWin的时候,将一部分内存分配给emWin使用.其实方法很简单,传入SRAM数据总线地址即可,数据位宽我采用16bit,因为使用的SRAM是16 ...

  5. Oracle基础 动态SQL语句

    一.静态SQL和动态SQL的概念. 1.静态SQL 静态SQL是我们常用的使用SQL语句的方式,就是编写PL/SQL时,SQL语句已经编写好了.因为静态SQL是在编写程序时就确定了,我们只能使用SQL ...

  6. mysql-完整性约束条件

    PRIMARY :   主键 AUTO_INCREMENT  : 自增长 FOREIGN KEY : 外键 NOT NULL : 非空 UNIQUE KEY : 唯一 DEFAULT :  默认值 主 ...

  7. poj 3017 单调队列优化动态规划

    思路:dp[i]=min{dp[j]+max(num[j+1]...num[i])},其中sum[i]-sum[j]<=m. 那么我们需要用单调队列维护j到i的最大值. #include< ...

  8. ASP.Net 验证控件 RangeValidator

    RangeValidator 定义和用法 RangeValidator 控件用于检测用户输入的值是否介于两个值之间.可以对不同类型的值进行比较,比如数字.日期以及字符. 注释:如果输入控件为空,验证不 ...

  9. 第六十八篇、OC_按照某一字段对数值进行排序

    代码中是根据"create_time_" 进行排序   ascending:决定的是升序还是降序排序 NSSortDescriptor *sortDescriptor = [[NS ...

  10. Cocos2d-x文本菜单

    文本菜单是菜单项只是显示文本,文本菜单类包括了MenuItemLabel.MenuItemFont和MenuItemAtlasFont.MenuItemLabel是个抽象类,具体使用的时候是使用Men ...