You may return to the Cvo Object Documenation Index from this document. This document contains the following sections describing the Cvo__Modal object:
Cvo__Modal
Cvo_Window
#include
<Cvo/Modal.h++>
BOOL
Cvo_Modal ( char *resource,
Cvo_Object *parent,
void (*builder)(Cvo__Modal *, void *),
[ void *data ] )
The Cvo__Modal object is always created by the Cvo_Modal()
function.
During creation, the user defined function builder will be called.
The first argument passed to the builder function will be a pointer
to the Cvo__Modal object, which should be the parent of all objects
inside the modal box. The second argument will be the data argument
passed to Cvo_Modal()
.
Once the function builder returns, Cvo_Modal will process events
until either Okay()
or Cancel()
are called on the Cvo__Modal object.
Cvo_Modal() will return True
if Okay()
was called, or False
if
Cancel()
is called.
This object defines the following member functions in addition to those defined by its parent and ancestor objects.
Okay (
)
This member function should be called when the user finishes using the
modal box. It will cause a True
value to be returned by Cvo_Modal().
Cancel (
)
This member function should be called when the user finishes using the
modal box. It will cause a False
value to be returned by Cvo_Modal().
This object modifies the following X resources which are used by its parent or other ancestors.
*CvoModal.Pad
(new value:
10
)
*CvoModal.InternalPad
(new value:
10
)
*Color*CvoModal.Raise
(new value:
1
)
*CvoModal.Raise
(new value:
10
)
See the example source code for an example of how to use this object.
See the legend for information about the conventions used in this documentation.