org.vishia.gral.awt

Class AwtMng

java.lang.Object

org.vishia.gral.base.GralMng.ImplAccess

org.vishia.gral.awt.AwtMng

public class AwtMng
extends GralMng.ImplAccess

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	AwtMng.AwtMngFocusListener Universal focus listener to register which widgets were in focus in its order, to set htmlHelp and to invoke the GralWidget.setActionFocused(GralUserAction).

Field Summary

Fields

Modifier and Type	Field and Description
protected AwtMng.AwtMngFocusListener	focusListener The package private universal focus listener.
private static java.util.HashMap<java.awt.Component,GralWidget>	gralWidgetFromComponent
(package private) AwtGralMouseListener.MouseListenerGralAction	mouseStdAction The standard listener or action for mouse events, able to assign to all widgets which does not need an extra mouse behaviour.
(package private) AwtProperties	propertiesGuiAwt
(package private) java.awt.event.KeyListener	XXXXX_mainKeyListener

Fields inherited from class org.vishia.gral.base.GralMng.ImplAccess

gralMng, sizeCharProperties, threadGuiDispatch

Constructor Summary

Constructors

Constructor and Description
AwtMng(GralMng gralMng, char displaySize, LogMessage log) Creates an instance.

Method Summary

Modifier and Type	Method and Description
void	add(GralTable<?> table)
GralCurveView	addCurveViewY(java.lang.String sName, int nrofXvalues, GralCurveView.CommonCurve common)
void	addFocusAction(GralWidget widgetInfo, GralUserAction action, java.lang.String sCmdEnter, java.lang.String sCmdRelease)
GralWidget	addFocusAction(java.lang.String sName, GralUserAction action, java.lang.String sCmdEnter, java.lang.String sCmdRelease)
GralHtmlBox	addHtmlBox(java.lang.String name) Adds a text box for showing or editing a text in multi lines.
java.lang.Object	addImage(java.lang.String sName, java.io.InputStream imageStream, int height, int width, java.lang.String sCmd)
GralWidget	addSlider(java.lang.String sName, GralUserAction action, java.lang.String sShowMethod, java.lang.String sDataPath)
GralTable	addTable(java.lang.String sName, int height, int[] columnWidths)
GralWidget	addText(java.lang.String sText, char size, int color) Deprecated.
(package private) GralRectangle	calcPositionOfWindow(GralPos posWindow) Calculates the position as absolute value on screen from a given position inside a panel.
GralRectangle	calcWidgetPosAndSize(GralPos pos, int widthwidgetNat, int heigthWidgetNat) Calculates the bounds of a widget with a given pos independent of this GralMng.ImplAccess.pos().
(package private) GralRectangle	calcWidgetPosAndSizeAwt(GralPos pos, java.awt.Component component, int widthwidgetNat, int heigthWidgetNat) Calculates the bounds of a SWT component with a given position independent of GralMng.ImplAccess.pos().
protected void	closeImplGraphic()
protected GralMenu	createContextMenu(GralWidget widg) Creates the context menu for the given widget for right-mouse pressing.
GralFileDialog_ifc	createFileDialog()
void	createImplWidget_Gthread(GralWidget widgg) This is the core operation to create all implementation widgets from given GralWidget.
protected GralMenu	createMenuBar(GralWindow windg) Creates the menu bar for the given window.
void	createSubWindow(GralWindow windowGral)
GralWindow	createWindow(java.lang.String name, java.lang.String title, int windPros)
protected boolean	dispatchOsEvents() Calls the dispatch routine of the implementation graphic.
void	finishInit()
static java.awt.Component	getAwtImpl(GralWidgetBase_ifc widgg) Returns the Swt widget which implements the given GralWidget.
java.awt.Color	getColorImpl(GralColor color) Gets the color of the graphic implementation (swt.Color, swing.TODO) Either the implementation color instance is stored already in the GralColor, or it will be created, stored in GralColor and returned here.
java.awt.Container	getCurrentPanel() Forbidden.
(package private) GralRectangle	getPixelUseableAreaOfWindow(GralWidget widgg)
java.lang.String	getValueFromWidget(GralWidget widgetDescr)
java.awt.Container	getWidgetsPanel(GralWidget widg)
protected void	graphicThreadSleep() Forces the graphic thread to sleep and wait for any events.
protected void	initGraphic() This method should be implemented by the graphical implementation layer.
void	redrawWidget(java.lang.String sName) Forces the redrawing for all set samples.
boolean	remove(GralPanel_ifc compositeBox) Creates an independent grid panel which is managed by this.
void	reportContent(java.lang.Appendable out) Reports all existing Widgets on implementation level.
GralRectangle	resizeWidget(GralWidget widgd, GralRectangle parentPix) Forces the resizing of the given widged.
(package private) void	setBounds_(GralPos pos, java.awt.Component component) Places a current component with knowledge of the current positions and the spreads of the component on graphic.
protected void	setPosAndSize_(GralPos pos, java.awt.Component component)
(package private) void	setPosAndSizeAwt(GralPos posP, java.awt.Component component, int widthwidgetNat, int heigthWidgetNat) Set bounds of a AWT component with a given position.
void	setSampleCurveViewY(java.lang.String sName, float[] values) Adds a sampling value set.
boolean	showContextMenuGthread(GralWidget widg) Shows the context menu of any widget independent of the internal right-mouse invocation.
(package private) void	stop()
void	wakeup() This method should be implemented by the graphical base.
protected GralMenu	XXXaddPopupMenu(java.lang.String sName)
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 org.vishia.gral.base.GralMng.ImplAccess

