GralMng

java.lang.Object
- EventTimerThread
- - org.vishia.gral.base.GralMng

All Implemented Interfaces:

GralMng_ifc, GralMngBuild_ifc
```
public class GralMng
extends EventTimerThread
implements GralMngBuild_ifc, GralMng_ifc
```
This is the Manager for the graphic. It contains the independent parts of graphic organization. This class GralMng is a common approach to work with graphical interface simply. The inner class GralMng.ImplAccess is implemented by the several graphic-system-supporting classes.
- SwtMng
- AwtMng
The GralPos instances referred here are not recommended. It's the deprecated concept. Use own instances for refPos to build the Gral Graphic.

The GralMng instance contains a list of all widgets sorted by name:
- getWidget(String) returns the reference to the named widget.
- getWidgetIter() returns an iterator over all widgets.
Important operations, may set breakpoints there:
- runGraphicThread(): This is called firstly on implementing the graphic.
- createImplWidget_Gthread(GralWidget): This operation need to be overridden in the implementation graphic, see SwtMng.createImplWidget_Gthread(GralWidget). This operation checks all kinds of widget (should know all) and selects (switch-case) and creates the proper mapping implementation widgets.

Nested Class Summary

Nested Classes
Modifier and Type	Class and Description
`static class`	`GralMng.FileSelectInfo` This class is used for a selection field for file names and paths.
`class`	`GralMng.GralMngFocusListener` This standard Gral focus listener is the base class for the common implementation layer focus listener.
`static class`	`GralMng.ImplAccess` This class is used only for the implementation level of the graphic.
`class`	`GralMng.InternalPublic` This inner class is public only because the implementation uses it.
`static class`	`GralMng.LogMsg` This class defines only static numbers for messages.
`(package private) static class`	`GralMng.PosThreadSafe`

Field Summary

Fields
Modifier and Type	Field and Description
`GralMng.InternalPublic`	`_implListener` Implementation specific fields.
`GralMng.ImplAccess`	`_mngImpl` The graphic specific implementation part of the GralMng This implementation should care about the correct implementation widgets.
`GralUserAction`	`actionClose` This is one action to close the whole application.
`GralUserAction`	`actionDesignEditField` Action to edit the properties of one widget in the graphic.
`GralUserAction`	`actionFileSelect`
`GralUserAction`	`actionHelp`
`GralPanelActivated_ifc`	`actionPanelActivate`
`GralUserAction`	`actionReadPanelCfg` Action to edit the properties of one widget in the graphic.
`(package private) GralUserAction`	`actionShowWidgetInfos`
`protected GralMngApplAdapter_ifc`	`applAdapter`
`private java.lang.Thread`	`awakeThread`
`protected boolean`	`bBelow` True if the next element should be placed below the last.
`protected boolean`	`bDesignerIsInitialized` Some actions may be processed by a user implementation.
`boolean`	`bDesignMode`
`private boolean`	`bDispatcherSleeps` True then the dispatcher sleeps, does not work.
`protected boolean`	`bExitMain` Set to true to finish the main.
`protected boolean`	`bIsExitImplGraphic`
`protected boolean`	`bRigth` True if the next element should be placed below the last.
`protected boolean`	`bShouldExitImplGraphic` set to true to exit the graphic thread and dispose the implementation graphic
`protected boolean`	`bShouldExitMain` Set to true to finish the main.
`protected boolean`	`bStarted` True if the startup of the main window is done and the main window is visible.
`private GralCfgData`	`cfgData`
`(package private) GralCfgWriter`	`cfgWriter`
`protected MinMaxTime`	`checkTimes` Instance to measure execution times.
`java.util.List<GralCurveView_ifc>`	`curveContainer` Deprecated.
`private java.util.Map<java.lang.String,java.lang.String>`	`dataReplace` Map of replacements of paths to data.
`(package private) boolean`	`debugPrint`
`protected GralCfgDesigner`	`designer` The designer is an aggregated part of the PanelManager, but only created if necessary.
`EventSource`	`evSrc`
`GralMng.GralMngFocusListener`	`gralFocusListener` This instance can be used if any other focus listener is necessary for any implementation widget.
`GralGridProperties`	`gralProps` Properties of the Gui appearance.
`protected long`	`graphicThreadId` The thread id of the managing thread for graphic actions.
`protected java.util.Map<java.lang.String,GralWidgetBase>`	`idxNameWidgets` Index of all input fields to access symbolic for all panels.
`protected java.util.Map<java.lang.String,GralPanel_ifc>`	`idxPanels` Map of all panels.
`protected java.util.Map<java.lang.String,GralWidget>`	`idxShowFields` Index of all input fields to access symbolic.
`protected java.util.Map<java.lang.String,GralWindow>`	`idxWindows` Map of all windows.
`GralInfoBox`	`infoBox` Three windows as sub window for html help, info and logging created if the primary window is created.
`GralInfoBox`	`infoHelp` Three windows as sub window for html help, info and logging created if the primary window is created.
`GralInfoBox`	`infoLog` Three windows as sub window for html help, info and logging created if the primary window is created.
`protected boolean`	`isWakedUpOnly`
`private GralWidget_ifc`	`lastClickedWidget` Last focused widget or last selected line in a table.
`protected java.util.concurrent.ConcurrentLinkedQueue<GralVisibleWidgets_ifc>`	`listVisiblePanels` List of all panels which may be visible yet.
`(package private) java.util.Queue<GralWidget>`	`listWidgetsPermanentUpdating`
`LogMessage`	`log` It is possible to write any message via this class to a logging system.
`private GralMng.PosThreadSafe`	`posCurrent` The current position as helper if it is the same thread.
`private java.util.Map<java.lang.Long,GralMng.PosThreadSafe>`	`posThreadSafe`
`GralGridProperties.ImplAccess`	`propertiesGui` Properties of the Gui appearance.
`private java.util.concurrent.ConcurrentLinkedQueue<GralGraphicOrder>`	`queueOrdersToExecute` Queue of orders to execute in the graphic thread before dispatching system events.
`(package private) InspcReplAlias`	`replacerAlias`
`private java.lang.Runnable`	`runAwakeThread`
`private java.lang.Runnable`	`runGraphicThread`
`GralPanel_ifc`	`screen` Representation of the 'whole screen' as parent for a window.
`protected java.lang.String`	`sCurrPanel` Any kind of TabPanel for this PanelManager TODO make protected
`private java.lang.String`	`sHelpBase`
`static java.lang.String`	`sVersion` Version, history and license.
`protected java.util.Map<java.lang.String,GralUserAction>`	`userActions` Index of all user actions, which are able to use in Button etc.
`protected GralUserAction`	`userMainKeyAction`
`private java.util.List<GralWidget>`	`widgetsInFocus`
`private GralWindow`	`windPrimary` The one instance of the primary window created in the `org/vishia/ifc/GralFactory#createWindow(String, String, int)` .
`(package private) GralCfgBuilder`	`XXXcfgBuilder` This instance helps to create the Dialog Widget as part of the whole window.
`private static GralMng`	`XXXsingleton`

Fields inherited from interface org.vishia.gral.ifc.GralMngBuild_ifc
propGridZoomedPanel, propZoomedPanel, version

Fields inherited from interface org.vishia.gral.ifc.GralMng_ifc
cmdBackColor, cmdClear, cmdCloseWindow, cmdColor, cmdInsert, cmdLineColor, cmdRedraw, cmdRemove, cmdSelect, cmdSet, cmdSetWindowVisible, cmdTextColor, version

Constructor Summary

Constructors
Constructor and Description

GralMng()

GralMng(LogMessage log)
Creates the GralMng with a given logging output,

