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.

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
Handles