Package qupath.lib.gui.scripting

Class TextAreaControl

java.lang.Object

qupath.lib.gui.scripting.TextAreaControl

All Implemented Interfaces:

TextAppendable, EditableText, ScriptEditorControl<TextArea>

public class TextAreaControl
extends Object
implements ScriptEditorControl<TextArea>

Simple text area control (JavaFX) with basic operations and no styling support.

Author:

Pete Bankhead

Property Summary

Properties

Type	Property	Description
ReadOnlyIntegerProperty	caretPosition	Property for the current caret position.
ObservableValue<String>	selectedText	Text currently selected in the editor control.
StringProperty	text	Text currently in the editor control.
BooleanProperty	wrapText	Request wordwrap.

Constructor Summary

Constructors

Constructor	Description
TextAreaControl(boolean isEditable)	Constructor to create a new text area and wrap it in a TextAreaControl.
TextAreaControl(TextArea textArea, boolean isEditable)	Constructor to wrap an existing text area and wrap it in a TextAreaControl.

Method Summary

Modifier and Type	Method	Description
void	appendText(String text)	Append the specified text to the appendable.
ReadOnlyIntegerProperty	caretPositionProperty()	Property for the current caret position.
void	clear()	Request clear the contents of the control.
void	copy()	Request copy the current selection.
void	cut()	Request cut the current selection.
void	deleteText(int startIdx, int endIdx)	Request deleting the text within the specified range.
void	deselect()	Deselect any currently-selected text.
int	getCaretPosition()	Gets the value of the caretPosition property.
ContextMenu	getContextMenu()	Get the context menu for the control.
TextArea	getRegion()	Get the region representing this control, so it may be added to a scene.
String	getSelectedText()	Gets the value of the selectedText property.
IndexRange	getSelection()	Get the range of the currently-selected text.
String	getText()	Gets the value of the text property.
void	insertText(int pos, String text)	Request inserting the specified text.
boolean	isRedoable()	Returns true if 'redo' can be applied to the control.
boolean	isUndoable()	Returns true if 'undo' can be applied to the control.
void	paste()	Request paste from the system clipboard.
void	positionCaret(int index)	Set the caret position to the specified index
void	redo()	Request redo.
void	replaceSelection(String text)	Insert the specified text, replacing any existing selection.
void	requestFocus()	Request that the control is focused.
ObservableValue<String>	selectedTextProperty()	Text currently selected in the editor control.
void	selectRange(int startIdx, int endIdx)	Set the range of the selected text.
void	setContextMenu(ContextMenu menu)	Set the context menu for the control.
void	setText(String text)	Sets the value of the text property.
StringProperty	textProperty()	Text currently in the editor control.
void	undo()	Request undo.
BooleanProperty	wrapTextProperty()	Request wordwrap.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface qupath.lib.gui.scripting.EditableText

getSelectionLength

Methods inherited from interface qupath.lib.gui.scripting.ScriptEditorControl

getSelectionEnd, getSelectionStart, requestFollowCaret

Property Details

text

public StringProperty textProperty

Specified by:

textProperty in interface ScriptEditorControl<TextArea>

Returns:

See Also:

• getText()
• setText(String)
• textProperty()

selectedText

public ObservableValue<String> selectedTextProperty

Specified by:

selectedTextProperty in interface ScriptEditorControl<TextArea>

Returns:

See Also:

• getSelectedText()
• selectedTextProperty()

wrapText

public BooleanProperty wrapTextProperty

Specified by:

wrapTextProperty in interface ScriptEditorControl<TextArea>

Returns:

See Also:

• wrapTextProperty()

caretPosition

public ReadOnlyIntegerProperty caretPositionProperty

Specified by:

caretPositionProperty in interface ScriptEditorControl<TextArea>

Returns:

See Also:

• getCaretPosition()
• caretPositionProperty()

Constructor Details

TextAreaControl

public TextAreaControl(boolean isEditable)

Constructor to create a new text area and wrap it in a TextAreaControl.

Parameters:

isEditable - whether the text area should be editable or not

TextAreaControl

public TextAreaControl(TextArea textArea,
 boolean isEditable)

Constructor to wrap an existing text area and wrap it in a TextAreaControl.

Parameters:

textArea - the text area to wrap

isEditable - whether the text area should be editable or not

Method Details

textProperty

public StringProperty textProperty()

Description copied from interface: ScriptEditorControl

Text currently in the editor control.

Specified by:

textProperty in interface ScriptEditorControl<TextArea>

Returns:

the text property

See Also:

• getText()
• setText(String)

setText

public void setText(String text)

Sets the value of the text property.

Specified by:

setText in interface EditableText

Property description:

Parameters:

text - the value for the text property

See Also:

• getText()
• textProperty()

getText

public String getText()

Gets the value of the text property.

Specified by:

getText in interface EditableText

Property description:

Returns:

the value of the text property

See Also:

• setText(String)
• textProperty()

selectedTextProperty

public ObservableValue<String> selectedTextProperty()

Description copied from interface: ScriptEditorControl

