PA_OpenPluginWindow

version 2003

PA_OpenPluginWindow (areaName; wTitle; wRect) PA_PluginRef

Parameter	Type		Description
areaName	char *		Name of the external area
wTitle	char *		Window title
wRect	PA_Rect		Window coordinates
Function result	PA_PluginRef		Reference to the plug-in window

The routine PA_OpenPluginWindow creates and opens an external window for the plug-in named areaName and returns a reference to that plug-in area, just like the Open external window 4th Dimension function does.

Pass the name of the external area in areaName (starting with an underscore) and the title of the window in wTitle.

Pass the coordinates (in global system coordinates) of the window in wRect. 4D uses those coordinates to size the window once created.

Depending on default settings or on previous calls to PA_UsePStrings or PA_UseCStrings, areaName and wTitle must be Pascal or an ANSI C strings.

The plug-in must call PA_ClosePluginWindow to properly close the window. This can also be done from within 4D by calling CLOSE WINDOW, passing the PA_PluginRef as a long to this 4D command.

Launch a 4D Write area in an external window.

   PA_Handle      _4WRZone;
   PA_Rect      r = {50, 50, 450, 450};

   _4WRZone = PA_OpenPluginWindow("_4D Write", "New 4D Write zone", r);

   /* . . . some code . . . */
   PA_ClosePluginWindow(_4WRZone);

CLOSE WINDOW, Open external window, PA_ClosePluginWindow.

PA_GetLastError always returns eER_NoErr