====== PlaceDialog() routine     ======


 
==== Description ====
 
Places a window on the screen at specific positions.  This routine should be used during the CREATE event of a window.  This routine will also make the window visible.
 
==== Syntax ====
 
PlaceDialog( xPos, yPos )
 
==== Parameters ====
 
The function has the following parameters:

^Parameter^Description^
|xPos|__Value__ __Description__\\ -2 - Centers the window within the screen.\\ -1 - Centers the window within the owner window.\\ Integer value - The x coordinate at which to place the window.  The coordinate is relative to the owner window.|
|yPos|__Value__ __Description__\\ -2 - Centers the window within the screen.\\ -1 - Centers the window within the owner window.\\ Integer value - The y coordinate at which to place the window.  The coordinate is relative to the owner window.|

 
==== See Also ====
 
[[size|SIZE property]]


==== Examples ====

<code>
declare subroutine PlaceDialog

* Center a window to the screen

PlaceDialog( -2, -2 )

 

* Center a window to the owner window

PlaceDialog( -1, -1 )

 

* Set the window's position to a 5 pixel xy offset to the owner window

PlaceDialog( 5, 5 )
</code>