Constructors
Constructor and Description
`GralMng()`
`GralMng(LogMessage log)` Creates the GralMng with a given logging output,

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`GralArea9Panel`	`addArea9Panel(java.lang.String posName)` Add a panel with 9 areas to any other panel or window.
`GralButton`	`addButton(java.lang.String sName, GralUserAction action, java.lang.String sButtonText)` Adds a button
`GralButton`	`addButton(java.lang.String sName, GralUserAction action, java.lang.String sCmd, java.lang.String sDataPath, java.lang.String sButtonText)` Adds a button
`GralButton`	`addButton(java.lang.String sName, java.lang.String sButtonText, GralUserAction action)`
`GralButton`	`addCheckButton(java.lang.String sPosName, java.lang.String sButtonTextOn, java.lang.String sButtonTextOff, java.lang.String sButtonTextDisabled, GralColor colorOn, GralColor colorOff, GralColor colorDisabled)` Adds a button which is switching on or off.
`GralCurveView`	`addCurveViewY(java.lang.String sPosName, int nrofXvalues, GralCurveView.CommonCurve common, TimedValues tracksValues)` Adds a curve view for displaying values with ordinary x-coordinate.
`void`	`addDispatchOrder(GralGraphicOrder order)` Adds the order to execute in the graphic dispatching thread.
`GralTextField`	`addFileSelectField(java.lang.String name, java.util.List<java.lang.String> listRecentFiles, java.lang.String startDirMask, java.lang.String prompt, java.lang.String promptStylePosition)` Adds a special text field to select a file.
`void`	`addFocusAction(GralWidget widgetInfo, GralUserAction action, java.lang.String sCmdEnter, java.lang.String sCmdRelease)` Adds the given Focus action to the known widget.
`GralWidget`	`addFocusAction(java.lang.String sName, GralUserAction action, java.lang.String sCmdEnter, java.lang.String sCmdRelease)` Adds the given Focus action to the named widget.
`GralHtmlBox`	`addHtmlBox(java.lang.String name)` Adds a box which presents html content.
`java.lang.Object`	`addImage(java.lang.String sName, java.io.InputStream imageStream, int height, int width, java.lang.String sCmd)`
`void`	`addInfo(java.lang.CharSequence info, boolean show)`
`GralLed`	`addLed(java.lang.String sName, java.lang.String sDataPath)` Adds a Led (round)
`void`	`addLine(GralColor color, java.util.List<GralPoint> points)` Deprecated.
`void`	`addLine(int colorValue, float xa, float ya, float xe, float ye)` Deprecated.
`GralPanelContent`	`addPanel(java.lang.String posName)` Add a panel to any other panel or window.
`GralWidget`	`addSlider(java.lang.String sName, GralUserAction action, java.lang.String sShowMethod, java.lang.String sDataPath)`
`GralButton`	`addSwitchButton(java.lang.String sName, GralUserAction action, java.lang.String sCmd, java.lang.String sDataPath, java.lang.String sButtonText, GralColor colorOff, GralColor colorOn)` Adds a button which saves its state, pressed or non-pressed.
`GralButton`	`addSwitchButton(java.lang.String sName, java.lang.String sButtonTextOff, java.lang.String sButtonTextOn, GralColor colorOff, GralColor colorOn)` Adds a button which is switching on or off.
`GralPanelContent`	`addTabbedPanel(java.lang.String posName)` Add a panel to any other panel or window which contains only other panels as tab
`GralTable`	`addTable(java.lang.String sPosName, int height, int[] columnWidths)` Adds a table, which is able to scroll.
`GralPanelContent`	`addTabPanel(java.lang.String posName, java.lang.String nameTab)` Add a panel as tab pabel.
`GralWidget`	`addText(java.lang.String text)` Adds a text to the current panel at given position with standard colors, left origin.
`GralWidget`	`addText(java.lang.String sText, char size, int color)` Deprecated.
`void`	`addText(java.lang.String name, java.lang.CharSequence text)` Deprecated.
`GralWidget`	`addText(java.lang.String sText, int origin, GralColor textColor, GralColor backColor)` Adds a text to a named widget.
`GralTextBox`	`addTextBox(java.lang.String posName)`
`GralTextBox`	`addTextBox(java.lang.String name, boolean editable, java.lang.String prompt, char promptStylePosition)` Adds a text box for showing or editing a text in multi lines.
`GralTextField`	`addTextField(java.lang.String name)`
`GralTextField`	`addTextField(java.lang.String name, boolean editable)`
`GralTextField`	`addTextField(java.lang.String name, boolean editable, java.lang.String prompt, java.lang.String promptStylePosition)` Adds a text field at the current position.
`GralTextField`	`addTextField(java.lang.String name, GralTextField.Type property)`
`GralTextField`	`addTextField(java.lang.String name, java.lang.String prompt, java.lang.String promptStylePosition, GralTextField.Type... property)` Adds a text field for showing or editing a text value.
`GralValueBar`	`addValueBar(java.lang.String sName, java.lang.String sDataPath)`
`GralWindow`	`addWindow(java.lang.String posName, java.lang.String sTitle)` Add a standard window remove on close, resizeable.
`GralWindow`	`addWindow(java.lang.String posName, java.lang.String sTitle, int props)`
`void`	`buildCfg(GralCfgData data, java.io.File fileCfg)` Sets the builder for content configuration.
`GralRectangle`	`calcWidgetPosAndSize(GralPos pos, GralRectangle parentPix, int widthWidgetNat, int heightWidgetNat)` Calculates the pixel position and size with a given GralPos for the given size of display appearance.
`protected void`	`checkAdmissibility(boolean value)`
`void`	`closeApplication()`
`void`	`closeImplGraphic()` Terminates the run loop of the graphic thread
`void`	`closeMainWindow()`
`GralPanelContent`	`createCompositeBox(java.lang.String name)` Creates a box inside the current panel to hold some widgets.
`protected GralMenu`	`createContextMenu(GralWidget widg)`
`GralFileDialog_ifc`	`createFileDialog()` Creates a file or directory dialog.
`void`	`createGraphic(java.lang.String implementor, char sizeShow, LogMessage log)` Creates the whole graphically representation with all given widgets on Gral level.
`GralPanelContent`	`createGridPanel(java.lang.String namePanel, GralColor backGround, int xG, int yG, int xS, int yS)` Creates an independent grid panel which is managed by this.
`GralInfoBox`	`createHtmlInfoBox(java.lang.String posName, java.lang.String title, boolean onTop)`
`void`	`createHtmlInfoBoxes(MainCmd mainCmd)` This routine should be called in the initializing routine in the graphic thread one time.
`void`	`createImplWidget_Gthread(GralWidget widgg)` Not that this routine must not invoked before the `GralFactory#createWindow(GralWindow, char, int, int, int, int)` was not called.
`protected GralMenu`	`createMenuBar(GralWindow windg)`
`GralInfoBox`	`createTextInfoBox(java.lang.String name, java.lang.String title)`
`protected void`	`createThread_()` Creates and starts the thread.
`static GralMng`	`createWindow(java.lang.String graphicBaseSystem)` Creates an nee Panel Manager in a new Window.
`GralWindow`	`createWindow(java.lang.String posName, java.lang.String title, int windProps)` Creates only the GralWindow with position in GralMng
`boolean`	`currThreadIsGraphic()` Returns true if the current thread is the graphical thread.
`(package private) void`	`deregisterPanel(GralPanel_ifc panel)`
`void`	`deregisterWidgetName(GralWidgetBase widg)`
`(package private) void`	`deregisterWindow(GralWindow wind)`
`private GralWidgetBase`	`findWidget(java.lang.String name)`
`java.util.Map<java.lang.String,java.lang.String>`	`getAllValues()`
`GralMngApplAdapter_ifc`	`getApplicationAdapter()`
`GralColor`	`getColor(java.lang.String sColorName)` Gets the named color.
`int`	`getColorValue(java.lang.String sColorName)` Gets the value to the named color.
`GralPanelContent`	`getCurrentPanel()`
`GralWidget_ifc`	`getLastClickedWidget()` Returns that widget which was clicked by mouse at last.
`java.util.List<GralWidgetBase>`	`getListCurrWidgets()` Deprecated.
`GralPanel_ifc`	`getPanel(java.lang.String name)`
`GralPos`	`getPosCheckNext()`
`GralPos`	`getPositionInPanel()` Gets the current position in the panel to store anywhere other.
`GralPos`	`getPosOldPositioning()` Used for deprecated style, without independent GralWidget.
`GralWindow`	`getPrimaryWindow()`
`GralUserAction`	`getRegisteredUserAction(java.lang.String name)`
`ReplaceAlias_ifc`	`getReplacerAlias()`
`java.util.Set<java.util.Map.Entry<java.lang.String,GralWidget>>`	`getShowFields()` Returns a Set of all fields, which are created to show.
`long`	`getThreadIdGui()`
`java.lang.String`	`getValue(java.lang.String sName)` Gets the value from a widget.
`java.lang.String`	`getValueFromWidget(GralWidget widgd)` Returns null if the widget value can only be gotten platform-depending.
`java.util.concurrent.ConcurrentLinkedQueue<GralVisibleWidgets_ifc>`	`getVisiblePanels()` Gets the list of all panels which are visible yet and should be updated with values therefore.
`GralWidgetBase`	`getWidget(java.lang.String name)` Searches a widget by name.
`GralWidget`	`getWidgetInFocus()`
`java.lang.Iterable<GralWidgetBase>`	`getWidgetIter()`
`java.util.List<GralWidget>`	`getWidgetsInFocus()` Returns a list of the last widgets in focus in there focus order.
`GralVisibleWidgets_ifc`	`getWidgetsPermanentlyUpdating()` Gets a list of widgets which should be updated permanently because they store data in any time.
`GralWidget_ifc`	`getWindow(java.lang.String name)`
`void`	`initCfgDesigner()`
`void`	`initScript(java.lang.CharSequence script)` Initialize the graphic with a script.
`void`	`initScript(java.io.File script)` Initialize the graphic with a script.
`boolean`	`isImplementationGraphicTerminated()`
`boolean`	`isRunning()` Returns true so long the application should run (indpendent of implementation graphic)
`boolean`	`isStarted()`
`LogMessage`	`log()`
`void`	`markWidgetForDesign(GralWidget widgg)`
`void`	`notifyFocus(GralWidget widgd)` Deprecated.
`EventTimerThread`	`orderList()`
`(package private) GralMng.PosThreadSafe`	`pos()`
`void`	`pressedLeftMouseDownForDesign(GralWidget widgd, GralRectangle xy)` It will be called only at the GUI-implementation level.
`GralGridProperties`	`propertiesGui()`
`void`	`redrawWidget(java.lang.String sName)` Forces the redrawing for all set samples.
`GralPos`	`refPos()` Returns the current position of this thread to work with it.
`void`	`refreshCurvesFromVariable(VariableContainer_ifc container)` refresh all curve views.
`void`	`registerPanel(GralPanel_ifc panel)` Registers a panel to place the widgets.
`void`	`registerShowField(GralWidget widg)`
`void`	`registerUserAction(java.lang.String name, GralUserAction action)` Registers all user actions, which are able to use in Button etc.
`void`	`registerWidget(GralWidgetBase widgd)` Register all widgets, which are created in its own classes, not add here.
`(package private) void`	`registerWidget(java.lang.String name, GralWidgetBase widgd)`
`void`	`registerWindow(GralWindow window)` register a window only called in the `GralWindow.GralWindow(GralPos, String, String, int, GralMng)`.
`void`	`releaseLeftMouseForDesign(GralWidget widgd, GralRectangle xy, boolean bCopy)` It will be called only at the GUI-implementation level.
`boolean`	`remove(GralPanel_ifc compositeBox)` Removes a composite box from the graphic representation.
`boolean`	`remove(GralWidget widget)`
`(package private) void`	`removeWidget(java.lang.String name)`
`void`	`repaint()` Forces a newly paint of the GUI-container.
`void`	`repaintCurrentPanel()` Forces a newly paint of the current panel.
`void`	`reportGralContent(java.lang.Appendable out)` Reports all existing Widgets on Gral level, sorted to `GralWindow`.
`void`	`resizeWidget(GralWidget widgd, GralRectangle parentPix)` Forces the resizing of the given widged.
`protected void`	`runGraphicThread()` The run method of the graphic thread.
`java.lang.String`	`saveCfg(java.io.Writer dest)` Deprecated. should be a property only of `GuiCfg`
`void`	`selectPanel(GralPanel_ifc panel)` Selects the given panel as current panel to build some content.
`GralPanel_ifc`	`selectPanel(java.lang.String sName)` selects a registered panel for the next add-operations.
`void`	`selectPrimaryWindow()` Selects the primary window as current panel to build some content.
`void`	`setApplicationAdapter(GralMngApplAdapter_ifc adapter)`
`void`	`setBackColor(GralWidget widg, int ix, int color)` Deprecated.
`void`	`setBackColor(java.lang.String name, int ix, int color)` Sets the background color of any widget.
`void`	`setDesignMode(boolean mode)` Sets or resets the design mode.
`void`	`setFinePosition(int line, int yPosFrac, int ye, int yef, int column, int xPosFrac, int xe, int xef, char direction, int border, int borderFrac, GralPos frame)` Same as `GralMngBuild_ifc.setPositionSize(int, int, int, int, char)`, but the positions can be in a fine division.
`void`	`setFocus(GralWidget widgd)` Deprecated.
`void`	`setHelpBase(java.lang.String path)`
`void`	`setHelpUrl(java.lang.String urlSuffix)` Sets the URL for the current help situation.
`void`	`setHtmlHelp(java.lang.String url)`
`void`	`setInfo(java.lang.CharSequence text)`
`void`	`setLastClickedWidget(GralWidget_ifc lastClickedWidgetInfo)` This method is called whenever the left mouse is pressed on a widget, whiches
`void`	`setLed(GralWidget widg, int colorBorder, int colorInner)` Deprecated.
`void`	`setLineColor(GralWidget widg, int ix, int color)` Deprecated.
`void`	`setLog(LogMessage log)` Changes or sets the log output.
`GralUserAction`	`setMainKeyAction(GralUserAction userMainKeyAction)` Sets the action for main keys.
`void`	`setNextPosition()` Deprecated.
`void`	`setNextPositionUnused()` Not for user: Checks whether the position is used, sets the next position then, markes the position as used.
`void`	`setPos(GralPos pos)` Sets the position in a Thread safe kind.
`GralPos`	`setPos(java.lang.String sPosition)` Sets the position with a given String, see `GralPos.setPosition(CharSequence, GralPos)` whereby the parent is the current position value.
`void`	`setPosition(float line, float lineEndOrSize, float column, float columnEndOrSize, char direction)` Sets the position.
`void`	`setPosition(float line, float lineEndOrSize, float column, float columnEndOrSize, char direction, float border)` Sets the position with fine position given as float value.
`void`	`setPosition(GralPos framePos, float line, float lineEndOrSize, float column, float columnEndOrSize, char direction)` Sets the position in relation to a given position.
`void`	`setPosition(GralPos framePos, float line, float lineEndOrSize, float column, float columnEndOrSize, char direction, float border)`
`void`	`setPositionSize(int line, int column, int height, int width, char direction)` Sets the position and size for the next widget to add in the container.
`void`	`setPosPanel(GralPanel_ifc panel)` Deprecated.
`void`	`setProperties(GralGridProperties.ImplAccess props)`
`void`	`setSampleCurveViewY(java.lang.String sName, float[] values)` Adds a sampling value set.
`void`	`setSize(float height, float width)` Sets the size of the position and remark it as unused.
`void`	`setTabbedPanel(GralPanel_ifc tabbedPanel)` It is a special routine for tabbedPanel.
`void`	`setText(java.lang.String name, java.lang.CharSequence text)` Sets the text into a named widget.
`void`	`setTextColor(GralWidget widg, int ix, int color)` Deprecated.
`void`	`setValue(java.lang.String widget, java.lang.Object visibleInfo, java.lang.Object userData)` Sets the text into a named widget.
`void`	`showInfo(java.lang.CharSequence text)`
`protected void`	`stepAwakeThread()` This thread has only the task to wake up the graphic thread.
`private int`	`stepGraphicThread()` The step routine of the graphic thread
`(package private) void`	`stop()`
`(package private) GralUserAction`	`userMainKeyAction()` package private
`void`	`waitForStart()`
`protected void`	`wakeup_()` Necessary operation to wakeup the graphic thread.
`void`	`wakeup()` This method should wake up the execution of the graphic thread because some actions are registered..
`void`	`writeLog(int msgId, java.lang.Exception exc)` Writes a log message instead throwing an exception or writing on standard output.
`static boolean`	`XXXcreate(LogMessage log)` Creates the singleton instance of the GralMng.
`void`	`XXXpressedRightMouseDownForDesign(GralWidget widgd, GralRectangle xy)` It will be called only at the GUI-implementation level.
`boolean`	`XXXsetWindowsVisible(GralWindow_ifc window, GralPos atPos)` Sets a given and registered window visible at the given position and size or set it invisible.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - sVersion
```
public static final java.lang.String sVersion
```
    Version, history and license.
    - 2023-08-02 only some adaptions. Sime ctor of Widgets without extra GralMng reference.
    - 2022-11-14 Hartmut chg: Handle wakeup problem TODO, workarround now: It seems that the graphic thread is not woken up if a redraw() comes in a shorter time.
    - 2022-11-14 Hartmut chg: Now the EventTimerThread and the graphic thread is one thread. This has the advantage that an expired time order (now as org.vishia.event.TimeOrder can immediately execute its org.vishia.event.EventWithDst#evDst. org.vishia.event.EventConsumer#processEvent(EventObject) in the same thread, without dequeue and enqueue in the graphic thread. Lesser number of thread switches.
      But because the graphic thread wait operation in SWT cannot wake up in a given time, it needs a timer thread only used for wake up. This is the awakeThread.
    - 2022-11-14 Hartmut new GralMng.LogMsg with some constants for organization of log messages with the LogMessage#sendMsg(int, CharSequence, Object...) approach. The real logged messages can be filtered with this numbers.
    - 2022-11-14 Hartmut new now reportGralContent(Appendable) for all existing windows defined here.
    - 2022-11-14 Hartmut new now initScript(CharSequence) wrapped here for more simple user programming.
    - 2022-11-14 Hartmut rename now refPos() instead currPos().
    - 2022-10-27 Hartmut chg now the singleton concept is obsolete. Some more refactoring.
    - 2022-10-27 Hartmut new createGraphic(String, char, LogMessage) is now localized here (where else!).
    - 2020-02-01 Hartmut new actionClose sets the property to close a main Window.
    - 2016-11-04 Hartmut chg: notifyFocus(GralWidget): Only widgets with datapath. It is only for the inspector etc. TODO: Is there a list necessary? Store only the last widget in focus!
    - 2016-09-02 Hartmut new: #setPosPanel(GralPanelContent) now invoked especially from ctor of GralPanelContent and from ctor of GralPanelContent.ImplAccess. If a new Panel was created with a given GralWidgetBase.pos() then that panel is set as current one for the next widgets. Either the widgets are created before the implementation graphic with given position string, then the panel should have a position string too to assigned them. Or the widgets are created with creation of the implementation graphic, then a panel should be created in the same kind, and invoke #setPosPanel(GralPanelContent) in the ctor of its implementation. The contract is unchanged: A created panel determines that all following widgets are created on that panel.
    - 2016-09-02 Hartmut chg: #registerPanel(GralPanelContent) is only be called in the ctor of GralPanelContent because any panel is based on GralPanelContent. The definition of the panel in the pos() used for the next widgets are done now in the extra routine #setPosPanel(GralPanelContent).
    - 2016-09-01 Hartmut chg: instead implements ReplaceAlias_ifc now contains getReplacerAlias(). It is an extra class for a ReplacerAlias given independent of the graphic.
    - 2016-07-20 Hartmut chg: instead setToPanel now #createImplWidget_Gthread(). It is a better name.
    - 2015-10-29 Hartmut chg: Problem on pos() with a second thread: The MainWindow- GralPos#panel was registered in another thread and therefore unknown in the new pos() for that thread. Solution: If the thread-specific GralPos will be created, it should copy the data from the posCurrent which is valid any case for valid initial data.
    - 2015-10-26 Hartmut new: The help and info box is an integral part of the GralMng and therefore available for any small application without additional effort. Only the createHtmlInfoBoxes(MainCmd) should be invoked in the graphic thread while initializing the application.
    - 2015-07-13 Hartmut chg: GralMng.GralMngFocusListener.focusLostGral(GralWidget) now invokes the GralWidget#actionFocused too. The action should distinguish between focus gained and focus lost in its action routine. That should be added to the code. Done for all vishia sources.
    - 2015-07-13 Hartmut new: registerUserAction(String, GralUserAction) now knows possibility of usage the own name with ""
    - 2015-07-13 Hartmut chg: Positioning: The new concept gets a position in the constructor of GralWidget via getPosCheckNext(). That routine sets the current position in this class to GralMng.PosThreadSafe.posUsed for further using to increment. That is correct. The problem before was faulty old-concept usage of org.vishia.gral.swt.SwtMng#XXXsetPosAndSizeSwt which invokes setNextPosition() which increments the position too, therefore twice. The usage of that routine is prevented for Swt implementation, TODO for awt yet now.
    - 2015-05-31 Hartmut chg: GralMng.GralMngFocusListener: invokes repaint() because of maybe changed outfit on focus gained
    - 2015-05-02 Hartmut chg: #registerWidget(GralWidget) is obsolete now, it is empty yet. Instead #registerWidget(String, GralWidget) by given name and removeWidget(String) by name. See description of registering on GralWidget#setToPanel(GralMngBuild_ifc).
    - 2015-04-27 Hartmut new #selectPanel(GralPanelContent) not only with String given
    - 2015-01-18 Hartmut chg: Now the implementation for any Grahic (SwtMng) and the GralMng are two separated instances. The SwtMng extends the GralMng.ImplAccess which accesses all private data of the GralMng.
    - 2013-12-21 Hartmut new: createImplWidget_Gthread(GralWidget) for all set to panel actions. That method handles all widget types.
    - 2013-03-20 Hartmut adap: actionFileSelect with setText(...), now the file select field was filled.
    - 2012-08-20 Hartmut new: getWidgetsPermanentlyUpdating() created but not used yet because refreshCurvesFromVariable(VariableContainer_ifc) has the necessary functionality.
    - 2012-06-30 Hartmut new: Composition #widgetHelper The widget helper is implemented in the graphic system for example as SwtWidgetHelper to do some widget specific things.
    - 2012-06-30 Hartmut new: Composition _implListener.GralMng.InternalPublic.gralKeyListener
    - 2012-04-22 Hartmut new: addLine(GralColor, List) to add in a GralCanvasStorage.
    - 2012-04-01 Hartmut new: #addDataReplace(Map), #replaceDataPathPrefix(String). using alias in the GralWidget.setDataPath(String). The resolving of the alias is done only if the datapath is used. *
    - 2012-03-17 Hartmut new: #calcWidgetPosAndSize(GralPos, int, int) as abstract method.
    - 2012-03-10 Hartmut chg: addText(String) now uses the background color GralGridProperties.colorBackground_.
    - 2012-01-14 Hartmut chg: #registerWidget(GralWidget): uses GralPanelContent#addWidget(GralWidget, boolean).
    - 2012-01-14 Hartmut new getValueFromWidget(GralWidget) implementing here for non-platform depending values, especially GralTable.
    - 2011-12-26 Hartmut new setApplicationAdapter(GralMngApplAdapter_ifc) to support context sensitive help by focusGained of widgets.
    - 2011-11-18 Hartmut new getLastClickedWidget() to get the last clicked widget in any user routine. The information about the widget can be used to capture widgets for any script.
    - 2011-11-17 Hartmut new addText(String) as simple variant.
    - 2011-11-14 Hartmut bugfix: copy values of GralTabbedPanel.pos to this.pos instead set the reference from GralWidgetMng to GralTabbedPanel.pos The bug effect was removed panel in GralTabbedPanel.pos because it was the same instance as GralWidgetMng.
    - 2011-10-01 Hartmut chg: move #registerPanel(GralPanelContent) from the SWT implementation to this.
    - 2011-10-01 Hartmut new: method getPanel(String) to get a registered panel by name.
    - 2011-09-30 Hartmut new: actionDesignEditField. It is the action which is called from menu now.
    - 2011-09-29 Hartmut chg: #calcWidgetPosAndSize(GralPos, int, int, int, int): calculates dy and dx one pixel less.
    - 2011-09-23 Hartmut chg: All implementation routines for positioning are moved to the class GralPos. This class contains only wrappers now.
    - 2011-09-18 Hartmut chg: Inner static class GuiChangeReq now stored in an own class GralWidgetChangeRequ.
    - 2011-09-18 Hartmut new: : GralPos#setFinePosition(int, int, int, int, int, int, int, int, int, char, GralPos) calculates from right or bottom with negative values.
    - 2011-09-10 Hartmut chg: Renaming this class, old name was GuiMngBase.
    - 2011-09-10 Hartmut chg: Some routines form SWT implementation moved to this base class. It doesn't depends on the underlying graphic base.
    - 2011-08-13 Hartmut chg: New routines for store and calculate the position to regard large widgets.
    Old History from GralGraphicThread
    - 2022-09-04 in runGraphicThread() set the thread ID before (!) the implementation is started.
    - 2020-02-01 in runGraphicThread(): The GralWindow_ifc.windHasMenu is not forced, it is set compatible in GralArea9MainCmd#parseArgumentsAndInitGraphic(String, String, char, String).
      Usage of GralWindow#GralWindow(String, String, String, int) should add GralWindow_ifc.windResizeable etc. additionally.
    - 2016-07-16 Hartmut chg: The main window will be created with same methods like all other windows.
    - 2015-01-17 Hartmut chg: Now it is an own instance able to create before the graphic is established. The graphical implementation extends the GralMng.ImplAccess.
    - 2012-04-20 Hartmut bugfix: If a GralGraphicOrder throws an exception, it was started again because it was in the queue yet. The proplem occurs on build graphic. It was repeated till all graphic handles are consumed. Now the #queueGraphicOrders entries are deleted first, then executed. TODO use this class only for SWT, use the adequate given mechanism for AWT: java.awt.EventQueue.invokeAndWait(Runnable). use Runnable instead GralDispatchCallbackWorker.
    - 2012-03-15 Hartmut chg: Message on exception.
    - 2011-11-08 Hartmut new: Delayed orders to dispatch in the graphic thread: Some actions need some calculation time. If they are called in a fast repetition cycle, a follow up effect may occur. Therefore actions should be registered with a delayed start of execution, the start time should be able to putting off till all repetitions (for example key repetition) are done.
    - 2011-11-00 Hartmut created: as own class from Swt widget manager.
    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 intent 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
  - posCurrent
```
private GralMng.PosThreadSafe posCurrent
```
    The current position as helper if it is the same thread. Initialized firstly empty.
  - posThreadSafe
```
private final java.util.Map<java.lang.Long,GralMng.PosThreadSafe> posThreadSafe
```
  - XXXcfgBuilder
```
GralCfgBuilder XXXcfgBuilder
```
    This instance helps to create the Dialog Widget as part of the whole window. It is used only in the constructor. Therewith it may be defined stack-locally. But it is better to show and explain if it is access-able at class level.
  - cfgWriter
```
GralCfgWriter cfgWriter
```
  - designer
```
protected GralCfgDesigner designer
```
    The designer is an aggregated part of the PanelManager, but only created if necessary. TODO check whether it should be disposed to #gralDevice .
  - cfgData
```
private GralCfgData cfgData
```
  - bDesignMode
```
public boolean bDesignMode
```
  - bDesignerIsInitialized
```
protected boolean bDesignerIsInitialized
```
    Some actions may be processed by a user implementation.
  - propertiesGui
```
public GralGridProperties.ImplAccess propertiesGui
```
    Properties of the Gui appearance.
  - gralProps
```
public final GralGridProperties gralProps
```
    Properties of the Gui appearance.
  - idxNameWidgets
```
protected final java.util.Map<java.lang.String,GralWidgetBase> idxNameWidgets
```
    Index of all input fields to access symbolic for all panels.
  - idxShowFields
```
protected final java.util.Map<java.lang.String,GralWidget> idxShowFields
```
    Index of all input fields to access symbolic. NOTE: The generic type of WidgetDescriptor is unknown, because the set is used independently from the graphic system.
  - idxPanels
```
protected final java.util.Map<java.lang.String,GralPanel_ifc> idxPanels
```
    Map of all panels. A panel may be a dialog box etc.
  - screen
```
public final GralPanel_ifc screen
```
    Representation of the 'whole screen' as parent for a window.
  - idxWindows
```
protected final java.util.Map<java.lang.String,GralWindow> idxWindows
```
    Map of all windows. One of them is the primary one
  - windPrimary
```
private GralWindow windPrimary
```
    The one instance of the primary window created in the org/vishia/ifc/GralFactory#createWindow(String, String, int) .
  - widgetsInFocus
```
private final java.util.List<GralWidget> widgetsInFocus
```
  - infoHelp
```
public GralInfoBox infoHelp
```
    Three windows as sub window for html help, info and logging created if the primary window is created.
  - infoBox
```
public GralInfoBox infoBox
```
    Three windows as sub window for html help, info and logging created if the primary window is created.
  - infoLog
```
public GralInfoBox infoLog
```
    Three windows as sub window for html help, info and logging created if the primary window is created.
  - sHelpBase
```
private java.lang.String sHelpBase
```
  - listVisiblePanels
```
protected final java.util.concurrent.ConcurrentLinkedQueue<GralVisibleWidgets_ifc> listVisiblePanels
```
    List of all panels which may be visible yet. The list can be iterated. Therefore it is lock-free multi-threading accessible.
  - listWidgetsPermanentUpdating
```
java.util.Queue<GralWidget> listWidgetsPermanentUpdating
```
  - log
```
public LogMessage log
```
    It is possible to write any message via this class to a logging system. All internal methods of gral writes exceptions to that logging system instead abort the execution of the application. This is an association, can be null, should not be null while working. See GralMng(LogMessage) and #setLog
  - applAdapter
```
protected GralMngApplAdapter_ifc applAdapter
```
  - curveContainer
```
@Deprecated
public final java.util.List<GralCurveView_ifc> curveContainer
```
    Deprecated.
    
    Composition of some curve view widgets, which should be filled indepentent of there visibility.
  - bBelow
```
protected boolean bBelow
```
    True if the next element should be placed below the last.
  - bRigth
```
protected boolean bRigth
```
    True if the next element should be placed below the last.
  - userMainKeyAction
```
protected GralUserAction userMainKeyAction
```
  - replacerAlias
```
InspcReplAlias replacerAlias
```
  - sCurrPanel
```
protected java.lang.String sCurrPanel
```
    Any kind of TabPanel for this PanelManager TODO make protected
  - lastClickedWidget
```
private GralWidget_ifc lastClickedWidget
```
    Last focused widget or last selected line in a table. This info can be used to get the last widget on a context menu etc. on another widget. See getLastClickedWidget()
  - userActions
```
protected final java.util.Map<java.lang.String,GralUserAction> userActions
```
    Index of all user actions, which are able to use in Button etc. The user action "showWidgetInfos" defined here is added initially. Some more user-actions can be add calling registerUserAction(String, GralUserAction).
  - dataReplace
```
private final java.util.Map<java.lang.String,java.lang.String> dataReplace
```
    Map of replacements of paths to data. Filled from ZBNF: DataReplace::= <$?key> = <$-/\.?string>
  - graphicThreadId
```
protected long graphicThreadId
```
    The thread id of the managing thread for graphic actions.
  - debugPrint
```
boolean debugPrint
```
  - isWakedUpOnly
```
protected boolean isWakedUpOnly
```
  - bStarted
```
protected boolean bStarted
```
    True if the startup of the main window is done and the main window is visible.
  - bShouldExitImplGraphic
```
protected boolean bShouldExitImplGraphic
```
    set to true to exit the graphic thread and dispose the implementation graphic
  - bIsExitImplGraphic
```
protected boolean bIsExitImplGraphic
```
  - bExitMain
```
protected boolean bExitMain
```
    Set to true to finish the main. Set from the graphic thread.
  - bShouldExitMain
```
protected boolean bShouldExitMain
```
    Set to true to finish the main. Maybe on dispose the implementation graphic.
  - checkTimes
```
protected MinMaxTime checkTimes
```
    Instance to measure execution times.
  - queueOrdersToExecute
```
private final java.util.concurrent.ConcurrentLinkedQueue<GralGraphicOrder> queueOrdersToExecute
```
    Queue of orders to execute in the graphic thread before dispatching system events. Any instance will be invoked in the dispatch-loop. See #addTimeEntry(Runnable). An order can be stayed in this queue for ever. It is invoked any time after the graphic thread is woken up and before the dispatching of graphic-system-event will be started. An order may be run only one time, than it should delete itself from this queue in its run-method.
  - awakeThread
```
private final java.lang.Thread awakeThread
```
  - bDispatcherSleeps
```
private boolean bDispatcherSleeps
```
    True then the dispatcher sleeps, does not work. Only then the awakeThread should awake the dispatcher.
  - evSrc
```
public EventSource evSrc
```
  - _mngImpl
```
public GralMng.ImplAccess _mngImpl
```
    The graphic specific implementation part of the GralMng This implementation should care about the correct implementation widgets.
  - XXXsingleton
```
private static GralMng XXXsingleton
```
  - actionPanelActivate
```
public GralPanelActivated_ifc actionPanelActivate
```
  - actionShowWidgetInfos
```
GralUserAction actionShowWidgetInfos
```
  - actionFileSelect
```
public GralUserAction actionFileSelect
```
  - actionDesignEditField
```
public GralUserAction actionDesignEditField
```
    Action to edit the properties of one widget in the graphic.
  - actionReadPanelCfg
```
public GralUserAction actionReadPanelCfg
```
    Action to edit the properties of one widget in the graphic.
  - runGraphicThread
```
private java.lang.Runnable runGraphicThread
```
  - runAwakeThread
```
private java.lang.Runnable runAwakeThread
```
  - actionHelp
```
public final GralUserAction actionHelp
```
  - actionClose
```
public final GralUserAction actionClose
```
    This is one action to close the whole application. Especially close via menu, not closing with mouse via the [X] right on title bar. Note that a window may be created using GralWindow_ifc.windMinimizeOnClose. Then close is possible only and especially here.
  - gralFocusListener
```
public GralMng.GralMngFocusListener gralFocusListener
```
    This instance can be used if any other focus listener is necessary for any implementation widget. The standard behavior for GralWidget is supported using this aggregate. In Opposite a full ready to use focus listener based on this class in the implementation layer, see SwtMng.SwtMngFocusListener.
  - _implListener
```
public final GralMng.InternalPublic _implListener
```
    Implementation specific fields.
- Constructor Detail
  - GralMng
```
public GralMng(LogMessage log)
```
    Creates the GralMng with a given logging output,
    
    Parameters:
    
    log - maybe null firstly, then use setLog(LogMessage)
  - GralMng
```
public GralMng()
```
- Method Detail
  - initScript
```
public void initScript(java.lang.CharSequence script)
                throws java.text.ParseException
```
    Initialize the graphic with a script. See GralCfgZbnf.configureWithZbnf(CharSequence, GralCfgData). This operation is only wrapped.
    
    Parameters:
    
    script - String given, also possible in a StringBuilder prepared.
    
    Throws:
    
    java.text.ParseException
  - initScript
```
public void initScript(java.io.File script)
                throws java.lang.Exception
```
    Initialize the graphic with a script. See GralCfgZbnf.configureWithZbnf(File, GralCfgData). This operation is only wrapped.
    
    Parameters:
    
    script - given in file
    
    Throws:
    
    java.lang.Exception
  - createGraphic
```
public void createGraphic(java.lang.String implementor,
                          char sizeShow,
                          LogMessage log)
```
    Creates the whole graphically representation with all given widgets on Gral level. This operation creates the proper Factory with GralFactory.getFactory(java.lang.String), then calls GralFactory.createGraphic(GralMng, char). The graphic thread will be started, see runGraphicThread(), and the implementation graphic is instantiated in this graphic thread. This starts with GralWindow.createImplWidget_Gthread() for each given window.
    
    Only the GralFactory needs dependencies to the implementation graphic, there only to the specific Factory. Whereby the specific factory can be called also via String: Class.forName(String). This class remains independent of any implementation.
    
    Parameters:
    
    implementor - "SWT" or "AWT" or (TODO) the class path of the implementor's factory class.
    
    sizeShow - 'A' .. 'G' for the size
    
    log - null if a log is already given for the GralMng, else the log from yet. A given log will be removed.
  - XXXcreate
```
public static boolean XXXcreate(LogMessage log)
```
    Creates the singleton instance of the GralMng. If this routine is invoked more as one time, the first invocation is the correct one. The more-time-invocation is supported because an application may not invoke this routine. Therefore it is invoked later additional.
    See also #get().
    
    Parameters:
    
    log - The first invocation determines the log output.
    
    Returns:
    
    true if created, false if exists already.
  - setLog
```
public void setLog(LogMessage log)
```
    Changes or sets the log output. See log().
    
    Parameters:
    
    log -
  - createWindow
```
public static GralMng createWindow(java.lang.String graphicBaseSystem)
```
    Creates an nee Panel Manager in a new Window.
    
    Parameters:
    
    graphicBaseSystem -
    
    Returns:
  - pos
```
GralMng.PosThreadSafe pos()
```
  - setPos
```
public void setPos(GralPos pos)
```
    Sets the position in a Thread safe kind.
    
    Parameters:
    
    pos - maybe gotten from getPositionInPanel() any slightly varied
  - refPos
```
public GralPos refPos()
```
    Returns the current position of this thread to work with it.
    
    Returns:
    
    Will be changed on ctors of GralWidget. The GralWidget does not store a reference to this, it stores a clone.
  - setPos
```
public GralPos setPos(java.lang.String sPosition)
               throws java.text.ParseException
```
    Sets the position with a given String, see GralPos.setPosition(CharSequence, GralPos) whereby the parent is the current position value.
    
    Parameters:
    
    sPosition -
    
    Throws:
    
    java.text.ParseException
  - setPositionSize
```
public void setPositionSize(int line,
                            int column,
                            int height,
                            int width,
                            char direction)
```
    Description copied from interface: GralMngBuild_ifc
    
    Sets the position and size for the next widget to add in the container.
    
    Specified by:
    
    setPositionSize in interface GralMngBuild_ifc
    
    Parameters:
    
    line - y-Position in y-Units, count from top of the box. It is either the top or bottom line of the widget, depending on height. If < 0, then the previous position is valid furthermore.
    
    column - x-Position in x-Units, count from left of the box. If < 0, then the previous position is valid furthermore.
    
    width - The number of columns. If <0, then the param column is the right column, and column-length is the left column. If 0 then the last value of length is not changed.
    
    direction - direction for a next widget, use 'r', 'l', 'u', 'd' for right, left, up, down
  - setPosition
```
public void setPosition(float line,
                        float lineEndOrSize,
                        float column,
                        float columnEndOrSize,
                        char direction)
```
    Description copied from interface: GralMngBuild_ifc
    
    Sets the position.
    
    Specified by:
    
    setPosition in interface GralMngBuild_ifc
    
    Parameters:
    
    line - The line. Positive: from top, negative: from end.
    
    lineEndOrSize - The position of end of widget. negative or 0: from end. 0: the end position of Panel. see GralPos.same etc.
  - setPosition
```
public void setPosition(float line,
                        float lineEndOrSize,
                        float column,
                        float columnEndOrSize,
                        char direction,
                        float border)
```
    Description copied from interface: GralMngBuild_ifc
    
    Sets the position with fine position given as float value. Only one digit after the float point is regarded, see definition for the fine position as description of GralPos.
    
    Specified by:
    
    setPosition in interface GralMngBuild_ifc
    
    Parameters:
    
    line - either position or combinded with GralPos.refer etc.
  - setPosition
```
public void setPosition(GralPos framePos,
                        float line,
                        float lineEndOrSize,
                        float column,
                        float columnEndOrSize,
                        char direction)
```
    Description copied from interface: GralMngBuild_ifc
    
    Sets the position in relation to a given position.
    
    Specified by:
    
    setPosition in interface GralMngBuild_ifc
    
    Parameters:
    
    framePos - The given frame.
    
    line - The line
  - setPosition
```
public void setPosition(GralPos framePos,
                        float line,
                        float lineEndOrSize,
                        float column,
                        float columnEndOrSize,
                        char direction,
                        float border)
```
    Specified by:
    
    setPosition in interface GralMngBuild_ifc
  - setFinePosition
```
public void setFinePosition(int line,
                            int yPosFrac,
                            int ye,
                            int yef,
                            int column,
                            int xPosFrac,
                            int xe,
                            int xef,
                            char direction,
                            int border,
                            int borderFrac,
                            GralPos frame)
```
    Description copied from interface: GralMngBuild_ifc
    
    Same as GralMngBuild_ifc.setPositionSize(int, int, int, int, char), but the positions can be in a fine division.
    
    Specified by:
    
    setFinePosition in interface GralMngBuild_ifc
    
    Parameters:
    
    line - The line.
    
    yPosFrac - Number between 0..9 for fine positioning in the grid step.
    
    yef - Number between 0..9 for fine positioning in the grid step.
    
    xPosFrac - Number between 0..9 for fine positioning in the grid step.
    
    xef - Number between 0..9 for fine positioning in the grid step.
    
    direction - Direction of the next position if that is not given than or GralPos.next is given than. A value other then r, l, u, d let the direction unchanged from previous call.
  - setSize
```
public void setSize(float height,
                    float width)
```
    Sets the size of the position and remark it as unused.
    
    Parameters:
    
    height -
    
    width -
  - setNextPosition
```
@Deprecated
public void setNextPosition()
```
    Deprecated.
    
    Not for user: Checks whether the position is used, sets the next position then, markes the position as used. See @link GralPos#setNextPosition(), #posUsed. TODO remove in AwtMng
  - setNextPositionUnused
```
public void setNextPositionUnused()
```
    Not for user: Checks whether the position is used, sets the next position then, markes the position as used. See @link GralPos#setNextPosition(), #posUsed.
  - registerShowField
```
public void registerShowField(GralWidget widg)
```
  - getPositionInPanel
```
public GralPos getPositionInPanel()
```
    Description copied from interface: GralMngBuild_ifc
    
    Gets the current position in the panel to store anywhere other. Usual the position is stored in the widget itself. This operation returns an independent instance of GralGridPos. Note that the pos() is reused there. Therefore the implementation of the method returns a cloned instance.
    
    Specified by:
    
    getPositionInPanel in interface GralMngBuild_ifc
    
    Returns:
    
    An independent instance with current data of pos().
  - getPosCheckNext
```
public GralPos getPosCheckNext()
```
  - getPosOldPositioning
```
public GralPos getPosOldPositioning()
```
    Used for deprecated style, without independent GralWidget. TODO remove.
    
    Returns:
    
    Independent GralPos from the GralMng
  - getListCurrWidgets
```
@Deprecated
public java.util.List<GralWidgetBase> getListCurrWidgets()
```
    Deprecated.
    
    Description copied from interface: GralMng_ifc
    
    Returns the list of all widgets with its informations. The graphical representation of the widgets is unknown here. If it should be used, the graphic implementation should be known and a adequate instanceof-test and cast is necessary.
    
    Specified by:
    
    getListCurrWidgets in interface GralMng_ifc
  - setProperties
```
public void setProperties(GralGridProperties.ImplAccess props)
```
  - registerWindow
```
public void registerWindow(GralWindow window)
```
    register a window only called in the GralWindow.GralWindow(GralPos, String, String, int, GralMng).
    
    Parameters:
    
    window - TODO should be package private
    
    Since:
    
    2022-09 renamed from setFirstlyThePrimaryWindow(), and also register all windows.
  - createHtmlInfoBoxes
```
public void createHtmlInfoBoxes(MainCmd mainCmd)
```
    This routine should be called in the initializing routine in the graphic thread one time.
    
    Parameters:
    
    mainCmd - If given the help from mainCmd will be written into the Help box.
  - createImplWidget_Gthread
```
public void createImplWidget_Gthread(GralWidget widgg)
```
    Not that this routine must not invoked before the GralFactory#createWindow(GralWindow, char, int, int, int, int) was not called.
    
    Specified by:
    
    createImplWidget_Gthread in interface GralMngBuild_ifc
    
    Parameters:
    
    widgg - The widget should be initialized already.
    
    See Also:
    
    GralMngBuild_ifc.createImplWidget_Gthread(org.vishia.gral.base.GralWidget)
  - setMainKeyAction
```
public GralUserAction setMainKeyAction(GralUserAction userMainKeyAction)
```
    Description copied from interface: GralMngBuild_ifc
    
    Sets the action for main keys. Main keys are used in an application independent of the focused widget. The GralUserAction.userActionGui(int, GralWidget, Object...) is invoked on any key down event, exclusive some graphic implementation specific keys. The user should return false in this method if the key is not used and should not be blocked for widget specific key listeners.
    
    Specified by:
    
    setMainKeyAction in interface GralMngBuild_ifc
    
    Parameters:
    
    userMainKeyAction - The user action to process main keys.
    
    Returns:
    
    the last set user action.
  - userMainKeyAction
```
GralUserAction userMainKeyAction()
```
    package private
  - propertiesGui
```
public GralGridProperties propertiesGui()
```
    Specified by:
    
    propertiesGui in interface GralMng_ifc
  - log
```
public LogMessage log()
```
    Specified by:
    
    log in interface GralMng_ifc
  - getValueFromWidget
```
public java.lang.String getValueFromWidget(GralWidget widgd)
```
    Returns null if the widget value can only be gotten platform-depending. The platform widget manager should override this method too and invoke super.getValueFromWidget() to call this method. If it returns a value, then it is ok. A user invocation calls the overridden platform depending method automatically.
    See SwtMng.
    
    Specified by:
    
    getValueFromWidget in interface GralMng_ifc
    
    Parameters:
    
    widgd - The widget.
    
    Returns:
    
    The content.
  - setApplicationAdapter
```
public void setApplicationAdapter(GralMngApplAdapter_ifc adapter)
```
  - getApplicationAdapter
```
public GralMngApplAdapter_ifc getApplicationAdapter()
```
  - getReplacerAlias
```
public ReplaceAlias_ifc getReplacerAlias()
```
    Specified by:
    
    getReplacerAlias in interface GralMngBuild_ifc
  - setHelpBase
```
public void setHelpBase(java.lang.String path)
```
  - setHelpUrl
```
public void setHelpUrl(java.lang.String urlSuffix)
```
    Sets the URL for the current help situation. Note: before calling the following may/should be set:
```
 this.gralMng.createHtmlInfoBoxes(null);
  this.gralMng.setHelpBase(this.sHelpDir);
 
```
    Only then the url is effective.
    Parameters:
    
    urlSuffix - it is usual a suffix to given helpBase. Only if it is absolute than take it without helpbase.
  - setHtmlHelp
```
public void setHtmlHelp(java.lang.String url)
```
  - showInfo
```
public void showInfo(java.lang.CharSequence text)
```
  - setInfo
```
public void setInfo(java.lang.CharSequence text)
```
  - addInfo
```
public void addInfo(java.lang.CharSequence info,
                    boolean show)
```
  - selectPanel
```
public GralPanel_ifc selectPanel(java.lang.String sName)
```
    selects a registered panel for the next add-operations.
    
    Specified by:
    
    selectPanel in interface GralMngBuild_ifc
  - selectPanel
```
public void selectPanel(GralPanel_ifc panel)
```
    Selects the given panel as current panel to build some content.
    
    Specified by:
    
    selectPanel in interface GralMngBuild_ifc
  - selectPrimaryWindow
```
public void selectPrimaryWindow()
```
    Selects the primary window as current panel to build some content.
    
    Specified by:
    
    selectPrimaryWindow in interface GralMngBuild_ifc
  - currThreadIsGraphic
```
public boolean currThreadIsGraphic()
```
    Description copied from interface: GralMng_ifc
    
    Returns true if the current thread is the graphical thread. This routine is used internally firstly. The graphical thread is that thread, which dispatches all orders for the graphic, see org.vishia.gral.base.GralGraphicThread#runGraphicThread().
    
    Specified by:
    
    currThreadIsGraphic in interface GralMng_ifc
    
    Returns:
    
    true if this routine is called from the same thread as the graphical thread.
  - getWidget
```
public GralWidgetBase getWidget(java.lang.String name)
```
    Description copied from interface: GralMng_ifc
    
    Searches a widget by name.
    
    Specified by:
    
    getWidget in interface GralMng_ifc
    
    Parameters:
    
    name - The name which is assigned on build.
    
    Returns:
    
    null if the widget is not found.
  - getWidgetIter
```
public java.lang.Iterable<GralWidgetBase> getWidgetIter()
```
  - buildCfg
```
public void buildCfg(GralCfgData data,
                     java.io.File fileCfg)
```
    Description copied from interface: GralMngBuild_ifc
    
    Sets the builder for content configuration.
    
    Specified by:
    
    buildCfg in interface GralMngBuild_ifc
  - setDesignMode
```
public void setDesignMode(boolean mode)
```
    Sets or resets the design mode. The design mode allows to change the content.
    
    Specified by:
    
    setDesignMode in interface GralMngBuild_ifc
    
    Parameters:
    
    mode -
  - saveCfg
```
public java.lang.String saveCfg(java.io.Writer dest)
```
    Deprecated. should be a property only of GuiCfg
    
    Saves the given configuration.
    
    Specified by:
    
    saveCfg in interface GralMngBuild_ifc
    
    Parameters:
    
    dest -
    
    Returns:
  - setLastClickedWidget
```
public void setLastClickedWidget(GralWidget_ifc lastClickedWidgetInfo)
```
    This method is called whenever the left mouse is pressed on a widget, whiches
    
    Parameters:
    
    lastClickedWidgetInfo -
  - getLastClickedWidget
```
public GralWidget_ifc getLastClickedWidget()
```
    Returns that widget which was clicked by mouse at last. This method is usefully for debugging and for special functionality. A widget which GralWidget.setDataPath(String) is initialized with "widgetInfo" is not captured for this operation. It means, if any user action method uses this method to get the last clicked widget, that widget itself have to be marked with setDataPath("widgetInfo"); to prevent getting its own widget info.
    
    Returns:
    
    The last clicked widget
  - registerUserAction
```
public void registerUserAction(java.lang.String name,
                               GralUserAction action)
```
    Registers all user actions, which are able to use in Button etc. The name is related with the userAction= designation in the configuration String.
    
    Specified by:
    
    registerUserAction in interface GralMngBuild_ifc
    
    Parameters:
    
    name - if it contains "" then that is replace by the GralUserAction.name. You can give "" only to set the action's name.
    
    action -
  - getRegisteredUserAction
```
public GralUserAction getRegisteredUserAction(java.lang.String name)
```
    Specified by:
    
    getRegisteredUserAction in interface GralMngBuild_ifc
  - registerWidget
```
void registerWidget(java.lang.String name,
                    GralWidgetBase widgd)
```
  - removeWidget
```
void removeWidget(java.lang.String name)
```
  - registerWidget
```
public void registerWidget(GralWidgetBase widgd)
```
    Description copied from interface: GralMngBuild_ifc
    
    Register all widgets, which are created in its own classes, not add here. The widgets are stored in the index of names.
    
    Specified by:
    
    registerWidget in interface GralMngBuild_ifc
  - deregisterWidgetName
```
public void deregisterWidgetName(GralWidgetBase widg)
```
  - registerPanel
```
public void registerPanel(GralPanel_ifc panel)
```
    Registers a panel to place the widgets.
    For positioning of Widgets in the panel: The panel should be associated with a current position which is used to hold the current value for increment. For that GralPos.setPosition(CharSequence, GralPos) should be used.
    Old positioning, deprecated: After registration, this panel is the current one, stored in pos() for this thread. The panel can be selected with its name calling the selectPanel(String) -routine
    
    Specified by:
    
    registerPanel in interface GralMngBuild_ifc
    
    Parameters:
    
    key - Name of the panel.
    
    panel - The panel.
  - setPosPanel
```
@Deprecated
public void setPosPanel(GralPanel_ifc panel)
```
    Deprecated.
  - deregisterPanel
```
void deregisterPanel(GralPanel_ifc panel)
```
  - deregisterWindow
```
void deregisterWindow(GralWindow wind)
```
  - getShowFields
```
public java.util.Set<java.util.Map.Entry<java.lang.String,GralWidget>> getShowFields()
```
    Returns a Set of all fields, which are created to show.
    
    Specified by:
    
    getShowFields in interface GralMngBuild_ifc
    
    Returns:
    
    the set, never null, possible an empty set.
  - getAllValues
```
public java.util.Map<java.lang.String,java.lang.String> getAllValues()
```
  - getValue
```
public java.lang.String getValue(java.lang.String sName)
```
    Description copied from interface: GralMng_ifc
    
    Gets the value from a widget.
    
    Specified by:
    
    getValue in interface GralMng_ifc
    
    Parameters:
    
    sName - The name of the widget. The widget will be searched per name.
    
    Returns:
    
    null if the named widget isn't found or the widget is not able to input.
  - setTabbedPanel
```
public void setTabbedPanel(GralPanel_ifc tabbedPanel)
```
    It is a special routine for tabbedPanel. The reason: If a new tab should add in GralTabbedPanel#addGridPanel(String, String, int, int, int, int) then the mng is set to the tabbed panel.
    
    Parameters:
    
    tabbedPanel -
  - getWindow
```
public GralWidget_ifc getWindow(java.lang.String name)
```
  - getPanel
```
public GralPanel_ifc getPanel(java.lang.String name)
```
  - getPrimaryWindow
```
public GralWindow getPrimaryWindow()
```
  - getCurrentPanel
```
public GralPanelContent getCurrentPanel()
```
  - wakeup_
```
protected void wakeup_()
```
    Necessary operation to wakeup the graphic thread. It sleeps in OS-management. This operation is called just if a new event is enqueued, on EventTimerThread#storeEvent(EventObject). See EventTimerThread#wakeup_()
  - orderList
```
public EventTimerThread orderList()
```
  - addDispatchOrder
```
public void addDispatchOrder(GralGraphicOrder order)
```
    Adds the order to execute in the graphic dispatching thread. It is the same like order.GralGraphicOrder#activate().
    
    Parameters:
    
    order -
  - getThreadIdGui
```
public long getThreadIdGui()
```
  - wakeup
```
public void wakeup()
```
    This method should wake up the execution of the graphic thread because some actions are registered..
  - waitForStart
```
public void waitForStart()
```
  - isStarted
```
public boolean isStarted()
```
  - isRunning
```
public boolean isRunning()
```
    Returns true so long the application should run (indpendent of implementation graphic)
    
    Returns:
    
    false then exit the implementation
  - isImplementationGraphicTerminated
```
public boolean isImplementationGraphicTerminated()
```
  - closeImplGraphic
```
public void closeImplGraphic()
```
    Terminates the run loop of the graphic thread
  - closeApplication
```
public void closeApplication()
```
  - createThread_
```
protected void createThread_()
```
    Creates and starts the thread. If this routine is called from the user, the thread runs till the close() method was called. If this method is not invoked from the user, the thread is created and started automatically if #storeEvent(EventCmdtype) was called. In that case the thread stops its execution if the event queue is empty and about 5 seconds are gone.
  - runGraphicThread
```
protected void runGraphicThread()
```
    The run method of the graphic thread. The Thread and hence this method is started in the constructor of the derived class of this, which implements the graphic system adapter. It initializes the graphic appearances and then handles all events.
    - #initGraphic() will be called firstly. It is overridden by the graphic system implementing class and does some things necessary for the graphic system implementing level.
    - The routine runs so long as bShouldExitImplGraphic is not set to false. bExit may be set to false in a window close listener of the graphic system level. It means, it is set to false especially if the windows will be closed from the operation system. If the window is closed because the application is terminated by any application command the window will be closed, and the close listerer sets bReady to false then.
    - In the loop the #queueGraphicOrders will be executed.
    - For SWT graphic this is the dispatch loop of graphic events. They are executed in the abstract defined here #dispatchOsEvents() method.
    - This thread should be wait if not things are to do. The wait will be executed in the here abstract defined method #graphicThreadSleep().
    See Also:
    
    Runnable.run()
  - stepGraphicThread
```
private int stepGraphicThread()
```
    The step routine of the graphic thread
  - stepAwakeThread
```
protected void stepAwakeThread()
```
    This thread has only the task to wake up the graphic thread.
    It uses the super#timeCheckNew to determine how many ms to wakeup.
    If the graphic thread is active in the moment, it waits 10 ms, then check again.
    If any time order has elapsed or will be elapsed in the next 2 ms, then wake up the graphic thread calling GralMng.ImplAccess.wakeup()
  - closeMainWindow
```
public void closeMainWindow()
```
  - checkAdmissibility
```
protected void checkAdmissibility(boolean value)
```
  - findWidget
```
private GralWidgetBase findWidget(java.lang.String name)
```
  - setBackColor
```
public void setBackColor(java.lang.String name,
                         int ix,
                         int color)
```
    Sets the background color of any widget. The widget may be for example:
    - a Table: Then a new line will be colored.
    - a Tree: Then a new leaf is colored.
    - a Text-edit-widget: Then the field background color is set.
    The color is written into a queue, which is red in another thread. It may be possible too, that the GUI is realized in another module, maybe remote. It means, that a few milliseconds should be planned before the change appears. If the thread doesn't run or the remote receiver isn't present, than the queue may be overflowed or the request may be lost.
    Specified by:
    
    setBackColor in interface GralMng_ifc
    
    Parameters:
    
    name - The name of the widget, which was given by the add...()-Operation
    
    ident - A identifying number. It meaning depends on the kind of widget. 0 means, insert on top. Integer.MAXVALUE means, insert after the last element (append).
    
    content - The content to insert.
  - setText
```
public void setText(java.lang.String name,
                    java.lang.CharSequence text)
```
    Description copied from interface: GralMng_ifc
    
    Sets the text into a named widget.
    
    Specified by:
    
    setText in interface GralMng_ifc
    
    text - The text is not stored by reference, it can be changed after them.
  - setValue
```
public void setValue(java.lang.String widget,
                     java.lang.Object visibleInfo,
                     java.lang.Object userData)
```
    Description copied from interface: GralMng_ifc
    
    Sets the text into a named widget.
    
    Specified by:
    
    setValue in interface GralMng_ifc
  - addWindow
```
public GralWindow addWindow(java.lang.String posName,
                            java.lang.String sTitle)
```
    Add a standard window remove on close, resizeable. If it is the first call, this is the main window.
    
    Parameters:
    
    posName - Position at the screen or related to another window
    
    sTitle - Title bar
    
    Returns:
    
    The GralWindow to add some more via concatenation.
  - addWindow
```
public GralWindow addWindow(java.lang.String posName,
                            java.lang.String sTitle,
                            int props)
```
  - addPanel
```
public GralPanelContent addPanel(java.lang.String posName)
```
    Add a panel to any other panel or window.
    
    Parameters:
    
    posName - "@panel,... = name" determines to which panel, elsewhere to the last added panel.
    
    Returns:
    
    GralPanelContent to set some more.
  - addTabbedPanel
```
public GralPanelContent addTabbedPanel(java.lang.String posName)
```
    Add a panel to any other panel or window which contains only other panels as tab
    
    Parameters:
    
    posName - "@panel,... = name" determines to which panel, elsewhere to the last added panel.
    
    Returns:
    
    GralPanelContent to set some more.
  - addTabPanel
```
public GralPanelContent addTabPanel(java.lang.String posName,
                                    java.lang.String nameTab)
```
    Add a panel as tab pabel. The parent should be a tabbed panel.
    
    Parameters:
    
    posName - "@panel,... = name" determines to which panel, elsewhere to the last added panel.
    
    tabName - The string shown on the tab.
    
    Returns:
    
    GralPanelContent to set some more.
  - addArea9Panel
```
public GralArea9Panel addArea9Panel(java.lang.String posName)
```
    Add a panel with 9 areas to any other panel or window.
    
    Parameters:
    
    posName - "@panel,... = name" determines to which panel, elsewhere to the last added panel.
    
    Returns:
    
    GralArea9Panel to set some more.
  - addText
```
@Deprecated
public void addText(java.lang.String name,
                                 java.lang.CharSequence text)
```
    Deprecated.
    
    Adds a text to a named widget.
    
    Specified by:
    
    addText in interface GralMng_ifc
    
    text - The text is not stored by reference, it can be changed after them.
  - addText
```
public GralWidget addText(java.lang.String sText,
                          int origin,
                          GralColor textColor,
                          GralColor backColor)
```
    Adds a text to a named widget.
    
    Specified by:
    
    addText in interface GralMngBuild_ifc
    
    origin - Origin, use char 1..9 for 1 top-left, 2 top-middle, ... 5 middle, 9 bottom-right.
    
    Returns:
  - addTextField
```
public GralTextField addTextField(java.lang.String name,
                                  java.lang.String prompt,
                                  java.lang.String promptStylePosition,
                                  GralTextField.Type... property)
```
    Adds a text field for showing or editing a text value.
    
    Parameters:
    
    sName - The registering name
    
    width - Number of grid units for length
    
    editable - true than edit-able, false to show content
    
    prompt - If not null, than a description label is shown
    
    promptStylePosition - Position and size of description label: upper case letter: normal font, lower case letter: small font 'l' left, 't' top (above field)
    
    Returns:
  - addTextField
```
public GralTextField addTextField(java.lang.String name,
                                  boolean editable,
                                  java.lang.String prompt,
                                  java.lang.String promptStylePosition)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds a text field at the current position.
    
    Specified by:
    
    addTextField in interface GralMngBuild_ifc
    
    Parameters:
    
    name - The registering name to get the value from outside or set the content.
    
    editable - true then an input field, false only for show
    
    prompt - If not null, then this prompt text is shown above, left, rigth
    
    promptStylePosition - Position and size of description label: upper case letter: normal font, lower case letter: small font 'l' left, 't' top (above field)
    
    Returns:
    
    The WidgetDescriptor. An action, tooltip, color etc. can be set there later.
  - addTextField
```
public GralTextField addTextField(java.lang.String name)
```
  - addTextField
```
public GralTextField addTextField(java.lang.String name,
                                  boolean editable)
```
  - addTextField
```
public GralTextField addTextField(java.lang.String name,
                                  GralTextField.Type property)
```
  - addTextBox
```
public GralTextBox addTextBox(java.lang.String name,
                              boolean editable,
                              java.lang.String prompt,
                              char promptStylePosition)
```
    Adds a text box for showing or editing a text in multi lines.
    
    Specified by:
    
    addTextBox in interface GralMngBuild_ifc
    
    Parameters:
    
    sName - The registering name
    
    width - Number of grid units for length
    
    editable - true than edit-able, false to show content
    
    prompt - If not null, than a description label is shown
    
    promptStylePosition - Position and size of description label: upper case letter: normal font, lower case letter: small font 'l' left, 't' top (above field)
    
    Returns:
  - addTextBox
```
public GralTextBox addTextBox(java.lang.String posName)
```
  - addValueBar
```
public GralValueBar addValueBar(java.lang.String sName,
                                java.lang.String sDataPath)
```
    Specified by:
    
    addValueBar in interface GralMngBuild_ifc
  - addButton
```
public GralButton addButton(java.lang.String sName,
                            GralUserAction action,
                            java.lang.String sButtonText)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds a button
    
    Specified by:
    
    addButton in interface GralMngBuild_ifc
    
    sButtonText - text in the button
    
    Returns:
  - addButton
```
public GralButton addButton(java.lang.String sName,
                            java.lang.String sButtonText,
                            GralUserAction action)
```
  - addButton
```
public GralButton addButton(java.lang.String sName,
                            GralUserAction action,
                            java.lang.String sCmd,
                            java.lang.String sDataPath,
                            java.lang.String sButtonText)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds a button
    
    Specified by:
    
    addButton in interface GralMngBuild_ifc
    
    sCmd - The command string will be transfered to the action-method
    
    sButtonText - text in the button
    
    Returns:
  - addSwitchButton
```
public GralButton addSwitchButton(java.lang.String sName,
                                  GralUserAction action,
                                  java.lang.String sCmd,
                                  java.lang.String sDataPath,
                                  java.lang.String sButtonText,
                                  GralColor colorOff,
                                  GralColor colorOn)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds a button which saves its state, pressed or non-pressed.
    
    Specified by:
    
    addSwitchButton in interface GralMngBuild_ifc
    
    Returns:
  - addSwitchButton
```
public GralButton addSwitchButton(java.lang.String sName,
                                  java.lang.String sButtonTextOff,
                                  java.lang.String sButtonTextOn,
                                  GralColor colorOff,
                                  GralColor colorOn)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds a button which is switching on or off. The state is shown with 2 colors and 2 different texts inside the button. The state is able to retrieve calling GralButton.isOn() or GralWidget.getValue().
    
    Specified by:
    
    addSwitchButton in interface GralMngBuild_ifc
    
    Returns:
  - addCheckButton
```
public GralButton addCheckButton(java.lang.String sPosName,
                                 java.lang.String sButtonTextOn,
                                 java.lang.String sButtonTextOff,
                                 java.lang.String sButtonTextDisabled,
                                 GralColor colorOn,
                                 GralColor colorOff,
                                 GralColor colorDisabled)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds a button which is switching on or off. The state is shown with 2 colors and 2 different texts inside the button. The state is able to retrieve calling GralButton.isOn() or GralWidget.getValue().
    
    Specified by:
    
    addCheckButton in interface GralMngBuild_ifc
    
    Returns:
  - addLed
```
public GralLed addLed(java.lang.String sName,
                      java.lang.String sDataPath)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds a Led (round)
    
    Specified by:
    
    addLed in interface GralMngBuild_ifc
    
    Returns:
  - setBackColor
```
@Deprecated
public void setBackColor(GralWidget widg,
                                      int ix,
                                      int color)
```
    Deprecated.
    
    Description copied from interface: GralMng_ifc
    
    Sets the color of background of the widget, if possible.
    
    Specified by:
    
    setBackColor in interface GralMng_ifc
    
    color - blue, green and red in the bits 23..16, 15..8 and 7..0. opaque in bits 31..24 if possible.
  - setLineColor
```
@Deprecated
public void setLineColor(GralWidget widg,
                                      int ix,
                                      int color)
```
    Deprecated.
    
    Description copied from interface: GralMng_ifc
    
    Sets the color of line of the widget, if possible.
    
    Specified by:
    
    setLineColor in interface GralMng_ifc
    
    color - blue, green and red in the bits 23..16, 15..8 and 7..0. opaque in bits 31..24 if possible.
  - setTextColor
```
@Deprecated
public void setTextColor(GralWidget widg,
                                      int ix,
                                      int color)
```
    Deprecated.
    
    Description copied from interface: GralMng_ifc
    
    Sets the color of text of the widget, if possible.
    
    Specified by:
    
    setTextColor in interface GralMng_ifc
    
    color - blue, green and red in the bits 23..16, 15..8 and 7..0. opaque in bits 31..24 if possible.
  - addLine
```
@Deprecated
public void addLine(int colorValue,
                                 float xa,
                                 float ya,
                                 float xe,
                                 float ye)
```
    Deprecated.
    
    Adds a line.
    
    To adding a line is only possible if the current panel is of type XXXSwtCanvasStorePanel. This class stores the line coordinates and conditions and draws it as background if drawing is invoked.
    
    Specified by:
    
    addLine in interface GralMngBuild_ifc
    
    Parameters:
    
    colorValue - The value for color, 0xffffff is white, 0xff0000 is red.
    
    xa - start of line relative to current position in grid units. The start is relative to the given position! Not absolute in window!
    
    ya - start of line relative to current position in grid units.
    
    xe - end of line relative to current position in grid units.
    
    ye - end of line relative to current position in grid units.
  - addLine
```
@Deprecated
public void addLine(GralColor color,
                                 java.util.List<GralPoint> points)
```
    Deprecated.
    
    Description copied from interface: GralMngBuild_ifc
    
    Adds a line.
    
    To adding a line is only possible if the current panel is of type XXXSwtCanvasStorePanel. This class stores the line coordinates and conditions and draws it as background if drawing is invoked.
    
    Specified by:
    
    addLine in interface GralMngBuild_ifc
  - setLed
```
@Deprecated
public void setLed(GralWidget widg,
                                int colorBorder,
                                int colorInner)
```
    Deprecated.
    
    Specified by:
    
    setLed in interface GralMng_ifc
  - reportGralContent
```
public void reportGralContent(java.lang.Appendable out)
```
    Reports all existing Widgets on Gral level, sorted to GralWindow. It calls internally GralWindow.reportAllContent(Appendable) for each window.
    See also GralMng.ImplAccess.reportContent(Appendable) for the implementation level.
    
    Parameters:
    
    out - any output, maybe especially System.out or LogMessage
  - getVisiblePanels
```
public java.util.concurrent.ConcurrentLinkedQueue<GralVisibleWidgets_ifc> getVisiblePanels()
```
    Description copied from interface: GralMng_ifc
    
    Gets the list of all panels which are visible yet and should be updated with values therefore.
    
    Specified by:
    
    getVisiblePanels in interface GralMng_ifc
    
    Returns:
    
    The list of widget list.
  - getWidgetsPermanentlyUpdating
```
public GralVisibleWidgets_ifc getWidgetsPermanentlyUpdating()
```
    Description copied from interface: GralMng_ifc
    
    Gets a list of widgets which should be updated permanently because they store data in any time.
    
    Specified by:
    
    getWidgetsPermanentlyUpdating in interface GralMng_ifc
    
    Returns:
    
    List of widgets which are permanently to update
  - setFocus
```
@Deprecated
public void setFocus(GralWidget widgd)
```
    Deprecated.
    
    Description copied from interface: GralMng_ifc
    
    Sets the focus to the designated widget.
    
    Specified by:
    
    setFocus in interface GralMng_ifc
  - notifyFocus
```
@Deprecated
public void notifyFocus(GralWidget widgd)
```
    Deprecated.
    
    Description copied from interface: GralMng_ifc
    
    Notifies that this widget has the focus gotten. Note: not all widgets notifies this. The focus can be used to detect which widget is active while a menu command or any button is pressed.
    
    Specified by:
    
    notifyFocus in interface GralMng_ifc
    
    Parameters:
    
    widgd - The widget descriptor
  - getWidgetInFocus
```
public GralWidget getWidgetInFocus()
```
    Specified by:
    
    getWidgetInFocus in interface GralMng_ifc
  - getWidgetsInFocus
```
public java.util.List<GralWidget> getWidgetsInFocus()
```
    Description copied from interface: GralMng_ifc
    
    Returns a list of the last widgets in focus in there focus order. On access to the list, usual with an iterator, the returned list should be used with mutex. Use 'synchronized(focusList){....}'. But don't block the access for a longer time! The graphical thread will be wait on mutex if any other widget will be focused.
    
    Specified by:
    
    getWidgetsInFocus in interface GralMng_ifc
    
    Returns:
    
    The list.
  - getColorValue
```
public int getColorValue(java.lang.String sColorName)
```
    Description copied from interface: GralMngBuild_ifc
    
    Gets the value to the named color. It is a method of the graphic.
    
    Specified by:
    
    getColorValue in interface GralMng_ifc
    
    Specified by:
    
    getColorValue in interface GralMngBuild_ifc
    
    Parameters:
    
    sColorName - supported: red, green, blue, yellow
    
    Returns:
    
    3 bytes intensity: bit23..16 blue, bit15..8: green, bit 7..0 red.
  - getColor
```
public GralColor getColor(java.lang.String sColorName)
```
    Description copied from interface: GralMngBuild_ifc
    
    Gets the named color.
    
    Specified by:
    
    getColor in interface GralMngBuild_ifc
    
    Parameters:
    
    sColorName - supported: red, green, blue, yellow
  - calcWidgetPosAndSize
```
public GralRectangle calcWidgetPosAndSize(GralPos pos,
                                          GralRectangle parentPix,
                                          int widthWidgetNat,
                                          int heightWidgetNat)
```
    Calculates the pixel position and size with a given GralPos for the given size of display appearance.
    
    Parameters:
    
    pos - Given position
    
    widthParentPixel - width of the container. This value will be used if the position is given from right with negative numbers.
    
    heightParentPixel - height of the container. This value will be used if the position is given from bottom with negative numbers.
    
    widthWidgetNat - natural width of the component which will be positioning. This value is used only if the pos parameter contains GralPos.useNatSize for the xe-value
    
    heightWidgetNat - natural height of the component which will be positioning. This value is used only if the pos parameter contains GralPos.useNatSize for the ye-value
    
    Returns:
    
    The position and size relative in the container.
  - addFileSelectField
```
public GralTextField addFileSelectField(java.lang.String name,
                                        java.util.List<java.lang.String> listRecentFiles,
                                        java.lang.String startDirMask,
                                        java.lang.String prompt,
                                        java.lang.String promptStylePosition)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds a special text field to select a file. On the right side a small button [<] is arranged to open the standard file select dialog. The text field is a receiver of file objects for drag % drop or paste the clipboard.
    
    Specified by:
    
    addFileSelectField in interface GralMngBuild_ifc
    
    Parameters:
    
    name - Name of the widget
    
    listRecentFiles - maybe null, a list which stores and offers selected files.
    
    startDirMask - The start dir and selection mask. Both are separated with a ':' character in this string. See GralFileDialog_ifc. If the last or only one char is '/' then a directory should be selected. For example "D:/MyDir:*.txt" shows only .txt-files to select in the dialog starting from d:/MyDir.
    
    prompt - Prompt for the text field.
    
    Returns:
  - pressedLeftMouseDownForDesign
```
public void pressedLeftMouseDownForDesign(GralWidget widgd,
                                          GralRectangle xy)
```
    It will be called only at the GUI-implementation level. TODO protected and delegation.
    
    Parameters:
    
    widgd -
    
    xy -
  - releaseLeftMouseForDesign
```
public void releaseLeftMouseForDesign(GralWidget widgd,
                                      GralRectangle xy,
                                      boolean bCopy)
```
    It will be called only at the GUI-implementation level. TODO protected and delegation.
    
    Parameters:
    
    widgd -
    
    xy -
  - markWidgetForDesign
```
public void markWidgetForDesign(GralWidget widgg)
```
  - XXXpressedRightMouseDownForDesign
```
public void XXXpressedRightMouseDownForDesign(GralWidget widgd,
                                              GralRectangle xy)
```
    It will be called only at the GUI-implementation level. TODO protected and delegation.
    
    Parameters:
    
    widgd -
    
    xy -
  - initCfgDesigner
```
public void initCfgDesigner()
```
  - createTextInfoBox
```
public GralInfoBox createTextInfoBox(java.lang.String name,
                                     java.lang.String title)
```
    Specified by:
    
    createTextInfoBox in interface GralMngBuild_ifc
  - createHtmlInfoBox
```
public GralInfoBox createHtmlInfoBox(java.lang.String posName,
                                     java.lang.String title,
                                     boolean onTop)
```
    Specified by:
    
    createHtmlInfoBox in interface GralMngBuild_ifc
  - addText
```
public GralWidget addText(java.lang.String text)
```
    Adds a text to the current panel at given position with standard colors, left origin. The size of text is calculated using the height of positioning values. see also addText(String, int, GralColor, GralColor), addTextField(String, boolean, String, String)
    
    Specified by:
    
    addText in interface GralMngBuild_ifc
    
    Parameters:
    
    text -
  - repaint
```
public void repaint()
```
    Description copied from interface: GralMngBuild_ifc
    
    Forces a newly paint of the GUI-container. This method should only be called in the graphic thread (SWT).
    
    Specified by:
    
    repaint in interface GralMngBuild_ifc
  - repaintCurrentPanel
```
public void repaintCurrentPanel()
```
    Description copied from interface: GralMngBuild_ifc
    
    Forces a newly paint of the current panel. This method should only be called in the graphic thread. It should be used after changing content.
    
    Specified by:
    
    repaintCurrentPanel in interface GralMngBuild_ifc
  - refreshCurvesFromVariable
```
public void refreshCurvesFromVariable(VariableContainer_ifc container)
```
    Description copied from interface: GralMng_ifc
    
    refresh all curve views.
    
    Specified by:
    
    refreshCurvesFromVariable in interface GralMng_ifc
  - remove
```
public boolean remove(GralWidget widget)
```
    Specified by:
    
    remove in interface GralMngBuild_ifc
  - writeLog
```
public void writeLog(int msgId,
                     java.lang.Exception exc)
```
    Description copied from interface: GralMng_ifc
    
    Writes a log message instead throwing an exception or writing on standard output. The log message contains a timestamp and can be dispatched to any destination. All internal methods of gral writes exceptions to that logging system instead abort the execution of the application.
    
    Specified by:
    
    writeLog in interface GralMng_ifc
    
    Parameters:
    
    msgId - The ident number for dispatching and evaluation.
    
    exc - The catched exception.
  - stop
```
void stop()
```
  - createContextMenu
```
protected GralMenu createContextMenu(GralWidget widg)
```
  - createMenuBar
```
protected GralMenu createMenuBar(GralWindow windg)
```
  - addSlider
```
public GralWidget addSlider(java.lang.String sName,
                            GralUserAction action,
                            java.lang.String sShowMethod,
                            java.lang.String sDataPath)
```
    Specified by:
    
    addSlider in interface GralMngBuild_ifc
  - addTable
```
public GralTable addTable(java.lang.String sPosName,
                          int height,
                          int[] columnWidths)
```
    Description copied from interface: GralMngBuild_ifc
    Adds a table, which is able to scroll. A user action on the GUI with the table invokes the GralWidget.setActionChange(GralUserAction) with
    - with given command "table-key".
    - values[0] is the selected line referenced with GralTableLine_ifc
    - values[1] is the key code described in KeyCode
    If the method isn't given or returns false, the central key action given in getRegisteredUserAction(String) for "keyAction" is tried to get and then invoked with cmd = "key" and the key code in values[0]. This central keyAction may be used for application centralized keys without association to the table itself.
    Specified by:
    
    addTable in interface GralMngBuild_ifc
    
    Parameters:
    
    sPosName - register name, used for GuiPanelMngWorkingIfc#insertInfo(String, int, String).
    
    height - The height in grid units for the appearance
    
    columnWidths - Array with width of the columns. Each column has a fix default width per construction. It may or may not a fix widht, it may able to change by mouse actions, adequate to the possibilities of the used graphic base system.
    
    Returns:
  - addText
```
@Deprecated
public GralWidget addText(java.lang.String sText,
                                       char size,
                                       int color)
```
    Deprecated.
    
    Description copied from interface: GralMngBuild_ifc
    
    Adds a simple text at the current position.
    
    Specified by:
    
    addText in interface GralMngBuild_ifc
    
    Parameters:
    
    sText - The text
    
    size - size, 'A' is small ...'E' is large.
    
    color - The color as RGB-value in 3 Byte. 0xffffff is white, 0xff0000 is red.
    
    Returns:
  - addImage
```
public java.lang.Object addImage(java.lang.String sName,
                                 java.io.InputStream imageStream,
                                 int height,
                                 int width,
                                 java.lang.String sCmd)
```
    Specified by:
    
    addImage in interface GralMngBuild_ifc
  - addHtmlBox
```
public GralHtmlBox addHtmlBox(java.lang.String name)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds a box which presents html content.
    
    Specified by:
    
    addHtmlBox in interface GralMngBuild_ifc
    
    Returns:
    
    The instance arranged in the current panel at current position of the GralWidgetMng
  - addCurveViewY
```
public GralCurveView addCurveViewY(java.lang.String sPosName,
                                   int nrofXvalues,
                                   GralCurveView.CommonCurve common,
                                   TimedValues tracksValues)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds a curve view for displaying values with ordinary x-coordinate. The scaling of the curve view is set to -100..100 per default.
    
    Specified by:
    
    addCurveViewY in interface GralMngBuild_ifc
    
    nrofXvalues - depth of the buffer for x-values. It should be 6..20 times of dx.
    
    Returns:
    
    The Canvas Object.
  - addFocusAction
```
public GralWidget addFocusAction(java.lang.String sName,
                                 GralUserAction action,
                                 java.lang.String sCmdEnter,
                                 java.lang.String sCmdRelease)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds the given Focus action to the named widget.
    
    Specified by:
    
    addFocusAction in interface GralMngBuild_ifc
    
    Parameters:
    
    sName - The name of the widget. It should be registered calling any add... method.
    
    Returns:
  - addFocusAction
```
public void addFocusAction(GralWidget widgetInfo,
                           GralUserAction action,
                           java.lang.String sCmdEnter,
                           java.lang.String sCmdRelease)
```
    Description copied from interface: GralMngBuild_ifc
    
    Adds the given Focus action to the known widget.
    
    Specified by:
    
    addFocusAction in interface GralMngBuild_ifc
  - createCompositeBox
```
public GralPanelContent createCompositeBox(java.lang.String name)
```
    Description copied from interface: GralMngBuild_ifc
    
    Creates a box inside the current panel to hold some widgets.
    
    Specified by:
    
    createCompositeBox in interface GralMngBuild_ifc
    
    Returns:
  - createGridPanel
```
public GralPanelContent createGridPanel(java.lang.String namePanel,
                                        GralColor backGround,
                                        int xG,
                                        int yG,
                                        int xS,
                                        int yS)
```
    Description copied from interface: GralMngBuild_ifc
    
    Creates an independent grid panel which is managed by this. The panel can be associated to any graphic frame.
    
    Specified by:
    
    createGridPanel in interface GralMngBuild_ifc
    
    Returns:
  - remove
```
public boolean remove(GralPanel_ifc compositeBox)
```
    Description copied from interface: GralMngBuild_ifc
    
    Removes a composite box from the graphic representation.
    
    Specified by:
    
    remove in interface GralMngBuild_ifc
    
    Returns:
    
    true if removed.
  - createWindow
```
public GralWindow createWindow(java.lang.String posName,
                               java.lang.String title,
                               int windProps)
```
    Creates only the GralWindow with position in GralMng
    
    Specified by:
    
    createWindow in interface GralMngBuild_ifc
    
    title - Title of the window, may be null, then without title bar.
    
    windProps - Or of the static variables GralWindow_ifc.windExclusive etc.
    
    Returns:
    
    See Also:
    
    GralMngBuild_ifc.createWindow(java.lang.String, java.lang.String, int)
  - createFileDialog
```
public GralFileDialog_ifc createFileDialog()
```
    Description copied from interface: GralMngBuild_ifc
    
    Creates a file or directory dialog. The dialog can be activated (showed) any time. The dialog is showed in a own window, maybe modal or not.
    
    Specified by:
    
    createFileDialog in interface GralMngBuild_ifc
    
    Returns:
    
    Interface to deal with the dialog.
  - redrawWidget
```
public void redrawWidget(java.lang.String sName)
```
    Description copied from interface: GralMng_ifc
    
    Forces the redrawing for all set samples. It should be called after { @link #setSampleCurveViewY(String, float[])}.
    
    Specified by:
    
    redrawWidget in interface GralMng_ifc
    
    Parameters:
    
    sName - The name of the widget.
  - resizeWidget
```
public void resizeWidget(GralWidget widgd,
                         GralRectangle parentPix)
```
    Description copied from interface: GralMng_ifc
    
    Forces the resizing of the given widged.
    
    Specified by:
    
    resizeWidget in interface GralMng_ifc
    
    Parameters:
    
    widgd - the widget
  - XXXsetWindowsVisible
```
public boolean XXXsetWindowsVisible(GralWindow_ifc window,
                                    GralPos atPos)
```
    Description copied from interface: GralMng_ifc
    Sets a given and registered window visible at the given position and size or set it invisible.
    A window can be created by invoking org.vishia.gral.ifc.GralMngBuild_ifc#createWindow(String, boolean) in the build phase of the gui. It can be hidden because it is not necessary to show and operate with them. In a adequate phase of operate it can be shown and focused.
    The position is given relative to that panel, which is stored in GralPos#panel. To get a position instance, you can set a position invoking
    - GralMngBuild_ifc.selectPanel(String)
    - org.vishia.gral.ifc.GralMngBuild_ifc#setPosition(float, float, float, float, int, char)
    - GralGridPos pos = GralMngBuild_ifc.getPositionInPanel().
    That can be done in the build phase of the graphic. The position can be stored. It is possible to adjust the position relative to the unchanged panel by changing the values of GralPos.x etc. It is possible too to change the Panel which relates to the position. Then the grid managing instance have to be known via the GralMngBuild_ifc to select a panel. The panels may be moved or resized. With the knowledge of the relative position of the window in respect to a panel of the parent window, the window can be placed onto a proper position of the whole display.
    Specified by:
    
    XXXsetWindowsVisible in interface GralMng_ifc
    
    Parameters:
    
    window - the instance of the window wrapper.
    
    atPos - If null then hide the window. If not null then show the window. The position and size of the window is given related to any panel of any other window.
    
    Returns:
    
    true if it is visible.
  - setSampleCurveViewY
```
public void setSampleCurveViewY(java.lang.String sName,
                                float[] values)
```
    Description copied from interface: GralMng_ifc
    
    Adds a sampling value set.
    
    Specified by:
    
    setSampleCurveViewY in interface GralMng_ifc
    
    Parameters:
    
    sName - The registered name
    
    values - The values.

Class GralMng

Nested Class Summary

Field Summary

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

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

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

sVersion

posCurrent

posThreadSafe

XXXcfgBuilder

cfgWriter

designer

cfgData

bDesignMode

bDesignerIsInitialized

propertiesGui

gralProps

idxNameWidgets

idxShowFields

idxPanels

screen

idxWindows

windPrimary

widgetsInFocus

infoHelp

infoBox

infoLog

sHelpBase

listVisiblePanels

listWidgetsPermanentUpdating

log

applAdapter

curveContainer

bBelow

bRigth

userMainKeyAction

replacerAlias

sCurrPanel

lastClickedWidget

userActions

dataReplace

graphicThreadId

debugPrint

isWakedUpOnly

bStarted

bShouldExitImplGraphic

bIsExitImplGraphic

bExitMain

bShouldExitMain

checkTimes

queueOrdersToExecute

awakeThread

bDispatcherSleeps

evSrc

_mngImpl

XXXsingleton

actionPanelActivate

actionShowWidgetInfos

actionFileSelect

actionDesignEditField

actionReadPanelCfg

runGraphicThread

runAwakeThread

actionHelp

actionClose

gralFocusListener

_implListener

Constructor Detail

GralMng

GralMng

Method Detail

initScript

initScript

createGraphic

XXXcreate

setLog

createWindow