view:link-to-window
List of: Scheme Extensions
Subjects: Viewing
Contents: Graphic Interaction

Action: Maps a view to an externally-created window.

Filename: gi/gi_scm/view_scm_gi.cxx

Syntax: (view:link-to-window window [parent] [part])

Arg Types: window integer

parent integer

part part

Returns: view

Description: Maps a view to an externally-created window. To associate a window with an external application, use this extension to assign the external (parent) application to the window. The argument window specifies the window identification number assigned to that window. To determine the current viewing parameters, use the env:views extension. The optional argument parent specifies the external window ID to associate with the visible window. It is used to resolve ambiguities in cases where the external application generates 16-bit window handles. If the optional argument part is specified, then the view is associated with that part; otherwise, it is associated with the active part.

Limitations: This extension is available on all platforms, but produces results only on NT using OpenGL.

Example: ; view:link-to-window

; Get a list of all current views.

(env:views)

;; (#[view 1075533160])

; Link a view to an externally created window.

(view:link-to-window 1075488368)

;; #[view 1075533160]
PDF/GI/03SCV.PDF
HTM/DATA/GI/GI/03SCV/0021.HTM