Rogue Wave Views Application Framework Package API Reference Guide |
Rogue Wave Views Documentation Home |
Application Framework desktop container. More...
#include <ilviews/appframe/mainwin.h>
Public Member Functions | |
IlvDvDockableMainWindow (IlvDisplay *display, const char *name, const char *title, const IlvRect &dims, IlUInt properties=0, IlBoolean visible=IlTrue, IlvSystemView transientFor=0) | |
Constructs an IlvDvDockableMainWindow object. More... | |
IlvDvDockableMainWindow (IlvAbstractView *parent, const IlvRect &rect, IlBoolean visible=IlTrue) | |
Constructs an IlvDvDockableMainWindow object. More... | |
IlvDvDockableMainWindow (IlvDisplay *display, IlvSystemView parent, const IlvRect &rect, IlBoolean visible=IlTrue) | |
Constructs an IlvDvDockableMainWindow object. More... | |
IlvDvDockableMainWindow (IlvDisplay *display, IlvSystemView window) | |
Constructs an IlvDvDockableMainWindow object. More... | |
virtual IlvDvContainerHandler * | createContainerHandler (IlvDvDocTemplate *docTpl, IlUInt viewTemplateIndex=0) const |
Gets a view container handler. More... | |
IlvPane * | createPaneWithFile (const char *name, const char *filename, const IlvDockingPaneLocation &loc, const IlSymbol *showHideAction=0) |
Creates a named pane from an .ilv file. More... | |
virtual void | dockBarSet (IlvDvBarSet *barSet, IlBoolean update=IlTrue) |
Docks a set of bars. More... | |
IlvDvViewContainerInterface * | getActiveViewContainer () const |
Returns the active document view container. More... | |
virtual IlvDvApplication * | getDvApplication () const |
Gets the application that owns the window. More... | |
virtual IlvGadgetContainer * | getGadgetContainer () |
Gets the top container of the window. More... | |
virtual const IlvGadgetContainer * | getGadgetContainer () const |
Gets the top container of the window. More... | |
virtual IlvToolBar * | getMenuBar () const |
Returns the menu bar of the window. More... | |
virtual IlvToolBar * | getToolBar (const IlSymbol *name) const |
Retrieves a bar with the given name from the window. More... | |
virtual void | initialize () |
Initializes the window. More... | |
virtual IlBoolean | isShowingTooltips () const |
Shows tooltips for menu items. More... | |
virtual IlBoolean | isUsingBigIcons () const |
Shows menu item icons in large size. More... | |
virtual IlBoolean | processAction (const IlSymbol *actionName) |
Processes an action. More... | |
virtual void | readOptions (const IlvDvOptions *) |
Reads options. More... | |
virtual void | removeBarSet (const IlvDvBarSet *barSet, IlBoolean update=IlTrue) |
Removes a set of bars. More... | |
virtual void | saveConfiguration (const IlvDvBarSet &barSet) |
Saves the location of a set of dockable bars. More... | |
virtual void | setDvApplication (IlvDvApplication *app) |
Sets the application that owns the window to the parameter application. | |
virtual void | setStatusLabel (const char *) |
Changes the text displayed in the status bar to the text given as the parameter. More... | |
virtual void | showWindow (IlBoolean bShow=IlTrue) |
Shows the window. More... | |
virtual void | updateOptions (IlvDvOptions *) |
Updates options. More... | |
virtual IlBoolean | withShortcuts () const |
Shows the action accelerators in tooltips. More... | |
Public Member Functions inherited from IlvDvMainWindowInterface | |
virtual IlvDvDocViewInterface * | getActiveView () const |
Gets the active view of the window. More... | |
Public Member Functions inherited from IlvDvInterface | |
IlBoolean | callMethod (const IlSymbol *methodName, IlvDvValue *returnedValue,...) |
Generic method for calling a method that is exported in a class interface. More... | |
IlvDvValue & | getFieldValue (const IlSymbol *fieldName, IlvDvValue &value) const |
Gets a field value. More... | |
virtual IlBoolean | isProcessingAction (const IlSymbol *methodName) const |
Returns IlTrue if the given action can be processed by the class. More... | |
virtual IlBoolean | refreshAction (const IlSymbol *actionName, IlvDvActionDescriptor *desc) const |
Refresh all the menu items that reference the action given by the parameter actionName. More... | |
void | setFieldValue (const IlSymbol *fieldName, const IlvDvValue &value) |
Sets a field value. More... | |
Application Framework desktop container.
Library: ilvappframe
IlvDvDockableMainWindow
is a subclass of IlvDockableContainer
. It is the common main window class for Application Framework applications. It handles dockable toolbars by providing services such as docking and undocking and saving their locations and states. It also manages the view frames (Multiple Document Interface).
The IlvDvDockableMainWindow
window reads the definition of its menu and its toolbars by reading options that are usually generated by the Application Framework Editor. Similarly, it saves and restores the size of the main window.
IlvDvDockableMainWindow::IlvDvDockableMainWindow | ( | IlvDisplay * | display, |
const char * | name, | ||
const char * | title, | ||
const IlvRect & | dims, | ||
IlUInt | properties = 0 , |
||
IlBoolean | visible = IlTrue , |
||
IlvSystemView | transientFor = 0 |
||
) |
Constructs an IlvDvDockableMainWindow
object.
This constructor creates an instance of IlvDvDockableMainWindow
, whose display, name, title, dimensions, properties, visibility, and window for which it is transient for, are given by the parameters display, name, title, dims, properties, visible, and transientFor respectively.
IlvDvDockableMainWindow::IlvDvDockableMainWindow | ( | IlvAbstractView * | parent, |
const IlvRect & | rect, | ||
IlBoolean | visible = IlTrue |
||
) |
Constructs an IlvDvDockableMainWindow
object.
This constructor creates an instance of IlvDvDockableMainWindow
, whose parent, dimensions and visibility are given by the parameters parent, rect and visible respectively.
IlvDvDockableMainWindow::IlvDvDockableMainWindow | ( | IlvDisplay * | display, |
IlvSystemView | parent, | ||
const IlvRect & | rect, | ||
IlBoolean | visible = IlTrue |
||
) |
Constructs an IlvDvDockableMainWindow
object.
This constructor creates an instance of IlvDvDockableMainWindow
, whose display, parent, dimensions and visibility are given by the parameters display, parent, rect and visible respectively.
IlvDvDockableMainWindow::IlvDvDockableMainWindow | ( | IlvDisplay * | display, |
IlvSystemView | window | ||
) |
Constructs an IlvDvDockableMainWindow
object.
This constructor creates an instance of IlvDvDockableMainWindow
, whose display and parent are given by the parameters display and parent respectively.
|
virtual |
Gets a view container handler.
This handler will be called by document templates to create and handle view containers.
Implements IlvDvMainWindowInterface.
IlvPane* IlvDvDockableMainWindow::createPaneWithFile | ( | const char * | name, |
const char * | filename, | ||
const IlvDockingPaneLocation & | loc, | ||
const IlSymbol * | showHideAction = 0 |
||
) |
Creates a named pane from an .ilv
file.
name | The name of the pane to create. |
filename | The name of the .ilv file. |
loc | The location where the new pane is to be located. This parameter is not used if a location is already defined in the configuration of the panes. |
showHideAction | The name of the action that is linked to the visibility state of the new pane. |
|
virtual |
Docks a set of bars.
Called by a document template to dock its set of toolbars within the window.
barSet | Specifies the set of toolbars. |
update | If IlTrue , the window must be updated. |
Implements IlvDvMainWindowInterface.
|
virtual |
Returns the active document view container.
Implements IlvDvMainWindowInterface.
|
virtual |
Gets the application that owns the window.
Implements IlvDvMainWindowInterface.
|
virtual |
Gets the top container of the window.
Usually, it returns the window itself.
Implements IlvDvMainWindowInterface.
|
virtual |
Gets the top container of the window.
Usually, it returns the window itself.
Implements IlvDvMainWindowInterface.
|
virtual |
Returns the menu bar of the window.
Implements IlvDvMainWindowInterface.
|
virtual |
Retrieves a bar with the given name from the window.
Returns the bar owned by the window whose name is given by the parameter barName.
Implements IlvDvMainWindowInterface.
|
virtual |
Initializes the window.
Called by the application once it has created the window and the window options have been read. This method must be overridden to add initialization code.
For example, the IlvDvDockableMainWindow
class overrides this method to tag the Windows popup menu that will be used for adding new window titles.
Reimplemented from IlvDvMainWindowInterface.
|
virtual |
Shows tooltips for menu items.
Returns IlTrue
if tooltips must be displayed for menu items in the window toolbars. Otherwise, it returns IlFalse
. By default, it returns IlTrue
.
IlTrue
if tooltips must be displayed for menu items in the window toolbars. Otherwise, it returns IlFalse
. Reimplemented from IlvDvMainWindowInterface.
|
virtual |
Shows menu item icons in large size.
Returns IlTrue
if the menu item icons must be displayed in large size. If it returns IlFalse
, icons are displayed in normal size. By default, it return IlFalse
.
IlTrue
if the menu item icons must be displayed in large size. Otherwise, it returns IlFalse
. Reimplemented from IlvDvMainWindowInterface.
Processes an action.
Tries to process the action given by the parameter actionName. If a macro Action(actionName, actionMethod)
is inserted in the interface table of the class with a specified external name equal to the actionName parameter, the processAction
method will automatically call the actionMethod
method.
IlTrue
if the action is processed. Reimplemented from IlvDvInterface.
|
virtual |
Reads options.
Called to make the window read options that it had saved during the previous session.
It is redefined by the IlvDvDockableMainWindow
subclass to read the location and state of bars that were saved the last time the application closed.
Reimplemented from IlvDvMainWindowInterface.
|
virtual |
Removes a set of bars.
Called by a document template to remove a set of toolbars.
barSet | Specifies the set of toolbars. |
update | If IlTrue , the window must be updated. |
Implements IlvDvMainWindowInterface.
|
virtual |
Saves the location of a set of dockable bars.
Called to save the location of bars within the bar set given by the parameter barSet.
Reimplemented from IlvDvMainWindowInterface.
|
virtual |
Changes the text displayed in the status bar to the text given as the parameter.
For example, it is called when menu items are highlighted to display the description of the corresponding actions.
Reimplemented from IlvDvMainWindowInterface.
Shows the window.
Called by the application to show or hide the window. By default, this method shows or hides the gadget container returned by the getGadgetContainer()
method, depending on the value of the parameter show.
Reimplemented from IlvDvMainWindowInterface.
|
virtual |
Updates options.
Called to make the window update the application options that it had saved during the previous session.
It is redefined by the IlvDvDockableMainWindow
subclass to save the current location and state of its bars.
Reimplemented from IlvDvMainWindowInterface.
|
virtual |
Shows the action accelerators in tooltips.
Returns IlTrue
if action accelerators must be shown in the menu item tooltips. By default, it returns IlTrue
.
IlTrue
if action accelerators must be shown in the menu item tooltips. Otherwise, it returns IlFalse
. Reimplemented from IlvDvMainWindowInterface.
© Copyright 2016, Rogue Wave Software, Inc. All Rights Reserved.
Rogue Wave is a registered trademark of Rogue Wave Software, Inc. in the United States and other countries. All other trademarks are the property of their respective owners.