set_values_hook() set_values_hook()
Name
set_values_hook - obsolete Object method for handling changes to subpart resources.
Synopsis
typedef Boolean (*XtArgsFunc)(Widget, ArgList, Cardinal *);
Widget w;
ArgList args;
Cardinal *num_args;
Inputs
w Specifies the widget whose nonwidget resource values are to be changed.
args Specifies the argument list that was passed to XtSetValues().
num_args Specifies the number of arguments in the argument list.
Returns
True if the widget should be redrawn; False otherwise.
Availability
Obsolete in Release 4 and later.
Description
The set_values_hook() method is registered on the set_values_hook field of the Object, RectObj, or Core class part structure. It is called
by XtSetValues() after the class's set_values() method has been called.
As of Release 4, the set_values_hook() method is obsolete, because the args and num_args arguments are now passed to the set_values()
method. Its purpose had been to allow the value of subpart resources to be set from the argument list, by calling XtSetSubvalues() for
example.
The arguments to the set_values_hook() method are the widget and the argument list that were passed to XtSetValues(). The widget will have
been modified by any superclass methods that have already been called. It should return True if the change to subpart resources will
require the widget to be redraw, and False otherwise.
The set_values_hook() method is chained in superclass-to-subclass order and is called for compatibility with older widgets. It cannot be
inherited, and any new widget classes should set their set_values_hook field to NULL. See XtSetValues(1) for details on when this method
is called. See set_values(4) for a discussion of setting the values of subpart resources, and other resources that do not appear on the
class resource list.
See Also
XtSetSubvalues(1), XtSetValues(1),
Core(3),
set_values(4).
Xt - Intrinsics Methods set_values_hook()