getPanel, idxWindows, indexNameWidgets, listVisiblePanels_add, pos, sCurrPanel, startThread, userMainKeyAction

Methods inherited from class java.lang.Object

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

Field Detail

propertiesGuiAwt

final AwtProperties propertiesGuiAwt

mouseStdAction

final AwtGralMouseListener.MouseListenerGralAction mouseStdAction

The standard listener or action for mouse events, able to assign to all widgets which does not need an extra mouse behaviour.

gralWidgetFromComponent

private static final java.util.HashMap<java.awt.Component,GralWidget> gralWidgetFromComponent

XXXXX_mainKeyListener

java.awt.event.KeyListener XXXXX_mainKeyListener

focusListener

protected AwtMng.AwtMngFocusListener focusListener

The package private universal focus listener.

Constructor Detail

AwtMng

public AwtMng(GralMng gralMng,
              char displaySize,
              LogMessage log)

Creates an instance.

Parameters:

guiContainer - The container where the elements are stored in.

width - in display-units for the window's width, the number of pixel depends from param displaySize.

height - in display-units for the window's height, the number of pixel depends from param displaySize.

displaySize - character 'A' to 'E' to determine the size of the content (font size, pixel per cell). 'A' is the smallest, 'E' the largest size. Default: use 'C'.

Method Detail

getAwtImpl

public static java.awt.Component getAwtImpl(GralWidgetBase_ifc widgg)

Returns the Swt widget which implements the given GralWidget. It calls GralWidget_ifc.getImplWidget() and then checks, whether the Swt impl Widget is immediately an Control, or it istype of SwtWidgetHelper. In the last case SwtWidgetHelper#widgetSwt is returned.
New since 2022-09. The approach is, only the GralWidget.ImplAccess#wdgimpl should be used to store the aggregation to the implementation widget, so simple as possible.

Parameters:

widgg -

Returns:

null if a implementation is not available.

getCurrentPanel

public java.awt.Container getCurrentPanel()

Description copied from class: GralMng.ImplAccess

Forbidden. The current panel depends on the widget. Use SwtMng.getWidgetsPanel(GralWidget).

Specified by:

getCurrentPanel in class GralMng.ImplAccess

Returns:

getWidgetsPanel

public java.awt.Container getWidgetsPanel(GralWidget widg)

createImplWidget_Gthread

public void createImplWidget_Gthread(GralWidget widgg)

This is the core operation to create all implementation widgets from given GralWidget. It knows all types of widgets, selects it and calls the proper swt counterpart. See definition on GralMng.createImplWidget_Gthread(GralWidget)

Specified by:

createImplWidget_Gthread in class GralMng.ImplAccess

Parameters:

widgg - the existing GralWidget derived type

addHtmlBox

public GralHtmlBox addHtmlBox(java.lang.String name)

