widget-set-value

Arguments: widget-window dialog-item new-value old-value recursive-p

This generic function is called by the system when the dialog-item's window is opened and when its value is changed. (The dialog-item is the second argument and its window, the value of (window dialog-item) (see window), is the first argument.) This generic function should not be called by programs and the default method should not be replaced as it updates the screen to reflect the change in the state of dialog-item and returns a true value if the new value is permissible (if it returns nil, the change will be undone). However, after methods may be added to perform other program-specific tasks.

recursive-p will be true if the value of the widget was changed interactively by the user (such as by typing into a text widget) rather than by an application called (setf value). This tells the widget-set-value method that it does not need to update the visible widget-window, because that was done already by the user interaction.

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.