Window types

There are multiple window types in the Screen and Windowing API . Each window type has a different use and different positioning rules, and each window is typically used to display different types of content.

You specify the window type at window creation time. The following types are available.

SCREEN_APPLICATION_WINDOW
The window type that is used to display the main application. The X and Y coordinates are always relative to the dimensions of the display.

The following image shows the Falling Blocks app in fullscreen mode.

SCREEN_CHILD_WINDOW
The subwindow type that's commonly used to display a dialog. You must add a child window to an application's window group, otherwise the child window is invisible. A child window's display properties are relative to the application window to which it belongs. For example, the X and Y coordinates of the child window are all relative to the top left corner of the application window.

SCREEN_EMBEDDED_WINDOW
Used to embed a window control within an object. Like the child window, the X and Y coordinates of the embedded window are all relative to the top left corner of the application window. You must add an embedded window to an application's window group, otherwise the embedded window is invisible.