150 lines
2.6 KiB
Racket
150 lines
2.6 KiB
Racket
#lang scribble/manual
|
|
@(require (for-label racket))
|
|
|
|
@title{TextField}
|
|
A view displaying editable text@section{categories}
|
|
GUI>Views
|
|
|
|
@section{description}
|
|
|
|
A view displaying editable text.
|
|
|
|
|
|
@section{CLASSMETHODS}
|
|
|
|
|
|
@section{PRIVATE}
|
|
key
|
|
|
|
|
|
|
|
@section{INSTANCEMETHODS}
|
|
|
|
|
|
|
|
@section{SUBSECTION}
|
|
Data
|
|
|
|
@section{METHOD}
|
|
string
|
|
The text displayed in the view.
|
|
|
|
@section{argument}
|
|
|
|
A String.
|
|
|
|
@section{METHOD}
|
|
object
|
|
If link::#-setBoth:: is true, setting this variable also sets link::#-string:: to the value interpreted link::Classes/Object#-asString#as String::.
|
|
|
|
@section{argument}
|
|
|
|
Any object, typically one which makes sense to display as a string, such as a Float.
|
|
|
|
@section{METHOD}
|
|
setBoth
|
|
A variable stating whether setting link::#-object:: will also set link::#-string::.
|
|
|
|
@section{argument}
|
|
|
|
A Boolean.
|
|
|
|
@section{METHOD}
|
|
value
|
|
Gets the same as link::#-string::, but when setting also sets link::#-string:: to the value interpreted link::Classes/Object#-asString#as String:: regardless of the link::#-setBoth:: flag.
|
|
|
|
@section{argument}
|
|
|
|
Any object, typically one which makes sense to display as a string, such as a Float.
|
|
|
|
@section{METHOD}
|
|
valueAction
|
|
Sets link::#-value:: and triggers link::#-action::.
|
|
|
|
|
|
@section{SUBSECTION}
|
|
Appearance
|
|
|
|
@section{METHOD}
|
|
align
|
|
The alignment of the displayed text. See link::Reference/gui_alignments:: for possible values.
|
|
|
|
@section{METHOD}
|
|
font
|
|
The font used to display the text.
|
|
|
|
@section{argument}
|
|
|
|
A Font.
|
|
|
|
@section{METHOD}
|
|
stringColor
|
|
The color used to display the text.
|
|
|
|
@section{argument}
|
|
|
|
A Color.
|
|
|
|
@section{METHOD}
|
|
background
|
|
Setting this variable colors the inside of the field under the text with the given color.
|
|
|
|
@section{argument}
|
|
|
|
A Color.
|
|
|
|
|
|
@section{SUBSECTION}
|
|
Actions
|
|
|
|
@section{METHOD}
|
|
action
|
|
The action object evaluated whenever the user changes the text.
|
|
|
|
|
|
@section{SUBSECTION}
|
|
Drag and drop
|
|
|
|
@section{METHOD}
|
|
defaultGetDrag
|
|
@section{returns}
|
|
|
|
The displayed link::#-string::.
|
|
|
|
@section{METHOD}
|
|
defaultCanReceiveDrag
|
|
@section{returns}
|
|
|
|
Always true.
|
|
|
|
@section{METHOD}
|
|
defaultReceiveDrag
|
|
Sets link::#-valueAction:: to the current drag data.
|
|
|
|
|
|
@section{EXAMPLES}
|
|
|
|
|
|
@racketblock[
|
|
(
|
|
w = Window.new.front;
|
|
a = TextField(w, Rect(10, 10, 150, 20));
|
|
a.string = "hi there";
|
|
a.action = {arg field; field.value.postln; };
|
|
)
|
|
|
|
// does not do the action
|
|
a.value = "yo";
|
|
a.string = "oy";
|
|
|
|
a.valueAction_("this is not a pipe"); //does the action, if the value has changed
|
|
a.doAction; //evaluates the action with the content of the text field as an argument
|
|
|
|
a.background_(Color.grey);
|
|
a.stringColor_(Color.white);
|
|
a.align_(\center);
|
|
::
|
|
|
|
]
|
|
|
|
|