IN_OpenExternalDocumentWindow

All Editions $image\bltlrgsq_shg.gif$ Related Functions $image\bltlrgsq_shg.gif$ Example

The IN_OpenExternalDocumentWindow function opens the specified document into an external document window. Before using this function, you must register the external window's handle with the IN_RegisterExternalWindow function. The image will not appear until you issue the IN_HandleExternalWindow function. You can do this before or after calling IN_OpenExternalDocumentWindow.

Syntax

int IN_OpenExternalDocumentWindow( docwinID, location, pFilename, label, flags )

Parameters	Values	Meaning
IN_DOCWIN docwinID	identifier returned by IN_RegisterExternalWindow. See Remarks.
SHORT location	IN_LOCN_DISK	the file is located on a disk
CHARPTR pFilename	file name and path of the document to open
CHARPTR label	label, maximum 80 characters
USHORT flags	IN_FLAG_SCROLLBAR_NONE (0) do not display scroll bars IN_FLAG_SCROLLBAR_HORZ (1) display the horizontal scroll bar IN_FLAG_SCROLLBAR_VERT (2) display the vertical scroll bar IN_FLAG_SCROLLBAR_BOTH (3) display both scroll bars

Remarks

When you issue commands to external document windows, you must use a specific docwinID, even if you are referring to the active document. There is no way to identify the "active" document window in another application.

Release information

Added to Imagenation for Windows in Release 4.10.

Not supported in Imagenation for UNIX.

See also

Opening documents into external windows

Opening documents: basic