set_valuesB(3x) — HP-UX 9.05

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

wSpecifies the widget whose nonwidget resource values are to be changed.

argsSpecifies the argument list that was passed to XtSetValues().

num_argsSpecifies 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.

Museum