NewWindow

heapPtr NewWindow(rect bounds, string title, number flags, number priority, number forecolour, number backcolour)

Draws a new window on the screen with the specified properties and returns the structure's address.

  • bounds specify the position, width and height of the window.
  • title specifies the the text which will be written in the title bar
  • the flags specify how the window is drawn. Defined in SCI.SH, they can be one of the following:
    nwNORMAL The window will be drawn with a border.
    nwTRANSPARENT The window will not have a border, background colour, or titlebar.
    nwNOFRAME The window will be drawn without a border.
    nwTRANSPARENT_NOFRAME The window will be drawn without a border and a transparent body.
    nwTITLE The window will be drawn with a titlebar and border.
    nwNODRAW The window will not be drawn.
  • priority specifies if the window should be drawn above or below other windows. The higher the priority, the more visible it will be. With a priority of zero, it may be completely covered by other windows. To make sure your windows is visible, you can use nwON_TOP as the priority (defined in SCI.SH).
  • forecolour specifies the foreground colour for the window. It is used for text, buttons, etc.
  • backcolour specifies the background colour for the window.
Example

(var hWnd, oldPort)
= oldPort GetPort()

// Draw a white window at 50, 20 with a width of 200 100, a title, and a black foreground.
= hWnd NewWindow(
    50 20 250 120
    "Test Window"
    nwTITLE
    nwON_TOP
    clBLACK
    clWHITE
)

SetPort(hWnd)
Display("Hello in the hWnd window!")
SetPort(oldPort)
Display("Hello in the oldPort!")
DisposeWindow(hWnd)