fix docs on get-handle' from window<%>'

This commit is contained in:
Matthew Flatt 2011-01-05 08:50:21 -07:00
parent b0095111d4
commit b0d95708bf

View File

@ -1,5 +1,6 @@
#lang scribble/doc #lang scribble/doc
@(require "common.ss") @(require "common.ss"
(for-label (only-in ffi/unsafe cpointer?)))
@definterface/title[window<%> (area<%>)]{ @definterface/title[window<%> (area<%>)]{
@ -106,27 +107,23 @@ Returns the window's cursor, or @scheme[#f] if this window's cursor
} }
@defmethod[(get-handle) @defmethod[(get-handle) cpointer?]{
exact-integer?]{
Returns an exact integer representing a handle to the window in the Returns a handle to the window for the current platform's GUI
current platform's GUI toolbox. Cast this number from a C @tt{long} toolbox. The value that the pointer represents depends on the
to a platform-specific C type: platform:
@itemize[ @itemize[
@item{Windows: @tt{HWND}} @item{Windows: @tt{HWND}}
@item{Mac OS X: @tt{WindowRef} for a @scheme[top-level-window<%>] object, @item{Mac OS X: @tt{NSWindow} for a @scheme[top-level-window<%>] object,
@tt{ControlRef} for other windows} @tt{NSView} for other windows}
@item{X: @tt{Widget*}} @item{X: @tt{GtkWidget}}
] ]
Some windows may not have a representation in the platform's GUI level,
in which case the result of this method is @scheme[0].
} }