| **Navigation:**  [[introduction.htm|Language Reference]] > 13 - Built-in Functions >====== GETPOSITION (get control or window position) ====== | [[getnulls get the null state of a table .htm|{{btn_prev_n.gif|Previous page}}]][[introduction.htm|{{btn_home_n.gif|Return to chapter overview}}]][[getreg get windows registry entry .htm|{{btn_next_n.gif|Next page}}]] |
|  ||

{{newc7.jpg|NewC7.jpg}}

**GETPOSITION(|** //control// |[,//x// ] [, //y// ] [,// width// ] [,// height //] **)**

**| **//window// |

{{blk2blue.jpg|blk2blue.jpg}}

| **GETPOSITION** | Gets the position and size of an APPLICATION, WINDOW, REPORT or control. |
| //control// | A field number or field equate label for the control from which to get the information. If //control// is zero (0), it specifies the window. |
| //window// | The label of an APPLICATION, WINDOW, or REPORT structure, or a reference to any of those structures. |
| //X// | An integer variable to receive the horizontal position of the top left corner. |
| //Y// | An integer variable to receive the vertical position of the top left corner. |
| //width// | An integer variable to receive the width. |
| //height// | An integer variable to receive the height. |

**GETPOSITION** gets the position and size of an APPLICATION, WINDOW, REPORT, or control. The //window// parameter is used to get the position and/or dimensions of a window that currently is not on top or has focus. The position and size values are dependent upon the presence or absence of the SCROLL attribute on the //control//. If SCROLL is present, the values are relative to the virtual window. If SCROLL is not present, the values are relative to the top left corner of the currently visible portion of the window. This means the values returned always match those specified in the AT attribute or most recent SETPOSITION.

The values in the //x//, //y//, //width//, and //height// parameters are measured in dialog units. Dialog units are defined as one-quarter the average character width by one-eighth the average character height. The size of a dialog unit is dependent upon the size of the default font for the window. This measurement is based on the font specified in the FONT attribute of the window, or the system default font specified by Windows.

**Example:**

**Screen WINDOW,PRE(Scr)**

**        ENTRY(@N3),USE(Ctl:Code)**

**        ENTRY(@S30),USE(Ctl:Name)**

**        BUTTON('OK'),USE(?OkButton),KEY(EnterKey)**

**        BUTTON('Cancel'),USE(?CanxButton),KEY(EscKey)**

**       END**

**X       SHORT**

**Y       SHORT**

**Width   SHORT**

**Height  SHORT**

** CODE**

** OPEN(Screen)**

** ****GETPOSITION****(?Ctl:Code,X,Y,Width,Height)**

**See Also:**

[[setposition  specify new control position .htm|SETPOSITION]]

[[prop pixels.htm|PROP:Pixels]]