org.vishia.gral.base

Class GralTextBox

java.lang.Object

org.vishia.gral.base.GralWidgetBase

org.vishia.gral.base.GralWidget

org.vishia.gral.base.GralTextField

org.vishia.gral.base.GralTextBox

All Implemented Interfaces:

java.lang.Appendable, GetGralWidget_ifc, GralSetValue_ifc, GralTextBox_ifc, GralTextField_ifc, GralWidget_ifc, GralWidgetBase_ifc

public class GralTextBox
extends GralTextField
implements java.lang.Appendable, GralTextBox_ifc

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GralTextBox.XXXLineColumn

Nested classes/interfaces inherited from class org.vishia.gral.base.GralTextField

GralTextField.GraphicImplAccess, GralTextField.Type

Nested classes/interfaces inherited from class org.vishia.gral.base.GralWidget

GralWidget.ActionChangeSelect, GralWidget.ConfigData, GralWidget.DynamicData, GralWidget.ImplAccess

Nested classes/interfaces inherited from class org.vishia.gral.base.GralWidgetBase

GralWidgetBase.GralWidgComposite, GralWidgetBase.TimeOrderCreateImplWidget

Nested classes/interfaces inherited from interface org.vishia.gral.ifc.GralWidget_ifc

GralWidget_ifc.ActionChange, GralWidget_ifc.ActionChangeWhen

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	sVersion Version and history 2022-01-31 Hartmut chg: append(CharSequence) without IOException.

Fields inherited from class org.vishia.gral.base.GralTextField

borderwidth, bPassword, gralKeyListener, newText, sPrompt, sPromptStylePosition, user, version

Fields inherited from class org.vishia.gral.base.GralWidget

_wdgImpl, bEditable, bShouldInitialize, cfg, contextMenu, dateUser, dyda, htmlHelp, lastTimeSetVisible, redrawDelayMax, redrawtDelay, sCmd, sFormat, showWidgetInfo, sToolTip, whatIs, XXXbuildMng

Fields inherited from class org.vishia.gral.base.GralWidgetBase

_cdata, _wdgPos, bVisibleState, gralMng, name, pixSize

Fields inherited from interface org.vishia.gral.ifc.GralTextBox_ifc

version

Constructor Summary

Constructors

Constructor and Description
GralTextBox(GralPos refPos, java.lang.String posName, boolean editable, java.lang.String prompt, char promptStylePosition, GralTextField.Type... property)
GralTextBox(GralPos refPos, java.lang.String posName, GralTextField.Type... property) Constructs a gral text box.

Method Summary

Modifier and Type	Method and Description
java.lang.Appendable	append(char arg0) Append a single char, able to call threadsafe in any thread.
java.lang.Appendable	append(java.lang.CharSequence arg0) Append the text, able to call threadsafe in any thread.
java.lang.Appendable	append(java.lang.CharSequence arg0, int arg1, int arg2) Append a sub char sequence, able to call threadsafe in any thread.
int	getNrofLines()
void	setEditable(boolean editable) Sets whether it is able to edit the content of the text field or text box.
void	viewTrail() Sets the view to the trail of the text.

Methods inherited from class org.vishia.gral.base.GralTextField

getCursorCol, getCursorLine, getCursorPos, getPrompt, getValue, setBorderWidth, setCursorPos, setFormat, setLongValue, setPrompt, setPrompt, setText, setText, setText, setTextStyle, setTextStyle, setUser, setValue, setValue, setValue

Methods inherited from class org.vishia.gral.base.GralWidget

clearShowParam, createImplWidget_Gthread, getActionChange, getActionChangeStrict, getActionDrag, getActionDrop, getActionFocused, getActionShow, getBackColor, getCfgElement, getCmd, getCmd, getContentIdent, getContentInfo, getContextMenu, getData, getDataIx, getDataPath, getDataPath, getFloatValue, getFocusedWidget, getFormat, getGralWidget, getHtmlHelp, getImplAccess, getImplWidget, getItsPanel, getLongValue, getName, getShowMethod, getShowParam, getsToolTip, getText, getVariable, getVariableFromContentInfo, isChanged, isEditable, isGraphicDisposed, isInFocus, isNotEditableOrShouldInitialize, isVisible, redraw, redraw, redraw, redraw1, redrawOnlyDynamics, refreshFromVariable, refreshFromVariable, removeImplWidget_Gthread, requestNewValueForVariable, setActionChange, setActionFocused, setActionMouse, setActionShow, setBackColor, setBackgroundColor, setBoundsPixel, setCfgElement, setCmd, setContentIdent, setContentInfo, setData, setDataIx, setDataPath, setDragEnable, setDropEnable, setFocus, setFocus, setFocusedWidget, setForegroundColor, setHtmlHelp, setLineColor, setMinMax, setPrimaryWidgetOfPanel, setTextColor, setToolTip, setToPanel, setValue, setValue, setVariable, setVisible, specifyActionChange, specifyContextMenu, stop, toString, toString, XXXgetWidgetImplementation, XXXremoveWidgetImplementation, XXXrepaintGthread, XXXsetFocusGThread

Methods inherited from class org.vishia.gral.base.GralWidgetBase

checkImplWidgetCreation, createImplWidget, gralMng, hasFocus, pos, remove, resizePostPreparation, setFocused

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.vishia.gral.ifc.GralTextField_ifc

getCursorCol, getCursorLine, getCursorPos, getText, setCursorPos, setText, setText, setTextStyle

Methods inherited from interface org.vishia.gral.ifc.GralWidget_ifc