Adds a text box for showing or editing a text in multi lines.

Specified by:

addHtmlBox in class GralMng.ImplAccess

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:

//@Override public GralTextBox addTextBox(String name, boolean editable, String prompt, char promptStylePosition) { Container parent = (Container)pos().panel.getWidgetImplementation(); AwtTextBox widgetSwt = new AwtTextBox(name, parent, 0, this); GralWidget widgetInfo = widgetSwt; widgetInfo.setPanelMng(mng); //Text widgetSwt = new Text(((PanelSwt)pos.panel).getPanelImpl(), SWT.MULTI); widgetSwt.textFieldSwt.setFont(propertiesGuiAwt.stdInputFont); widgetSwt.textFieldSwt.setEditable(editable); if(editable) stop(); widgetSwt.textFieldSwt.setBackground(propertiesGuiAwt.colorAwt(GralColor.getColor("pbl"))); //widgetSwt.textFieldSwt.addMouseListener(mouseClickForInfo); setPosAndSize_(widgetSwt.textFieldSwt); if(prompt != null && promptStylePosition == 't'){ final int yPixelField; final Font promptFont; int ySize = (int)(pos().height()); switch(ySize){ case 3: promptFont = propertiesGuiAwt.smallPromptFont; yPixelField = propertiesGuiAwt.yPixelUnit() * 2 -3; break; case 2: promptFont = propertiesGuiAwt.smallPromptFont; yPixelField = (int)(1.5F * mng.propertiesGui.yPixelUnit()); break; default: promptFont = propertiesGuiAwt.smallPromptFont; yPixelField = mng.propertiesGui.yPixelUnit() * 2 -3; }//switch Rectangle boundsField = widgetSwt.textFieldSwt.getBounds(); Rectangle boundsPrompt = new Rectangle(boundsField.x, boundsField.y-3 //occupy part of field above, only above the normal letters , boundsField.width, boundsField.height ); if(promptStylePosition == 't'){ boundsPrompt.height -= (yPixelField -4); boundsPrompt.y -= 1; boundsField.y += (boundsField.height - yPixelField ); boundsField.height = yPixelField; } Label wgPrompt = new Label(); parent.add(wgPrompt); wgPrompt.setFont(promptFont); wgPrompt.setText(prompt); widgetSwt.textFieldSwt.setBounds(boundsField); wgPrompt.setBounds(boundsPrompt); } // if(widgetInfo.name !=null && widgetInfo.name.charAt(0) == '$'){ widgetInfo.name = sCurrPanel() + widgetInfo.name.substring(1); } //link the widget with is information together. widgetSwt.textFieldSwt.setData(widgetInfo); if(widgetInfo.name !=null){ if(!editable){ mng.registerShowField(widgetInfo); } } mng.registerWidget(widgetInfo); return widgetSwt; }

addCurveViewY

public GralCurveView addCurveViewY(java.lang.String sName,
                                   int nrofXvalues,
                                   GralCurveView.CommonCurve common)

Specified by:

addCurveViewY in class GralMng.ImplAccess

addFocusAction

public GralWidget addFocusAction(java.lang.String sName,
                                 GralUserAction action,
                                 java.lang.String sCmdEnter,
                                 java.lang.String sCmdRelease)

Specified by:

addFocusAction in class GralMng.ImplAccess

addFocusAction

public void addFocusAction(GralWidget widgetInfo,
                           GralUserAction action,
                           java.lang.String sCmdEnter,
                           java.lang.String sCmdRelease)

Specified by:

addFocusAction in class GralMng.ImplAccess

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 class GralMng.ImplAccess

addSlider

public GralWidget addSlider(java.lang.String sName,
                            GralUserAction action,
                            java.lang.String sShowMethod,
                            java.lang.String sDataPath)

Specified by:

addSlider in class GralMng.ImplAccess

addTable

public GralTable addTable(java.lang.String sName,
                          int height,
                          int[] columnWidths)

Specified by:

addTable in class GralMng.ImplAccess

add

public void add(GralTable<?> table)

addText

@Deprecated
public GralWidget addText(java.lang.String sText,
                                       char size,
                                       int color)

Deprecated.

Specified by:

addText in class GralMng.ImplAccess

