OpenExtDocwin

All Editions  image\bltlrgss.gif Related Transactions  image\bltlrgss.gif Example

The OpenExtDocwin transaction opens the specified document into a new external document window. Before using this transaction, you must register the external window's handle using the RegisterExternalWindow transaction. The image will not appear until you issue the HandleExternalWindow transaction. You can do this before or after using OpenExtDocwin.

Type XTYP_EXECUTE

Syntax [OpenExtDocwin(docwinID, location, fileType, "fileName", "label", permissions, wOtherInfo, lOtherInfo, scrollBars)]

Parameter

Data type

Values

Meaning

docwinID

DWORD

identifier returned by RegisterExternalWindow. See Remarks.

location

WORD

0

file on disk

fileType

WORD

0

document type--ignored

fileName

string

file name including path of the document to open

label

string

label, maximum 80 characters

permissions

WORD

0

placeholder

wOtherInfo

WORD

0

placeholder

lOtherInfo

DWORD

0

placeholder

scrollBars

WORD

0

no scroll bars

 

 

1

horizontal scroll bar

 

 

2

vertical scroll bar

 

 

(can be ORed)

 

Remarks

When issuing 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.

Certain transactions cannot be applied to external windows.

Release information

Added in Release 3.50.

See also

Opening documents in external windows

Using external Reference and Detail windows