Creates a static box user control on the user window that is specified by
A static box is simply some text, used to label other controls, or provide feedback.
The control is initially placed in the top-left corner of the user window, and must be placed by using the
-pos option, or by using the setControlPos command.
The command returns the control ID of the user control, which should be saved for later operations on the control.
|int||yes||ID of user window to place the control on.|
|Name||Flag arguments||Argument type||Exclusive to||Comments|
|0||—||—||Specifies that the text be right justified in the control. The default is left justified.|
|0||—||—||Specifies that the text be centered in the control. The default is left justified.|
|0||—||—||Specifies that text be allowed to span more than one line. This does not cause text to automatically wrap. Rather, hitting Ctrl+Enter will start a new line. Default is single line.|
|0||—||—||Specifies that the text box show *s in place of the text. Good for passwords.|
|0||—||—||Specifies that the text be uneditable. No modification to the text can be made by the user.|
|0||—||—||Specifies that the control should be hidden initially. Call showControl to subsequently make it visible. The default is for it to be visible.|
|1||string||—||The text that gets displayed with the control. The default is no text.|
|1||integer array||—||A four-element int array representing a rectangle, which specifies the initial size/position of the control relative to the top left corner of the user window. The element order is Left, Top, Right, and Bottom. The default is a text box 20 units high by 50 units wide.|
|1||integer||—||Control ID of the form user control which will dynamically position this control.|
// Create a Text Box user control.
// First create a user window to place the control on
$windowId = `createWindow "MyWindow"`;
// Specify the size of the control - 100 units wide
$rect = 20; // Left
$rect = 20; // Top
$rect = 120; // Right
$rect = 40; // Bottom
// Create the control on the window, passing
// in the Window Id of the user window we just created.
$controlId = `createTextBox $windowId-text "This is some text!" -pos $rect`;