textlabel statement

	<< Index >>	FutureBasic
TextLabel		statement / function

Statement syntax
textlabel tag, text, rect, wndTag

Function syntax


text = textlabel(tag)

Description
The textlabel statement puts a new textlabel in the current output window, or alters an existing textlabel's characteristics. The textlabel function returns the label's text as a CFStringRef and is equivalent to calling fn ControlStringValue.

Parameters

Parameter
Description

tag A number (1 through 1000000) that you assign when you create the textlabel and that you refer to when altering the label. The number you assign must be different from the tag value of all other existing widgets in the current window. A negative tag hides the textlabel.

text The text that appears inside the textlabel.

rect The textlabel's enclosing rectangle. This can be specified in either of two ways:

(i) (x,y,w,h) where x,y are the origin and w,h the size of the label.
(ii) A CGRect value

wndTag An optional parameter for when the textlabel's window is not the current output window. Note specifying this parameter does not bring the window to the front or make it the output window.

Subclass
To subclass a nib textlabel, set its class name to "TextFieldSC" in the nib.

See also
textfield

Apple documentation
NSTextField

Parameter	Description
tag	A number (1 through 1000000) that you assign when you create the textlabel and that you refer to when altering the label. The number you assign must be different from the tag value of all other existing widgets in the current window. A negative tag hides the textlabel.
text	The text that appears inside the textlabel.
rect	The textlabel's enclosing rectangle. This can be specified in either of two ways: (i) `(x,y,w,h)` where x,y are the origin and w,h the size of the label. (ii) A CGRect value
wndTag	An optional parameter for when the textlabel's window is not the current output window. Note specifying this parameter does not bring the window to the front or make it the output window.