getActionChange, getBackColor, getCmd, getContentIdent, getContentInfo, getData, getDataPath, getImplWidget, isChanged, isEditable, isGraphicDisposed, isNotEditableOrShouldInitialize, redraw, redraw, refreshFromVariable, refreshFromVariable, setBackColor, setBackgroundColor, setBoundsPixel, setCmd, setContentIdent, setData, setDataPath, setFocus, setForegroundColor, setHtmlHelp, setLineColor, setTextColor

Methods inherited from interface org.vishia.gral.ifc.GralWidgetBase_ifc

getFocusedWidget, getImplAccess, getName, gralMng, isInFocus, isVisible, pos, setFocus, setFocused, setFocusedWidget, setVisible

Field Detail

sVersion

public static final java.lang.String sVersion

Version and history

• 2022-01-31 Hartmut chg: append(CharSequence) without IOException. It is possible in Java though the interface defines an IOException. Here not necessary and more simple for application.
• 2022-01-31 Hartmut chg: Some stuff is commented now, because it is all in GralTextField, because SwtTextFieldWrapper contains all necessities. Not an extra implementation class.
• 2014-08-16 Hartmut chg: Now Implementation uses the same class, as GralTextField, inheritance was done before. It is very more simple. Same only additional features for GralTextBox and GralTextField
• 2014-08-16 Hartmut chg: GrapTextBox not abstract, using GraphicImplAccess like new concept of all GralWidgets.
• 2012-01-06 Hartmut chg: The append(CharSequence) etc. methods are implemented in this super class instead in the graphic layer implementation classes. Therefore the methods #appendTextInGThread(CharSequence) and #setTextInGThread(CharSequence) are defined here to implement in the graphic layer. The set- and apppend methods are threadsafe now.

Copyright/Copyleft: For this source the LGPL Lesser General Public License, published by the Free Software Foundation is valid. It means:

1. You can use this source without any restriction for any desired purpose.
2. You can redistribute copies of this source to everybody.
3. Every user of this source, also the user of redistribute copies with or without payment, must accept this license for further using.
4. But the LPGL is not appropriate for a whole software product, if this source is only a part of them. It means, the user must publish this part of source, but don't need to publish the whole source of the own product.
5. You can study and modify (improve) this source for own using or for redistribution, but you have to license the modified sources likewise under this LGPL Lesser General Public License. You mustn't delete this Copyright/Copyleft inscription in this source file.

If you are indent to use this sources without publishing its usage, you can get a second license subscribing a special contract with the author.

See Also:

Constant Field Values

Constructor Detail

GralTextBox

public GralTextBox(GralPos refPos,
                   java.lang.String posName,
                   GralTextField.Type... property)

Constructs a gral text box.

Parameters:

refPos - contains the parent position, correct with posName for further usage. The internal used GralPos is cloned. This refPos is not referenced in the instance.

posName - Position and Name of the field. Maybe null if it is not need in management by name See GralWidget#GralWidget(String, char).

property - password, editable, maybe left empty.

GralTextBox

public GralTextBox(GralPos refPos,
                   java.lang.String posName,
                   boolean editable,
                   java.lang.String prompt,
                   char promptStylePosition,
                   GralTextField.Type... property)

Parameters:

refPos - contains the parent position, correct with posName for further usage. The internal used GralPos is cloned. This refPos is not referenced in the instance.

posName - Position and Name of the field. Maybe null if it is not need in management by name See GralWidget#GralWidget(String, char).

editable - true: can edit. It is also possible to set it with setEditable(boolean)

prompt - a prompt, also able to set with GralTextField.setPrompt(String, String) but here concentrated.

promptStylePosition - 't' ...

property - password, editable, maybe left empty.

Method Detail

append

public final java.lang.Appendable append(java.lang.CharSequence arg0)

Append the text, able to call threadsafe in any thread. If the thread is the graphic thread, the text will be appended to the current text of the widget immediately. But if the thread is any other one, the text will be stored in a StringBuilder and the graphic thread will be waked up with the #appendTextViewTrail dispatch listener.

Specified by:

append in interface java.lang.Appendable

See Also:

Appendable.append(java.lang.CharSequence)

append

public final java.lang.Appendable append(char arg0)

Append a single char, able to call threadsafe in any thread.

Specified by:

append in interface java.lang.Appendable

See Also:

append(CharSequence), Appendable.append(java.lang.CharSequence)

append

public final java.lang.Appendable append(java.lang.CharSequence arg0,
                                         int arg1,
                                         int arg2)

Append a sub char sequence, able to call threadsafe in any thread.

Specified by:

append in interface java.lang.Appendable

See Also:

append(CharSequence), Appendable.append(java.lang.CharSequence, int, int)

setEditable

public void setEditable(boolean editable)

Description copied from interface: GralWidget_ifc

Sets whether it is able to edit the content of the text field or text box. If a content is not able to edit, it is a showing field or box. The user can't change the content. But the user can set the cursor, select any text and copy to the systems clipboard. If the content is able to edit, the change should be notified and the content should be gotten. To do that TODO

Specified by:

setEditable in interface GralWidget_ifc

Overrides:

setEditable in class GralWidget

Parameters:

editable - true then the content is going to be able to change. False then the edit functionality is disabled.

getNrofLines

public int getNrofLines()

Specified by:

getNrofLines in interface GralTextBox_ifc

viewTrail

public void viewTrail()

Description copied from interface: GralTextBox_ifc

Sets the view to the trail of the text.

Specified by:

viewTrail in interface GralTextBox_ifc