Text currently selected in the editor control.

Specified by:

selectedTextProperty in interface ScriptEditorControl<TextArea>

Returns:

the selectedText property

See Also:

• getSelectedText()

getSelectedText

public String getSelectedText()

Gets the value of the selectedText property.

Specified by:

getSelectedText in interface EditableText

Property description:

Returns:

the value of the selectedText property

See Also:

• selectedTextProperty()

getRegion

public TextArea getRegion()

Description copied from interface: ScriptEditorControl

Get the region representing this control, so it may be added to a scene.

Specified by:

getRegion in interface ScriptEditorControl<TextArea>

Returns:

isUndoable

public boolean isUndoable()

Description copied from interface: ScriptEditorControl

Returns true if 'undo' can be applied to the control.

Specified by:

isUndoable in interface ScriptEditorControl<TextArea>

Returns:

isRedoable

public boolean isRedoable()

Description copied from interface: ScriptEditorControl

Returns true if 'redo' can be applied to the control.

Specified by:

isRedoable in interface ScriptEditorControl<TextArea>

Returns:

undo

public void undo()

Description copied from interface: ScriptEditorControl

Request undo.

Specified by:

undo in interface ScriptEditorControl<TextArea>

redo

public void redo()

Description copied from interface: ScriptEditorControl

Request redo.

Specified by:

redo in interface ScriptEditorControl<TextArea>

copy

public void copy()

Description copied from interface: ScriptEditorControl

Request copy the current selection.

Specified by:

copy in interface ScriptEditorControl<TextArea>

cut

public void cut()

Description copied from interface: ScriptEditorControl

Request cut the current selection.

Specified by:

cut in interface ScriptEditorControl<TextArea>

paste

public void paste()

Description copied from interface: ScriptEditorControl

Request paste from the system clipboard.

Specified by:

paste in interface ScriptEditorControl<TextArea>

clear

public void clear()

Description copied from interface: EditableText

Request clear the contents of the control.

Specified by:

clear in interface EditableText

appendText

public void appendText(String text)

Description copied from interface: TextAppendable

Append the specified text to the appendable.

Specified by:

appendText in interface EditableText

Specified by:

appendText in interface TextAppendable

Parameters:

text - the text to be appended

getCaretPosition

public int getCaretPosition()

Gets the value of the caretPosition property.

Specified by:

getCaretPosition in interface EditableText

Property description:

Returns:

the value of the caretPosition property

See Also:

• caretPositionProperty()

insertText

public void insertText(int pos,
 String text)

Description copied from interface: EditableText

Request inserting the specified text.

Specified by:

insertText in interface EditableText

Parameters:

pos - position to insert the text

text - the text to insert

deleteText

public void deleteText(int startIdx,
 int endIdx)

Description copied from interface: EditableText

Request deleting the text within the specified range.

Specified by:

deleteText in interface EditableText

Parameters:

startIdx -

endIdx -

deselect

public void deselect()

Description copied from interface: EditableText

Deselect any currently-selected text.

Specified by:

deselect in interface EditableText

getSelection

public IndexRange getSelection()

Description copied from interface: ScriptEditorControl

Get the range of the currently-selected text.

Specified by:

getSelection in interface ScriptEditorControl<TextArea>

Returns:

selectRange

public void selectRange(int startIdx,
 int endIdx)

Description copied from interface: EditableText

Set the range of the selected text.

Specified by:

selectRange in interface EditableText

Parameters:

startIdx -

endIdx -

wrapTextProperty

public BooleanProperty wrapTextProperty()

Description copied from interface: ScriptEditorControl

Request wordwrap.

Specified by:

wrapTextProperty in interface ScriptEditorControl<TextArea>

Returns:

the wrapText property

positionCaret

public void positionCaret(int index)

Description copied from interface: EditableText

Set the caret position to the specified index

Specified by:

positionCaret in interface EditableText

Parameters:

index -

replaceSelection

public void replaceSelection(String text)

Description copied from interface: EditableText

Insert the specified text, replacing any existing selection.

Specified by:

replaceSelection in interface EditableText

Parameters:

text - the text to insert

setContextMenu

public void setContextMenu(ContextMenu menu)

Description copied from interface: ScriptEditorControl

Set the context menu for the control.

Specified by:

setContextMenu in interface ScriptEditorControl<TextArea>

Parameters:

menu -

getContextMenu

public ContextMenu getContextMenu()

Description copied from interface: ScriptEditorControl

Get the context menu for the control.

Specified by:

getContextMenu in interface ScriptEditorControl<TextArea>

Returns:

requestFocus

public void requestFocus()

Description copied from interface: ScriptEditorControl

Request that the control is focused.

Specified by:

requestFocus in interface ScriptEditorControl<TextArea>

caretPositionProperty

public ReadOnlyIntegerProperty caretPositionProperty()

Description copied from interface: ScriptEditorControl

Property for the current caret position.

Specified by:

caretPositionProperty in interface ScriptEditorControl<TextArea>

Returns:

the caretPosition property

See Also:

• getCaretPosition()