org.vishia.gral.swing

Class SwingMng

java.lang.Object

org.vishia.gral.base.GralMng.ImplAccess

org.vishia.gral.swing.SwingMng

public class SwingMng
extends GralMng.ImplAccess

Field Summary

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

gralMng, sizeCharProperties, threadGuiDispatch

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
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)
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)
GralRectangle	calcWidgetPosAndSize(GralPos pos, int widthwidgetNat, int heigthWidgetNat) Calculates the bounds of a widget with a given pos independent of this GralMng.ImplAccess.pos().
protected void	closeImplGraphic()
protected GralMenu	createContextMenu(GralWidget widgg) Creates the context menu for the given widget for right-mouse pressing.
GralFileDialog_ifc	createFileDialog()
void	createImplWidget_Gthread(GralWidget widgg) This operation creates the proper implementation widgets due to the underlying Graphic system.
protected GralMenu	createMenuBar(GralWindow windg) Creates the menu bar for the given window.
protected void	createSubWindow(GralWindow windowGral)
GralWindow	createWindow(java.lang.String name, java.lang.String title, int windProps)
protected boolean	dispatchOsEvents() Calls the dispatch routine of the implementation graphic.
void	finishInit()
java.lang.Object	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.lang.Object	getCurrentPanel() Forbidden.
java.lang.String	getValueFromWidget(GralWidget widgd)
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.
protected 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.
protected GralRectangle	resizeWidget(GralWidget widgd, GralRectangle parentPix) Forces the resizing of the given widged.
protected void	setSampleCurveViewY(java.lang.String sName, float[] values) Adds a sampling value set.
protected boolean	showContextMenuGthread(GralWidget widg) Shows the context menu of any widget independent of the internal right-mouse invocation.
void	wakeup() This method should be implemented by the graphical base.
protected GralMenu	XXXaddPopupMenu(java.lang.String sName)
protected 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

Constructor Detail

SwingMng

protected SwingMng(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

getCurrentPanel

public java.lang.Object 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:

createImplWidget_Gthread

public void createImplWidget_Gthread(GralWidget widgg)

Description copied from class: GralMng.ImplAccess

This operation creates the proper implementation widgets due to the underlying Graphic system. It is implemented by the specific GralMngXyz, see SwtMng.

Specified by:

createImplWidget_Gthread in class GralMng.ImplAccess

Parameters:

widgg - The given instantiated GralWidget but without implementation instacne yet.

createContextMenu

protected GralMenu createContextMenu(GralWidget widgg)

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

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:

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

createWindow

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

Specified by:

createWindow in class GralMng.ImplAccess

createSubWindow

protected void createSubWindow(GralWindow windowGral)
                        throws java.io.IOException

Specified by:

createSubWindow in class GralMng.ImplAccess

Throws:

java.io.IOException

addText

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

Specified by:

addText in class GralMng.ImplAccess

addHtmlBox

public GralHtmlBox addHtmlBox(java.lang.String name)

Specified by:

addHtmlBox 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

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

addTable

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

Specified by:

addTable in class GralMng.ImplAccess

createFileDialog

public GralFileDialog_ifc createFileDialog()

Specified by:

createFileDialog in class GralMng.ImplAccess

XXXaddPopupMenu

protected GralMenu XXXaddPopupMenu(java.lang.String sName)

Specified by:

XXXaddPopupMenu in class GralMng.ImplAccess

calcWidgetPosAndSize

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

Description copied from class: GralMng.ImplAccess

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. This method is not intent to use from an application, only for implementing methods of Gral. Therefore it isn't a member of the GralWindowMng_ifc and GralMngBuild_ifc 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.

getValueFromWidget

public java.lang.String getValueFromWidget(GralWidget widgd)

Specified by:

getValueFromWidget in class GralMng.ImplAccess

getColorImpl

public java.lang.Object 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.

redrawWidget

protected 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

protected 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

protected 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.

showContextMenuGthread

protected 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.

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

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

XXXsetWindowsVisible

protected 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.