This function is used to abort the current dialog. For example, it can be made a selection callback from a Cancel button so that pressing the button aborts the dialog. In a similar manner the complementary function exit-dialog can be used as a callback for an OK button.
(capi:display-dialog
(capi:make-container
(make-instance 'capi:push-button
:text "Cancel"
:callback 'capi:abort-dialog)
:title "Test Dialog"))
Also see the examples in the directory
examples/capi/dialogs/
.