Rogue Wave Views Gadgets Package API Reference Guide |
Rogue Wave Views Documentation Home |
Dialog class. More...
#include <ilviews/gadgets/idialog.h>
Public Member Functions | |
IlvDialog (IlvDisplay *display, const char *name, const char *title, const IlvRect &rect, IlUInt properties=0, IlvSystemView transientFor=0) | |
Constructor. More... | |
IlvDialog (IlvDisplay *display, const char *name, const char *title, const char *filename, const IlvRect *rect=0) | |
Constructor. More... | |
IlvDialog (IlvDisplay *display, const char *name, const char *title, const char *filename, IlUInt properties, const IlvRect *rect=0, IlvSystemView transientFor=0) | |
Constructor. More... | |
virtual void | apply () |
Is called when the callback associated with the apply symbol is triggered. More... | |
virtual void | cancel () |
Is called when the callback associated with the cancel symbol is triggered. More... | |
virtual void | wait (IlBoolean grab=IlFalse, IlvCursor *cursor=0) |
Displays a modal dialog. More... | |
IlBoolean | wasCanceled () const |
Returns the status of the dialog after closing it. More... | |
Public Member Functions inherited from IlvGadgetContainer | |
IlvGadgetContainer (IlvDisplay *display, const char *name, const char *title, const IlvRect &rect, IlBoolean useacc=IlFalse, IlBoolean visible=IlTrue) | |
Constructor. More... | |
IlvGadgetContainer (IlvDisplay *display, const char *name, const char *title, const IlvRect &rect, IlUInt properties, IlBoolean useacc=IlFalse, IlBoolean visible=IlTrue, IlvSystemView transientFor=0) | |
Constructor. More... | |
IlvGadgetContainer (IlvAbstractView *parent, const IlvRect &rect, IlBoolean useacc=IlFalse, IlBoolean visible=IlTrue) | |
Constructor. More... | |
IlvGadgetContainer (IlvDisplay *display, IlvSystemView parent, const IlvRect &rect, IlBoolean useacc=IlFalse, IlBoolean visible=IlTrue) | |
Constructor. More... | |
IlvGadgetContainer (IlvDisplay *display, IlvSystemView window, IlBoolean useacc=IlFalse) | |
Constructor. More... | |
virtual IlBoolean | allowFocus (IlBoolean value) |
Specifies whether the container manages the focus. More... | |
virtual void | applyResize (IlFloat sx, IlFloat sy, IlBoolean redraw=IlTrue) |
Is called to carry out the resize events applying to the gadget container. More... | |
IlBoolean | autoResize (IlBoolean a) |
Sets the auto resize mode of the gadget container. More... | |
IlvButton * | getDefaultButton () const |
Returns the default button of the gadget container. More... | |
virtual IlvGraphic * | getFirstFocusGraphic () const |
Returns the first object that receives the focus in this container. More... | |
virtual IlvGraphic * | getFocus () const |
Returns the object that has the keyboard focus in the gadget container. More... | |
virtual IlvGraphic * | getGrab () const |
Returns the object that is currently grabbing events in the container. More... | |
virtual IlvGraphic * | getLastFocusGraphic () const |
Returns the last object that receives the focus in this container. More... | |
IlvLookFeelHandler * | getLookFeelHandler () const |
Returns the look and feel handler associated with this container. More... | |
virtual IlvGraphic * | getNextFocusGraphic (IlvGraphic *object) const |
Returns the next object that will receive the focus after the specified object. More... | |
IlvGraphic * | getOverriddenFocus () const |
Returns the object that will receive the focus after calling setFocus() . More... | |
virtual IlvGraphic * | getPreviousFocusGraphic (IlvGraphic *object) const |
Returns the previous object that received the focus before the specified object. More... | |
IlBoolean | isAutoResizing () const |
Indicates whether the gadget container gets resized when loading a file. More... | |
virtual IlBoolean | isFocusAllowed () const |
Indicates whether the focus is allowed in the container. More... | |
virtual void | moveFocusAfter (IlBoolean redraw=IlTrue) |
Is called to find the next focusable object. More... | |
virtual void | moveFocusBefore (IlBoolean redraw=IlTrue) |
Is called to find the previous focusable object. More... | |
void | overrideFocus (IlvGraphic *obj) |
Sets the object that will receive the focus after calling setFocus() . More... | |
virtual void | removeGrab () |
Cancels the grabbing settings defined with setGrab() . More... | |
void | setDefaultButton (IlvButton *button, IlBoolean redraw=IlTrue) |
Sets the default button of the gadget container. More... | |
virtual void | setFocus (IlvGraphic *graphic=0, IlBoolean redraw=IlTrue) |
Sets the focus to the specified object of the gadget container. More... | |
virtual void | setGrab (IlvGraphic *object) |
Sets the specified object as the grabbing object. More... | |
void | setLookFeelHandler (IlvLookFeelHandler *lfh) |
Sets the look and feel handler of this container. More... | |
Dialog class.
Library: ilvgadgt
The IlvDialog
class is a predefined gadget container with two predefined callbacks: apply
and cancel
.
IlvDialog::IlvDialog | ( | IlvDisplay * | display, |
const char * | name, | ||
const char * | title, | ||
const IlvRect & | rect, | ||
IlUInt | properties = 0 , |
||
IlvSystemView | transientFor = 0 |
||
) |
Constructor.
Initializes a new instance of the IlvDialog
class as a top view.
display | The connection to the display. |
name | The name of the dialog. |
title | The title of the dialog. |
rect | The size and position of the dialog. |
properties | The properties of the dialog. See the IlvView constructors for more details. |
transientFor | A system view for which the dialog is transient. See the IlvView constructors for more details. |
IlvDialog::IlvDialog | ( | IlvDisplay * | display, |
const char * | name, | ||
const char * | title, | ||
const char * | filename, | ||
const IlvRect * | rect = 0 |
||
) |
Constructor.
Initializes a new instance of the IlvDialog
class as a top view, and reads the file specified by filename.
display | The connection to the display. |
name | The name of the dialog. |
title | The title of the dialog. |
filename | The name of the file to be read. |
rect | The size and position of the dialog. If this parameter is not provided, the size used is the one found in the file read. |
IlvDialog::IlvDialog | ( | IlvDisplay * | display, |
const char * | name, | ||
const char * | title, | ||
const char * | filename, | ||
IlUInt | properties, | ||
const IlvRect * | rect = 0 , |
||
IlvSystemView | transientFor = 0 |
||
) |
Constructor.
Initializes a new instance of the IlvDialog
class as a top view.
display | The connection to the display. |
name | The name of the dialog. |
title | The title of the dialog. |
filename | The name of the file to be read. |
properties | The properties of the dialog. See the IlvView constructors for more details. |
rect | The size and position of the dialog. If this parameter is not provided, the size used is the one found in the file read. |
transientFor | A system view for which the dialog is transient. See the IlvView constructors for more details. |
|
virtual |
Is called when the callback associated with the apply
symbol is triggered.
Sets this object so that wasCanceled
returns IlFalse
, then hides the dialog box.
Reimplemented in IlvIFileSelector.
|
virtual |
Is called when the callback associated with the cancel
symbol is triggered.
Sets this object so that wasCanceled
returns IlTrue
, then hides the dialog box.
Displays a modal dialog.
This method is used to implement modal and preemptive dialogs. It basically calls the IlvView
method showModal(grab, cursor)
, which calls show
and enters a modal event loop. If an event player (IlvEventPlayer
) is active, it tries to use it as a source of events. This method is often used by subclasses of IlvDialog
to implement a method that returns a value from the user.
grab | A Boolean value specifying whether the dialog should be system modal, that is, it grabs input events on the whole system so that, until the function returns, other applications will not be able to get any keyboard or mouse event. In this case, you can specify a cursor to be displayed in through cursor. If grab is set to IlFalse (default), the dialog is application modal, that is, the application does not receive input events in other windows. |
cursor | The cursor that will be used when the dialog is system modal. |
© 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.