public final class GralInfoBox extends java.lang.Object implements GralTextBox_ifc, GralWindow_setifc, GralWindow_getifc
GralWidget_ifc.ActionChange, GralWidget_ifc.ActionChangeWhen| Modifier and Type | Field and Description |
|---|---|
(package private) GralUserAction |
actionClear |
private GralUserAction |
actionOk |
(package private) GralUserAction |
actionOkButton |
private GralButton |
buttonLock |
private GralWidget |
buttonOk |
private GralHtmlBox |
htmlBox |
protected GralTextField |
infoLine |
private GralTextBox |
textBox
The widget which holds the text in the
window. |
static int |
version
Version, history and license.
|
private GralWidgetBase_ifc |
wdgInFocus |
private GralWindow |
window
The window is created invoking the
GralMngBuild_ifc#createWindow(String, boolean). |
sVersion| Constructor and Description |
|---|
GralInfoBox(GralWindow window,
GralHtmlBox htmlBox,
GralTextField infoLine,
GralWidget buttonOk) |
GralInfoBox(GralWindow window,
GralTextBox textBox,
GralTextField infoLine,
GralWidget buttonOk) |
| Modifier and Type | Method and Description |
|---|---|
void |
activate() |
void |
addText(java.lang.CharSequence text) |
java.lang.Appendable |
append(char arg0) |
java.lang.Appendable |
append(java.lang.CharSequence text) |
java.lang.Appendable |
append(java.lang.CharSequence arg0,
int arg1,
int arg2) |
void |
closeWindow() |
static GralInfoBox |
createHtmlInfoBox(GralMng mng,
GralPos currPos,
java.lang.String posName,
java.lang.String title,
boolean onTop)
Creates a sub window for showing html content.
|
static GralInfoBox |
createTextInfoBox(GralMng mng,
java.lang.String name,
java.lang.String title) |
GralWidget_ifc.ActionChange |
getActionChange(GralWidget_ifc.ActionChangeWhen when) |
GralColor |
getBackColor(int ix)
Gets the background color for the widget.
|
java.lang.String |
getCmd()
Any widget can have a command String, which can be quest for example in an action.
|
long |
getContentIdent()
Gets the content identification of the users data which are set with
GralWidget_ifc.setContentIdent(long). |
java.lang.Object |
getContentInfo() |
int |
getCursorCol() |
int |
getCursorLine() |
int |
getCursorPos() |
java.lang.Object |
getData()
Gets the application specific info.
|
java.lang.String |
getDataPath() |
GralWidgetBase_ifc |
getFocusedWidget()
Returns the widget which is in focus of a panel or comprehensive widget.
|
GralWidget.ImplAccess |
getImplAccess()
This is used to access to the implementation widget instance.
|
java.lang.Object |
getImplWidget()
Returns the implementation widget or its Wrapper.
|
java.lang.String |
getName()
Access to the name of the widget.
|
int |
getNrofLines() |
GralRectangle |
getPixelPositionSize() |
java.lang.String |
getText()
Returns the text of this field.
|
GralMng |
gralMng()
Returns the associated GralMng.
|
boolean |
isChanged(boolean setUnchanged)
Returns true if the content is changed from a user action on GUI.
|
boolean |
isEditable()
Query whether the table line is able to edit: Return from the whole table.
|
boolean |
isGraphicDisposed()
Returns true if the graphic implementatin widget was initialized, and then it was disposed.
|
boolean |
isInFocus()
Returns true if this widget is the focused one.
|
boolean |
isNotEditableOrShouldInitialize()
Query whether this field should be written from any initial or actual data.
|
boolean |
isVisible()
Returns whether the widget is visible or not.
|
boolean |
isWindowsVisible() |
GralPos |
pos()
Position of the widget, which refers also the
GralPos.parent. |
void |
redraw()
repaint request.
|
void |
redraw(int delay,
int latest)
Possible delayed repaint, can be called in any thread.
|
void |
refreshFromVariable(VariableContainer_ifc container)
Capability for any widget to update its content from its associated variables described in its sDataPath.
|
void |
refreshFromVariable(VariableContainer_ifc container,
long timeAtleast,
GralColor colorRefreshed,
GralColor colorOld)
Capability of any widget for
GralWidget_ifc.refreshFromVariable(VariableContainer_ifc)
but additionally the widget is shown as "too old" if the time stored with the variable is old. |
boolean |
remove() |
void |
setActionOk(GralUserAction action) |
void |
setBackColor(GralColor color,
int ix)
Sets the background color for the widget.
|
GralColor |
setBackgroundColor(GralColor color) |
void |
setBoundsPixel(int x,
int y,
int dx,
int dy)
This operation is used if the pixel are calculated on gral level.
|
void |
setCmd(java.lang.String cmd)
Any widget can have a command String, which can be quest for example in an action.
|
long |
setContentIdent(long date)
Sets a identification for the shown data.
|
int |
setCursorPos(int pos) |
void |
setData(java.lang.Object data)
Sets a application specific data.
|
void |
setDataPath(java.lang.String sDataPath)
Sets the data path.
|
void |
setEditable(boolean editable)
Sets whether it is able to edit the content of the text field or text box.
|
void |
setFocus()
Sets the focus to the widget. .
|
void |
setFocus(int delay,
int latest)
Sets the focus to the widget. .
|
void |
setFocused(boolean bGained)
This operation can be called from the implementation graphic if the focus is gained for an implementation widget.
|
void |
setFocusedWidget(GralWidgetBase_ifc widg)
If this widget is a comprehensive widget or a panel, it sets one of the content as focused.
|
GralColor |
setForegroundColor(GralColor color) |
void |
setFullScreen(boolean full) |
void |
setHtmlHelp(java.lang.String url)
Sets the html help url for this widget.
|
void |
setLineColor(GralColor color,
int ix)
Sets the line color for the widget.
|
void |
setText(java.lang.CharSequence text)
Set the textual content of the widget.
|
void |
setText(java.lang.CharSequence text,
int caretPos)
Sets the textual content and show it with the given caret position.
|
void |
setTextColor(GralColor color)
Sets the text color for the widget.
|
void |
setTextStyle(GralColor color,
GralFont font)
Sets the style of all new set and added texts.
|
void |
setUrl(java.lang.String url) |
boolean |
setVisible(boolean visible)
Sets this widget visible on graphic or invisible.
|
void |
setWindowVisible(boolean visible)
Controls whether the whole window, which contains this panel, should be visible or not.
|
void |
viewTrail()
Sets the view to the trail of the text.
|
public static final int version
#createHtmlInfoBox(GralMngBuild_ifc, String, String, boolean)
with Parameter onTop: Especially a help window should able to stay on top.
private final GralWindow window
GralMngBuild_ifc#createWindow(String, boolean).
It has its implementation in the underlying graphic system.private final GralTextBox textBox
window.private final GralHtmlBox htmlBox
private final GralWidget buttonOk
private GralButton buttonLock
protected final GralTextField infoLine
private GralUserAction actionOk
private GralWidgetBase_ifc wdgInFocus
GralUserAction actionOkButton
GralUserAction actionClear
public GralInfoBox(GralWindow window, GralTextBox textBox, GralTextField infoLine, GralWidget buttonOk)
public GralInfoBox(GralWindow window, GralHtmlBox htmlBox, GralTextField infoLine, GralWidget buttonOk)
public static GralInfoBox createTextInfoBox(GralMng mng, java.lang.String name, java.lang.String title)
public static GralInfoBox createHtmlInfoBox(GralMng mng, GralPos currPos, java.lang.String posName, java.lang.String title, boolean onTop)
posString - name - title - onTop - public void setActionOk(GralUserAction action)
public void activate()
public java.lang.String getName()
GralWidgetBase_ifcGralWidgetBase.name immediately.getName in interface GralWidgetBase_ifcpublic void setCmd(java.lang.String cmd)
GralWidget_ifcGralWidget_ifc.getCmd() independent of its name which can be set on runtime with this method.setCmd in interface GralWidget_ifcpublic java.lang.String getCmd()
GralWidget_ifcGralWidget_ifc.setCmd(String).getCmd in interface GralWidget_ifcpublic java.lang.String getDataPath()
getDataPath in interface GralWidget_ifcpublic GralWidget_ifc.ActionChange getActionChange(GralWidget_ifc.ActionChangeWhen when)
getActionChange in interface GralWidget_ifcpublic void setTextStyle(GralColor color, GralFont font)
GralTextField_ifcsetTextStyle in interface GralTextField_ifcpublic void setEditable(boolean editable)
GralWidget_ifcsetEditable in interface GralWidget_ifceditable - true then the content is going to be able to change.
False then the edit functionality is disabled.public java.lang.Appendable append(java.lang.CharSequence text)
append in interface java.lang.Appendablepublic int getNrofLines()
getNrofLines in interface GralTextBox_ifcpublic void setText(java.lang.CharSequence text)
GralTextField_ifcsetText in interface GralTextField_ifcsetText in interface GralWidget_ifctext - The contentpublic void setText(java.lang.CharSequence text,
int caretPos)
GralTextField_ifcGralTextField_ifc.setText(CharSequence) if caretPos = 0.setText in interface GralTextField_ifctext - The text to show in the widget.caretPos - 0 for left, -1 for right, 0 to Integer.MAXINT for a given position.
If the caret position is greater then the number of chars, it is set right.
That character which is left from the caret position is shown guaranteed in the text field.
Especially -1 can be given to show the text right-aligned.public void addText(java.lang.CharSequence text)
public int setCursorPos(int pos)
setCursorPos in interface GralTextField_ifcpublic void setUrl(java.lang.String url)
public boolean isEditable()
isEditable in interface GralWidget_ifcGralWidget_ifc.isEditable()public boolean isNotEditableOrShouldInitialize()
GralWidget_ifcisNotEditableOrShouldInitialize in interface GralWidget_ifcpublic boolean isGraphicDisposed()
GralWidget_ifcisGraphicDisposed in interface GralWidget_ifcpublic boolean isChanged(boolean setUnchanged)
GralWidget_ifcisChanged in interface GralWidget_ifcsetUnchanged - If true then set to unchanged with this call.public java.lang.String getText()
GralTextField_ifcgetText in interface GralTextField_ifcpublic boolean isVisible()
GralWidgetBase_ifcisVisible in interface GralWidgetBase_ifcpublic int getCursorPos()
getCursorPos in interface GralTextField_ifcpublic int getCursorLine()
getCursorLine in interface GralTextField_ifcpublic int getCursorCol()
getCursorCol in interface GralTextField_ifcpublic long setContentIdent(long date)
GralWidget_ifcGralWidget_ifc.getContentIdent().setContentIdent in interface GralWidget_ifcdate - any number which identifies the value of content.public long getContentIdent()
GralWidget_ifcGralWidget_ifc.setContentIdent(long).getContentIdent in interface GralWidget_ifcpublic void redraw()
GralWidget_ifcGralWidget_ifc.redraw(int, int)redraw in interface GralWidget_ifcpublic void redraw(int delay,
int latest)
GralWidget_ifcredraw in interface GralWidget_ifcdelay - in milliseconds. If 0 or less 0, then it is executed immediately if the calling
thread is the graphic thread.latest - The latest draw time in milliseconds. If it is <= 0, then it is unused.
Note that a new call of repaint removes an existing repaint order to the new given time.
With the latest argument for this time the repaint is always executing independent of new calls.public void viewTrail()
GralTextBox_ifcviewTrail in interface GralTextBox_ifcpublic GralColor setBackgroundColor(GralColor color)
setBackgroundColor in interface GralWidget_ifcpublic void setFocusedWidget(GralWidgetBase_ifc widg)
GralWidgetBase_ifcsetFocusedWidget in interface GralWidgetBase_ifcwidg - The sub widget which should be focused.
It influences for example the current tab of a tabbed panel,
or influences which widget of a comprehensive widget is first focused.
On a panel it determines which widget should get the focus if the panel gets the focus.public GralWidgetBase_ifc getFocusedWidget()
GralWidgetBase_ifcgetFocusedWidget in interface GralWidgetBase_ifcpublic void setFocus()
GralWidgetBase_ifcsetFocus in interface GralWidgetBase_ifcpublic void setFocus(int delay,
int latest)
GralWidget_ifcsetFocus in interface GralWidget_ifcsetFocus in interface GralWidgetBase_ifcpublic boolean isInFocus()
GralWidgetBase_ifcisInFocus in interface GralWidgetBase_ifcpublic void setFocused(boolean bGained)
setFocused in interface GralWidgetBase_ifcbGained - public void setFullScreen(boolean full)
setFullScreen in interface GralWindow_setifcpublic GralColor setForegroundColor(GralColor color)
setForegroundColor in interface GralWidget_ifcpublic boolean isWindowsVisible()
isWindowsVisible in interface GralWindow_getifcpublic void setWindowVisible(boolean visible)
GralWindow_setifcsetWindowVisible in interface GralWindow_setifcpublic java.lang.Appendable append(char arg0)
throws java.io.IOException
append in interface java.lang.Appendablejava.io.IOExceptionpublic java.lang.Appendable append(java.lang.CharSequence arg0,
int arg1,
int arg2)
throws java.io.IOException
append in interface java.lang.Appendablejava.io.IOExceptionpublic void setBoundsPixel(int x,
int y,
int dx,
int dy)
GralWidget_ifcsetBoundsPixel in interface GralWidget_ifcpublic GralRectangle getPixelPositionSize()
getPixelPositionSize in interface GralWindow_getifcpublic void closeWindow()
closeWindow in interface GralWindow_setifcpublic boolean remove()
public void setHtmlHelp(java.lang.String url)
GralWidget_ifcsetHtmlHelp in interface GralWidget_ifcurl - String given url, maybe a local file too with #internalLabel.public boolean setVisible(boolean visible)
GralWidgetBase_ifcGralWindow, its the visibility of the whole window.
Note that a window which is invisible is not shown in the task bar of the operation system.
Note that an application can have more as one window.
Note that a dialog window can be set to invisible if it is not need yet instead destroy and build newly.setVisible in interface GralWidgetBase_ifcpublic void refreshFromVariable(VariableContainer_ifc container)
GralWidget_ifcrefreshFromVariable in interface GralWidget_ifccontainer - The container is used only if the variable is not known by direct reference
in the private GralWidget.variable or GralWidget.variables. If the variable(s) is/are
not known, they are searched by there data path set by GralWidget_ifc.setDataPath(String). More as one
variables are possible separated by "," in the setDataPath("variable1, variable2").
The variables are searched in the container calling VariableContainer_ifc#getVariable(String).public void refreshFromVariable(VariableContainer_ifc container,
long timeAtleast,
GralColor colorRefreshed,
GralColor colorOld)
GralWidget_ifcGralWidget_ifc.refreshFromVariable(VariableContainer_ifc)
but additionally the widget is shown as "too old" if the time stored with the variable is old.
This helps to show the state of fields for updating.refreshFromVariable in interface GralWidget_ifctimeAtleast - The absolute time stamp after them the variable should be gotten a new value.
It may be for example some seconds before the current time.colorRefreshed - show with this background color if refreshedcolorOld - show with this background color if not refresehed.public void setDataPath(java.lang.String sDataPath)
GralWidget_ifcGralWidget_ifc.refreshFromVariable(VariableContainer_ifc).setDataPath in interface GralWidget_ifcpublic void setBackColor(GralColor color, int ix)
GralWidget_ifcsetBackColor in interface GralWidget_ifccolor - Any colorix - -1 for non-specific, 0 for the first color or if only one color is supported, 1, ... if the widget has more as one background.public GralColor getBackColor(int ix)
GralWidget_ifcgetBackColor in interface GralWidget_ifcix - 0 if only one color is supported, 1, ... if the widget has more as one background.public void setLineColor(GralColor color, int ix)
GralWidget_ifcsetLineColor in interface GralWidget_ifccolor - Any colorix - 0 if only one color is supported, 1, ... if the widget has more as one line.public void setTextColor(GralColor color)
GralWidget_ifcsetTextColor in interface GralWidget_ifccolor - Any colorpublic java.lang.Object getContentInfo()
getContentInfo in interface GralWidget_ifcpublic GralMng gralMng()
GralWidgetBase_ifcgralMng in interface GralWidgetBase_ifcpublic void setData(java.lang.Object data)
GralWidget_ifcsetData in interface GralWidget_ifcpublic java.lang.Object getData()
GralWidget_ifc#setContentInfo(Object).getData in interface GralWidget_ifcpublic GralWidget.ImplAccess getImplAccess()
GralWidgetBase_ifcgetImplAccess in interface GralWidgetBase_ifcpublic GralPos pos()
GralWidgetBase_ifcGralPos.parent.
The parent in a GralPos has usual the reference to the GralMng.pos in interface GralWidgetBase_ifcpublic java.lang.Object getImplWidget()
GralWidget_ifcgetImplWidget in interface GralWidget_ifc