Gadgets > Rogue Wave Views Gadgets > View Frames > Managing View Frames
 
Managing View Frames
This section covers the following topics:
*Creating a Client View
*Changing the Title Bar
*Changing the View Frame Menu
Creating a Client View
When created, a view frame has no client view. To add a client view to a view frame, you must create a child window inside it:
IlvGadgetContainer* clientView =
new IlvGadgetContainer(vframe, IlvRect(0, 0, 200, 200));
The view frame is resized to fit the client view geometry.
Note: The client view can be any instance of any subclass of IlvView.
To know the client view associated with a view frame, use:
IlvView* clientView = vframe->getClient();
Note: A view frame should only handle one client view.
Changing the Title Bar
The title bar consists of an icon, a title, and three buttons.
Figure 17.2    The Title Bar of a View Frame
To change the icon of the title bar, use the method setIcon:
IlvBitmap* bitmap = ...
vframe->setIcon(bitmap);
To change its title, use the method setTitle:
vframe->setTitle("Frame Title");
The three buttons to the right of the title bar are used to switch to one of the three states that a frame can have. These are detailed below.
Changing the View Frame Menu
Each view frame has a pop-up menu that is displayed when you click the icon located on the left end of the title bar.
Figure 17.3    The Pop-up Menu of a View Frame
By default, the pop-up menu of a view frame contains the following choices: Restore, Minimize, Maximize, and Close. You can however add new items to it.
To access this menu, use:
IlvPopupMenu* popup = vframe->getMenu();

Version 5.8
Copyright © 2014, Rogue Wave Software, Inc. All Rights Reserved.