The Main Window
The main window contains a menubar, toolbar, listbox, file viewer, and statusbar. You have obviously seen it or you would most likely not be reading this.

If you prefer alternate views of the main window, Qt provides the ability to reposition, shrink, and tear off menubars and toolbars. To shrink/expand the bars, simply single-click on the hash marks next to the left-most item. To move/tear off the bars, click and hold on the hash marks then drag the bar around with your mouse. You can dock the bar outside the main window or along any of the edges of the main window. Try it out!

Here is a shot of the main window all in one piece.

The menubar

The menubar is one method of accessing KGrep's facilities. Most menu items have Ctrl+<letter> accelerators that allow you to quickly access the menu item from anywhere within the KGrep main window. Here are the menus:

From the File menu you can open the Options dialog, edit the currently selected file in the external editor you specified in the Options dialog, or exit KGrep. The file menu can be accessed via mouse-click or by pressing Alt+F. The menu items are accessed via mouse-click or my pressing Alt+F <letter> where <letter> is the underlined letter of the option you want. The Edit File menu item is only available when there files with matches in the listbox, otherwise it is disabled.

The search menu has three items: New Search, Previous Match, and Next Match. New Search fires off the Search dialog for specifiying a new search. Previous Match and Next Match allow you to navigate matches in the listbox. These buttons will move to the appropriate item in the match list and load the corresponding file and highlight the matching line in the file viewer. The Previous and Next Match buttons behave like the Edit File button, they are disabled when there are no matches in the listbox.

The help menu is the KDE default help menu that provides access to application help and about information for the application and KDE itself.

Back to the Help Contents

The toolbar

The toolbar is another method of accessing KGrep's facilities. It aims to provide access to commonly used dialogs and functionality. The icons are pretty self-explanitory, but if you have a hard time remembering you have several fallbacks. Each of the toolbar items are available from the menus (notice the corresponding icons beside the menu items and the toolbar), and if you simply move your mouse over the toolbar icons and leave it there for a moment without clicking, a tooltip will appear describing the button.

The toolbar items are (from left to right) New Search, Previous Match, Next Match, and Edit File.

Back to the Help Contents

The match(es) list

This listbox shows you the matches to your search. The file in which the match occurred, the line number, and the line are all shown. Each of the columns may be grown or shrunk by clicking and holding the vertical divider lines in the header and dragging left or right. After a new search, the first item in the list is automatically highlighted and the the file is opened in the file viewer if it is not a binary file. You can single or double click on any row to open the file of that row in the file viewer.

Back to the Help Contents

The embedded file viewer

The embedded file viewer shows you the file in which your match occurs and highlights the match on-screen. This gives you easy access to the context of your match.

Back to the Help Contents

The statusbar

The statusbar provides you with the total number of matches found and total number of files in which a match was found for your search.

Back to the Help Contents


Copyright © 1999 Logikos Systems and Software, Inc.