[Предыдущая: Руководство по Qt Assistant] [Содержание] [Следующая: Использование Qt Assistant как пользовательской справочной системы] Qt Assistant в подробностях
|
Ключ командной строки | Краткое описание |
---|---|
-collectionFile <file.qhc> | Использование указанного файла коллекции (collection file) вместо файла по умолчанию. |
-showUrl URL | Отображает документ по указанному URL. |
-enableRemoteControl | Разрешает удаленное управление Qt Assistant'ом. |
-show <widget> | Отображает указанный прикрепляемый виджет (dockwidget), которым может быть "contents", "index", "bookmarks" или "search". |
-hide <widget> | Скрывает указанный прикрепляемый виджет, которым может быть "contents", "index", "bookmarks" или "search". |
-activate <widget> | Активирует указанный прикрепляемый виджет, которым может быть "contents", "index", "bookmarks" или "search". |
-register <doc.qch> | Регистрирует указанный сжатый файл справки в заданной коллекции справки. |
-unregister <doc.qch> | Дерегистрирует указанный сжатый файл справки в заданной коллекции справки. |
-setCurrentFilter filter | Устанавливает заданный фильтр в качестве активного. |
-quiet | Не отображать любые сообщения об ошибках, предупреждениях или подтверждения. |
Окна инструментов предоставляют четыре способа навигации по документации:
Если вы хотите, чтобы окно Документация использовало как можно больше места, вы можете легко группировать, перемещать или скрывать инструментальные окна. Чтобы группировать окна, перетащите одно окно поверх другого и отпустите кнопку мыши. Если одно или все инструментальные окна не отображаются, нажмите Alt+C, Alt+I или Alt+O, чтобы отобразить требуемое окно.
Инструментальные окна могут быть прикреплены в главном окне, т.е. вы можете перетаскивать их вверх, влево, вправо или вниз окна Qt Assistant'а, или вы можете перетащить их за пределы Qt Assistant, чтобы они плавали как независимые окна.
Окно Документация позволяет вам создать вкладку для каждой страницы документации, которую вы смотрите. Щелкните кнопку Добавить вкладку и появится новая вкладка с именем страницы как у заголовка вкладки. Это делает удобным переключение между страницами, когда вы работаете с различной документацией. Вы можете удалить вкладку щелкнув кнопку Закрыть вкладку размещенную с правой стороны окна Документация.
Главная панель инструментов обеспечивает быстрый доступ к наиболее общим действиям.
Действие | Описание | Пункт меню | Комбинация горячих клавиш |
---|---|---|---|
Предыдущая (Previous) | Переносит вас к предыдущей странице в истории | Go|Previous | Alt+Стрелка влево |
Следующая (Next) | Переносит вас к следующей странице в истории | Go|Next | Alt+Стрелка вправо |
Домой | Перемещает вас на домашнюю страницу, которая заданна в Диалоге Настройки. | Go|Home | Ctrl+Home. |
Синхронизировать с Содержанием (Sync with Table of Contents) | Синхронизирует инструментальное окно Contents со страницей отображаемой в данный момент в окне Documentation. | Go|Sync with Table of Contents | |
Копировать (Copy) | Копирует любой выделенный текст в буфер обмена. | Edit|Copy | Ctrl+C |
Печать (Print) | Открывает диалог Печать (Print). | File|Print | Ctrl+P |
Найти в тексте (Find in Text) | Открывет диалог Найти (Find Text). | Edit|Find in Text | Ctrl+F |
Увеличить (Zoom in) | Увеличивает размер шрифта, используемый для отображения текста в текущей вкладке. | View|Zoom in | Ctrl++ |
Уменьшить (Zoom out) | Уменьшает размер шрифта, используемый для отображения текста в текущей вкладке. | View|Zoom out | Ctrl+- |
Нормальный размер (Normal Size) | Сбрасывает размер шрифта в нормальный размер, в текущей вкладке. | View|Normal Size | Ctrl+0 |
Панель адреса предоставляет быстрый способ ввести определенный URL-адрес для файла документации. По умолчанию, панель адреса не отображается, она активируется через View|Toolbars|Address Toolbar.
Панель фильтра позволяет вам применять фильтр к установленной в данный момент документации. Как и в случае с панелью адреса, панель фильтра невидима, по умолчанию, и активируется через View|Toolbars|Filter Toolbar.
Этот диалог платформозависимый. Он предоставляет доступ к различным настройкам принтера и может быть использован, чтобы печатать документ отображаемый в текущей вкладке.
Страница Шрифты (Fonts) позволяет вам изменить семейство и размер шрифта окна обозревателя, отображающего документацию или самого приложения.
Страница Фильтры (Filters) позволяет вам создавать и удалять фильтры документации. Чтобы добавить новый фильтр, нажмите кнопку Добавить (Add), задайте имя фильтра во всплывающем диалоге и нажмите OK, затем выберите атрибуты фильтра в списке справа. Вы можете удалить фильтр выбрав его и нажмите кнопку Удалить (Remove).
Страница Документация (Documentation) позволяет вам устанавливать и удалять сжатые файлы справки. Нажмите кнопку Установить (Install) и выберите сжатый файл справки (*.qch), который вы хотели бы установить. Чтобы удалить файл справки, выберите набор документации в списке и нажмите Remove.
Страница Параметры позволяет вам указать домашнюю страницу, которую Qt Assistant отобразит, когда вы щёлкните кнопку Домой в главном интерфейсе пользователя Qt Assistant'а. Вы можете указать домашнюю страницу в ведя её здесь или щёлкнув на одной из кнопок под текстовым полем. Текущая страница (Current Page) устанавливает в данный момент отображаемую страницу в качестве домашней, в то время как Страница по умолчанию (Restore to default) сбросит вашу домашнюю страницу в страницу по умолчанию.
Эта панель используется, чтобы искать текст на текущей странице. введите текст, который вы хотите найти, в строку ввода. Поиск является инкрементным, это означает, что самый соответствующий результат показывается по мере ввода символов в строку ввода.
[FIXME]Если вы щёлкните флажок Whole words only, the search will only consider whole words; for example, if you search for "spin" with this checkbox checked it will not match "spinbox", but will match "spin". Если вы установите флажок Регистрозависимый (Case sensitive), тогда, например, "spin" будет соответствовать "spin", но не "Spin". Вы можете искать вперёд или назад относительно вашей текущей позиции на странице, щёлкая кнопки Предыдущее (Previous) или Следующее (Next). Чтобы спрятать панель поиска, либо щёлкниете кнопку Закрыть (Close), либо нажмите клавишу Esc.
Qt Assistant позволяет вам устанавливать любые виды документации, если они организованны в сжатые файлы справки Qt (*.qch). Например, можно установить справочную документация для Qt 4.4.0 и Qt 4.4.1 одновременно. Во многих отношениях это очень удобно, т.к. необходима только одна версия Qt Assistant. Однако, в это же время это становится более сложным, когда выполняются задачи подобные поиску в указателе, из-за того, что почти каждое ключевое слово определено в Qt 4.4.0 также как и в Qt 4.4.1. Это означает, что Qt Assistant всегда будет просить пользователя, выбрать, который из результатов отобразить.
Мы используем фильтры документации, чтобы решить эту проблему. Фильтр определяется по его имени, и содержит список свойств фильтра. Свойство - это просто строка и она может быть выбрана произвольно. Свойства определены самой документацией, это означает, что каждый набор документации, обычно, имеет одно или более свойств.
Например, документация Qt 4.4.0 Qt Assistant определяет свойства assistant, tools и 4.4.0, Qt Designer определяет designer, tools и 4.4.0. Фильтр для отображения всех инструментов должен, тогда, определять свойство tools так как это свойство - часть обоих наборов документации. Добавление свойства assistant к фильтру будет, тогда показывать документацию по Qt Assistant, так как документация Qt Designer не содержит такого свойства. В случае пустого списка свойств в фильтре, будет соответствовать всей документации; т.е., это эквивалентно запросу не отфильтрованной документации.
Qt Assistant предоставляет мощный движок полнотекстового поиска. Чтобы найти определенные слова или текст, щёлкните вкладку Поиск (Search) в окне Документация (Documentation). Затем введите текст, который вы хотите найти и нажмите Enter или щёлкните кнопку Найти (Search). Поиск регистронезависимый, например, Foo, fOo и FOO трактуются одинаково. Ниже приведены примеры общих моделей поиска:
Также можно использовать Расширенный поиск (Advanced search), чтобы получить большую гибкость. Вы можете определить некоторые слова так, чтобы элементы содержащие их исключались из результатов поиска, либо вы можете искать точную фразу. Поиск похожих слов даст результаты подобно этим:
Параметры могут комбинироваться для улучшения результатов поиска.
Список найденных документов отсортирован в соответствии с числом совпадений искомого текста, который они содержат, те которые содержат наибольшее количество совпадений отображаются первыми. Просто щёлкните любой документ в списке, чтобы отобразить его в окне Документация (Documentation).
Если документация была изменена — например, если документы были добавлены или удалены — Qt Assistant проиндексирует их снова.
[Предыдущая: Руководство по Qt Assistant] [Содержание] [Следующая: Использование Qt Assistant как пользовательской справочной системы]
Copyright © 2009 Nokia Corporation and/or its subsidiary(-ies) | Торговые марки | Qt 4.5.3 |
Попытка перевода Qt документации. Если есть желание присоединиться, или если есть замечания или пожелания, то заходите на форум: Перевод Qt документации на русский язык... Люди внесшие вклад в перевод: Команда переводчиков |