Next Previous Table of Contents
The KDevelop Classviewer is one of the most useful and important tools that the IDE provides a developer for managing his project sources. When a project is loaded, a class parser reads all project sources for functions, classes etc., then displays the results in the CV treeview. This chapter shows you how to use the Classviewer and the provided functionality and how it can improve your work.
Classes and their methods can also be accessed by the browser toolbar. There, the left combo selects the class; the right lets you choose the methods of the selected class. When you select a method, the classbrowser will automatically bring you to the implementation file and sets the cursor to the method. Finally, the class-assistant button on the right of the method combo will bring you to the declaration of the method on a click; on another click to the definition. The delayed popup menu, displayed by the down-arrow on the button, offers additional functionality that is also available in the classviewer's context menus, such as:
By available objects, we describe a term that means that C++ code can be seen as a collection of objects- classes, their members, global functions and the like. The classtree displays these objects logically and orders them by character, so they are easy to locate in the tree as well by their according icon. Therefore the classtree contains a "Classes" and a "Globals" folder. Thereby the "Classes" folder generally contains the project's classes; if your project contains subfolders to manage your sourcefiles, these are also displayed by their original folder name and contain all classes that are stored in the files located in the subfolder.
Further, when popping up a class, the classtree displays the class contents by separating methods and attributes. As these can have attributes as well like public, private and protected, these are displayed by modified icons as well. You see that a class displayed in the Class Browser contains all the objects that are present in the class declaration.
Now, classes are a very common thing when programming in C++ and will contain most of the code. But applications also contain objects
that have a "Global" appearance to the program. These would be structs, functions etc. Especially the main() function appears in
every application and you need to modify it in one or the other way sometimes. To access these objects, the Classviewer provides the
"Globals" folder, containing subfolders for the following object types:
As the icons displaying these items are similar to those used in the class-viewer, their meaning is easy to guess and to remember by the programmer.
Finally, it can be stated that the classviewer displays your project graphically by their objects related to their appearance in the code. In the following section you will learn how to use the classviewer and it's tools in conjunction with your code.
The Classviewer's best strength is providing a fast and good access to his code by the code's contents independent of the location within files. Therefore, selections by a mouse click will result in the following actions:
Now, this provides you the most needed access towards code objects. Apparently, it may be needed to change a method's header, resulting that you have to change it's declaration in the class as well as the implementation. The classviewer supports this by providing right-button context menus over items. On a method or function, this means that you can select where to go:
By this behavior, the Class Browser offers you access to every place you have to go for coding your C++ application.
The following sections give you a description of the other tools that the Class Browser offers- you will find them very useful when working with large projects as they enhance working object-orientated on C++ programs.
The classtools are dialogs that makes it even more easier for the developer to get more information about his project's classes. The classviewer displays all objects by their occurrence in the code, but you sometimes want to get more information about classes without having to look inside the code. Therefore, the classtool dialogs are specialized on displaying specific class attributes.
The classtool dialog is invoked by the popup menu over a class in the classviewer. Select "Classtool", and the dialog will appear. To get informed about a class, select the class in the combo box on top. Then the buttons in the toolbar provide functions that give you specific trees for your class. These are:
The parents of the selected class, which means the class it inherits. This is useful for multiple inheritance as well as to see why a
class behaves in one or the other way, e.g. for dialogs your parent class could be QWidget or QDialog.
Displays the children classes that inherit the current class.
Classes that make use of the selected class by an attribute in their class declaration
The suppliers that give attributes to the selected class.
The attributes of the class by their name
The Methods of the selected class
The Class Browser additionally allows adding methods and attributes directly by dialogs. This means you don't have to type the classdeclaration and the implementation header yourself. After adding a method, you only have to set the formal parameters to the implementation header and, if the method requires an attribute, to the declaration.
» How to add a method to a class
For adding a variable, this is the same action, just with selecting "Add member variable" in the popup menu.
The difference between the actions of these dialogs is that the adding of a variable will add the variable to the classdeclaration, the adding of a method will add the method's declaration and the method's implementation header to the sources. As the classviewer directly updates himself, you have a direct access to the new method implementation, so you only have to fill out the code for the actual purpose of the method.
Next Previous Table of Contents