Minimizing, Maximizing, and Restoring View Frames

A view frame can be in one of the following states: Normal, Minimized, Maximized.

To retrieve the state of a frame, use the method getCurrentState. The possible returned values are: NormalState, MinimizedState, and MaximizedState.

Normal and Minimized View Frames

Normal View Frames

By default, a view frame is displayed with its normal size. To restore a frame to this state after it has been maximized or minimized, use the restoreFrame method:

vframe->restoreFrame();

This method does nothing if the frame is already in the normal state.

You can also revert a view frame to its initial state by clicking the Restore button in its title bar.

Minimized View Frames

When a view frame is minimized, only its title bar is visible, and its position is managed by the desktop manager. To minimize a frame, use the minimizeFrame method:

vframe->minimizeFrame();

A list of minimized view frames is managed by the desktop manager, and can be accessed using the getMinimizedFrames method.

You can also minimize a view frame by clicking the Minimize button in its title bar.

Maximized View Frames

When a view frame is maximized, its client view occupies all the desktop view.

To maximize a view frame, use the method maximizeFrame:

vframe->maximizeFrame();

You can also maximize a view frame by clicking the Maximize button in its title bar.

When a view frame is maximized, its title bar and hence the buttons it contains are no longer visible. In this case, however, the desktop manager can display these buttons in another place.

The following lines tell the desktop manager to display the buttons of the title bar in container when a frame is maximized.

IlvContainer* container = ....

desktop->makeMaximizedStateButtons(container->getHolder());

The following lines tell the desktop manager to display the buttons of the title bar in toolbar:

IlvToolBar* toolbar = ...

desktop->makeMaximizedStateButtons(toolbar);