current-dialog-handle

current-dialog-handle Function

Summary

Returns the underlying handle of the current dialog.

Package

capi

Signature

current-dialog-handle => handle

Values

handle

A platform-specific value, or nil.

Description

The function current-dialog-handle returns the underlying handle of the current dialog, as follows:

Microsoft Windows	The hwnd of the dialog.
GTK+	A pointer to the GdkWindow.
Motif	A windowid of the dialog.
Cocoa	The value returned by the NSWindow's `windowNumber` method.

This value is useful if you want to perform some operation on the underlying handle that the CAPI does not supply.

If there is no current dialog, current-dialog-handle returns nil.

Examples

Press on "Get handle" to see the handle of the dialog.

(capi:popup-confirmer
 (make-instance 
  'capi:push-button
  :text "Get handle"
  :callback-type :none
  :selection-callback 
  #'(lambda ()
      (capi:display-message
       (format nil "current-dialog-handle ~a~%"
               (capi:current-dialog-handle)))))
 nil
 :title "A dialog")