CreateTextWindow

CreateTextWindow

The CreateTextWindow function opens a new Mira Text Editor window. The title and size can be specified.

Syntax

pointer = CreateTextWindow( sTitle=nil, CRect=nil )

sTitle is a string that specifies the window caption. if nil, a default is used.

CRect is a rectangle specifying the fractional dimensions of the window in terms of the Mira viewport. All CRect members must be between 0 and 1. If CRect is not specified or is nil, then a default window size is used.
On success, this method returns a pointer to the Mira Text Window.
On failure, nil is returned.

Remarks

This is a global version of the CTextView class new method. After creating the text window using this function, you can use the global Wprintf function to write to the window. If a Text Editor window already exists with the specified name, this function returns a reference to the existing window. Otherwise, a new Text Editor is created.

Note that the CRect argument specifies a window size in terms of the current Mira viewport (the main window size). For example, if CRect contains the dimensions (0.1, 0.7, 0.1, 0.7), then a window will be created that extends from 10% to 70% of the viewport size.

Example

The following script fragment opens a Mira Text Editor window with the specified title:

ptr = CreateTextWindow("My Title")	-- create a new instance T of the CTextView class.
Wprintf(ptr, fmt, "my text...")	-- write to the window by passing its pointer, ptr

The next example creates a new CTextView with a specified title and size

sTitle = "My Window Title"	-- window title
R = CRect:new(0.1,0.7,0.1,0.7)	-- window rectangle relative to main window
ptr = CreateTextWindow(sTitle, R)	-- create a new window with title and size
Wprintf(ptr, fmt, "my text...")	-- write to the window by passing its pointer, ptr