Home | All Classes | Main Classes | Annotated | Grouped Classes | Functions

[Prev: The 1 Minute Guide to Using Qt Assistant] [Home] [Next: Full Text Searching]

Qt Assistant in More Detail

Qt Assistant

The Sidebar

The sidebar provides four ways of navigating documentation:

  1. The Contents tab presents a tree view of the documentation sets that are available. If you click an item, its documentation will appear in the documentation window. If you double click an item or click a '+' sign to the left of an item, the item's sub-items will appear. Click a sub-item to make its page appear in the documentation window. Click a '-' sign to the left of an item to hide its sub-items.

  2. The Index tab is used to look up key words or phrases. See The 1 Minute Guide to Using Qt Assistant for how to use this tab.

  3. The Bookmarks tab lists any bookmarks you've made. Double click a bookmark to make its page appear in the documentation window. The Bookmarks tab has a New Bookmark button and a Delete Bookmark button at the bottom. Click New Bookmark to bookmark the page that is showing in the documentation window. Click a bookmark in the list, then click Delete Bookmark to delete the highlighted bookmark.

  4. The Search tab provides full text search of all the documents. See Full Text Searching for more information about this feature.

If you want the documentation window to use as much space as possible, you can easily hide or show the Sidebar. If the Sidebar is showing, press Ctrl+T, Ctrl+I, Ctrl+B or Ctrl+S to hide it. If the Sidebar is hidden, press Ctrl+T to show it on the Contents tab, or press Ctrl+I to show it on the Index tab (with the focus in the 'Look For' line edit box), or press Ctrl+B to show it on the Bookmarks tab, or press Ctrl+S to show it on the (full text) Search tab.

The Sidebar is a dock window, so you can drag it to the top, left, right or bottom of Qt Assistant's window, or you can drag it outside Qt Assistant to float it.

The Documentation Window

The documentation window offers a feature for viewing documentation by enabling you to create tabs for each documentation page that you view. Click the Add Tab button and a new tab will appear with the page name as the tab's caption. This makes it convenient to switch between pages when you are working with different documentation. You can delete a tab by clicking the Close Tab button located on the right side of the documentation window.

The Toolbar

The toolbar provides fast access to the most common actions.

The remaining toolbar buttons are bookmarks and will vary depending on your configuration.

The Menus

The File Menu

The Edit Menu

The View Menu

The Go Menu

This menu also has additional items; these are pre-defined bookmarks that vary depending on your configuration.

The Bookmarks Menu

This menu may have additional items, i.e. any bookmarks that you have already made. If you want to delete a bookmark go to the Bookmarks tab on the Sidebar.

The Dialogs

The Print Dialog

This dialog is platform-specific. It gives access to various printer options and can be used to print the current page.

The Find Text Dialog

This dialog is used to find text in the current page. Enter the text you want to find in the Find line edit. If you check the 'Whole words only' checkbox, the search will only consider whole words, i.e. if you search for 'spin' with this checkbox checked it will not match 'spinbox', but will match 'spin'. If you check the 'Case sensitive' check box then, for example, 'spin' will match 'spin' but not 'Spin'. You can search Forward or Backward from your current position in the page by clicking one of the Direction radio buttons. Click the Find button to search (or search again), and click the Close button to finish.

The Settings Dialog

The Settings dialog is used to set your preferences for Qt Assistant. The dialog has four tabs: General Settings, Web Settings, PDF Settings, and Profiles. Qt Assistant will remember your settings between sessions, including window sizes and positions, and which pages you have open. Each of the tabs is discussed as follows: