1 CAPI Reference Entries
popup-confirmerfunction creates a dialog with predefined implementations of OK and Cancel buttons and a user specified pane in a layout with the buttons.
popup-confirmer pane message &rest interface-args &key value-function ok-check ok-button no-button cancel-button screen exit-function ok-function no-function buttons callbacks callback-type
popup-confirmerprovides the quickest means to create new dialogs, as it will create and implement OK, Cancel and other buttons as required by your dialog, and will place a user specified pane in a layout along with the buttons.
popup-confirmer. If value-function is not supplied, then pane itself will be returned. If the value-function wants to indicate that the dialog cannot return a value currently, then it should return a second value that is non-
nilif it is acceptable for that value to be returned. These two functions are used by
popup-confirmerto decide when the OK button should be enabled, thus stopping the dialog from returning with invalid data. The OK button's state can be updated by a call to
redisplay-interfaceon the top-level, so the dialog should call it when the button may enable or disable.
nilmeaning do not include such a button. The ok-button means return successfully from the dialog, the no-button means continue but return
nil, and the cancel-button aborts the dialog. Note that there are clear expectations on the part of users as to the functions of these buttons -- check the style guidelines of the platform you are developing for.
exit-confirmer, the ok-function defaults to the
exit-functionand the no-function defaults to a function exiting the dialog with
popup-confirmer, with the functions in callbacks being associated with them. Finally callback-type will be provided as the callback type for the buttons.
make-instancefor the interface that will be displayed using
display-dialog. Thus geometry information, colors, and so on can be passed in here as well. By default, the dialog will pick up the foreground, background and font of pane.
prompt-for-string, while the second implements
(capi:popup-confirmer (make-instance 'capi:text-input-pane :callback 'capi:exit-confirmer) "Enter some text:" :value-function 'capi:text-input-pane-text) (capi:popup-confirmer nil "Yes or no?" :callback-type :none :ok-button "Yes" :no-button "No" :cancel-button nil :value-function #'(lambda (dummy) t))
:redisplay-interfaceto make the OK button enable and disable on each keystroke.
(defun pane-integer (pane) (ignore-errors (values (read-from-string (capi:text-input-pane-text pane)))))
(capi:popup-confirmer (make-instance 'capi:text-input-pane :callback 'capi:exit-confirmer :change-callback :redisplay-interface) "Enter an integer" :value-function 'pane-integer :ok-check 'integerp)
Generated with Harlequin WebMaker