XXXaddPopupMenu

protected GralMenu XXXaddPopupMenu(java.lang.String sName)

Specified by:

XXXaddPopupMenu in class GralMng.ImplAccess

createContextMenu

protected GralMenu createContextMenu(GralWidget widg)

Description copied from class: GralMng.ImplAccess

Creates the context menu for the given widget for right-mouse pressing. This method is invoked only in GralWidget.getContextMenu() whereby an existing context menu is stored in the GralWidget.contextMenu association. The widget have to be set to panel already, an implementation widget have to be existing. It means GralWidget#getWidgetImplementation() should be return that instance where the menu is to be added. This method is package protected because it should only be called internally.

Specified by:

createContextMenu in class GralMng.ImplAccess

createMenuBar

protected GralMenu createMenuBar(GralWindow windg)

Description copied from class: GralMng.ImplAccess

Creates the menu bar for the given window. This method is invoked only in GralWindow.getMenuBar() whereby an existing menu bar is stored in the GralWindow.menuBarGral association.

Specified by:

createMenuBar in class GralMng.ImplAccess

Parameters:

windg - The window

createFileDialog

public GralFileDialog_ifc createFileDialog()

Specified by:

createFileDialog in class GralMng.ImplAccess

createWindow

public GralWindow createWindow(java.lang.String name,
                               java.lang.String title,
                               int windPros)

Specified by:

createWindow in class GralMng.ImplAccess

createSubWindow

public void createSubWindow(GralWindow windowGral)

Specified by:

createSubWindow in class GralMng.ImplAccess

calcPositionOfWindow

GralRectangle calcPositionOfWindow(GralPos posWindow)

Calculates the position as absolute value on screen from a given position inside a panel.

Parameters:

posWindow - contains any GralPos#panel. Its absolute position will be determined. from that position and size the absolute postion will be calculate, with this given grid positions inside the panel.

Returns:

Absolute pixel coordinate.

getPixelUseableAreaOfWindow

GralRectangle getPixelUseableAreaOfWindow(GralWidget widgg)

remove

public boolean remove(GralPanel_ifc compositeBox)

Description copied from class: GralMng.ImplAccess

Creates an independent grid panel which is managed by this. The panel can be associated to any graphic frame.

Specified by:

remove in class GralMng.ImplAccess

Returns:

getColorImpl

public java.awt.Color getColorImpl(GralColor color)

Description copied from class: GralMng.ImplAccess

Gets the color of the graphic implementation (swt.Color, swing.TODO) Either the implementation color instance is stored already in the GralColor, or it will be created, stored in GralColor and returned here.

Specified by:

getColorImpl in class GralMng.ImplAccess

Parameters:

color - The Color.

Returns:

Instance of the implementation color.

getValueFromWidget

public java.lang.String getValueFromWidget(GralWidget widgetDescr)

Specified by:

getValueFromWidget in class GralMng.ImplAccess

redrawWidget

public void redrawWidget(java.lang.String sName)

Description copied from class: GralMng.ImplAccess

