Function

Summary

Returns the underlying handle of the current dialog.

Package

capi

Signature

current-dialog-handle => handle

Values

handle

A Windows hwnd, a X windowid or a Cocoa window number.

Description

The function current-dialog-handle returns the underlying handle of the current dialog. On Windows, this is the hwnd of the current dialog. On X11/Motif this a windowid of the current dialog. On Mac OS X this is the value returned by the Cocoa 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 .

Example

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")

See also

simple-pane-handle