4D Doc Center : Open external window

Home

4D v14.3

Open external window


Open external window ( left ; top ; right ; bottom ; type ; title ; plugInArea ) -> Function result

Parameter	Type	Description
left	Longint	Global left coordinate of window contents area
top	Longint	Global top coordinate of window contents area
right	Longint	Global right coordinate of window contents area
bottom	Longint	Global bottom coordinate of window contents area
type	Longint	Window type
title	String	Title of window
plugInArea	String	External area command
Function result	WinRef	Reference number for window and external area

Description

Open external window opens a new window and displays the external area supported by the command plugInArea provided by a 4D plug-in. The code passed in plugInArea is generally in the form "_PluginName", for example: _4D Write, _4D View.

Open external window returns a Long Integer value that can be used both as a window reference number (that can be used with other Windows theme commands) and as a reference to the external area displayed in the window (that can be used with other routines provided by the 4D plug-in).

The first six arguments are the same as those of the the Open window command. However, none of the parameters are optional.

Open external window creates modeless windows. The command does not wait for user input, so you can have several active windows open at once. You can click between each window and edit the one in front. If the window type has a title bar, a Control-menu box (Windows) or a Close Box (Macintosh) will be added to enable the user to close the window.

Example

The following example opens an external window and displays the 4D Write external area:

wrWind:=Open external window(50;50;350;450;8;"Letter Writing";"_4D WRITE")

The following example closes the external window opened in the previous example:

CLOSE WINDOW(wrWind)