Forces the redrawing for all set samples. It should be called after { @link #setSampleCurveViewY(String, float[])}.

Specified by:

redrawWidget in class GralMng.ImplAccess

Parameters:

sName - The name of the widget.

resizeWidget

public GralRectangle resizeWidget(GralWidget widgd,
                                  GralRectangle parentPix)

Description copied from class: GralMng.ImplAccess

Forces the resizing of the given widged.

Specified by:

resizeWidget in class GralMng.ImplAccess

Parameters:

widgd - the widget

setSampleCurveViewY

public void setSampleCurveViewY(java.lang.String sName,
                                float[] values)

Description copied from class: GralMng.ImplAccess

Adds a sampling value set.

Specified by:

setSampleCurveViewY in class GralMng.ImplAccess

Parameters:

sName - The registered name

values - The values.

setBounds_

void setBounds_(GralPos pos,
                java.awt.Component component)

Places a current component with knowledge of the current positions and the spreads of the component on graphic.

Parameters:

component - The component to place.

setPosAndSize_

protected void setPosAndSize_(GralPos pos,
                              java.awt.Component component)

setPosAndSizeAwt

void setPosAndSizeAwt(GralPos posP,
                      java.awt.Component component,
                      int widthwidgetNat,
                      int heigthWidgetNat)

Set bounds of a AWT component with a given position. This method is package-private for SWT-implementation.

Parameters:

posP - The Position for the component.

component - The AWT-widget.

widthwidgetNat - The natural size of the component.

heigthWidgetNat - The natural size of the component.

calcWidgetPosAndSize

public GralRectangle calcWidgetPosAndSize(GralPos pos,
                                          int widthwidgetNat,
                                          int heigthWidgetNat)

Calculates the bounds of a widget with a given pos independent of this GralMng.ImplAccess.pos(). This method is a part of the implementing GralMng because the GralPos is not implemented for any underlying graphic system and the #propertiesGuiSwt are used. It is possible to tune the bounds after calculation, for example to enhance the width if a text is larger then the intended position.

Specified by:

calcWidgetPosAndSize in class GralMng.ImplAccess

Parameters:

pos - The position.

widthwidgetNat - The natural size of the component.

heigthWidgetNat - The natural size of the component.

Returns:

A rectangle with position and size.

calcWidgetPosAndSizeAwt

GralRectangle calcWidgetPosAndSizeAwt(GralPos pos,
                                      java.awt.Component component,
                                      int widthwidgetNat,
                                      int heigthWidgetNat)

Calculates the bounds of a SWT component with a given position independent of GralMng.ImplAccess.pos(). This method is package-private for SWT-implementation. It is possible to tune the bounds after calculation, for example to enhance the width if a text is larger then the intended position.

Parameters:

pos - The position.

component - The SWT-widget.

widthwidgetNat - The natural size of the component.

heigthWidgetNat - The natural size of the component.

Returns:

A rectangle with position and size.

showContextMenuGthread

public boolean showContextMenuGthread(GralWidget widg)

Description copied from class: GralMng.ImplAccess

Shows the context menu of any widget independent of the internal right-mouse invocation.

Specified by:

showContextMenuGthread in class GralMng.ImplAccess

Parameters:

widg - The widget.

Returns:

true if the widget have a context menu.

initGraphic

protected void initGraphic()

Description copied from class: GralMng.ImplAccess

This method should be implemented by the graphical implementation layer. It should build the graphic main window and returned when finished. This routine is called as the first routine in the Graphic thread's method GralMng.runGraphicThread(). See SwtGraphicThread.

Specified by:

initGraphic in class GralMng.ImplAccess

closeImplGraphic

protected void closeImplGraphic()

Specified by:

closeImplGraphic in class GralMng.ImplAccess

dispatchOsEvents

protected boolean dispatchOsEvents()

Description copied from class: GralMng.ImplAccess

Calls the dispatch routine of the implementation graphic.

Specified by:

dispatchOsEvents in class GralMng.ImplAccess

Returns:

true if dispatching should be continued.

graphicThreadSleep

protected void graphicThreadSleep()

Description copied from class: GralMng.ImplAccess

Forces the graphic thread to sleep and wait for any events. Either this routine returns if GralMng.ImplAccess.wakeup() is called or this routine returns if the operation system wakes up the graphic thread.

Specified by:

graphicThreadSleep in class GralMng.ImplAccess

wakeup

public void wakeup()

Description copied from class: GralMng.ImplAccess

This method should be implemented by the graphical base. It should be waked up the execution of the graphic thread because some actions are registered..

Specified by:

wakeup in class GralMng.ImplAccess

reportContent

public void reportContent(java.lang.Appendable out)
                   throws java.io.IOException

Description copied from class: GralMng.ImplAccess

Reports all existing Widgets on implementation level. This operation is implemented in the specific implementation managers.
See also GralMng.reportGralContent(Appendable) for the Gral level.

Specified by:

reportContent in class GralMng.ImplAccess

Parameters:

out - any output, maybe especially System.out or LogMessage

Throws:

java.io.IOException

finishInit

public void finishInit()

Specified by:

finishInit in class GralMng.ImplAccess

stop

void stop()

XXXsetWindowsVisible

public boolean XXXsetWindowsVisible(GralWindow_ifc window,
                                    GralPos atPos)

Description copied from class: GralMng.ImplAccess

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 class GralMng.ImplAccess

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.