org.vishia.gral.base

Interface GralWidgImplAccess_ifc

All Known Implementing Classes:

AwtButton, AwtLabel, AwtPanel, AwtSubWindow, AwtTextBox, AwtTextField, GralButton.GraphicImplAccess, GralCanvasArea._GraphicImplAccess_, GralCurveView.GraphicImplAccess, GralHorizontalSelector.GraphicImplAccess, GralHtmlBox.ImplAccess, GralLabel.GraphicImplAccess, GralLed.GraphicImplAccess, GralPanelContent.ImplAccess, GralSlider._GraphicImplAccess_, GralTable.GraphicImplAccess, GralTextField.GraphicImplAccess, GralValueBar.GraphicImplAccess, GralWidget.ImplAccess, GralWindow.WindowImplAccess, SwtButton, SwtCanvasArea, SwtCurveView, SwtGridPanel, SwtHorizontalSelector, SwtHtmlBox, SwtLabel, SwtLed, SwtPanel, SwtPanelArea9, SwtSlider, SwtSubWindow, SwtTable, SwtTextFieldWrapper, SwtValueBar, SwtWidgetSimpleWrapper

public interface GralWidgImplAccess_ifc

This interface is used as reference to the implementation access layer for all widgets. It defines all possible calls from the application to the implementation widget.

Note that most of user requirements are done by the GralWidget capability and the capabilities of its derived classes, for example GralWidget.setText(CharSequence) or GralWidget.setBackColor(org.vishia.gral.ifc.GralColor, int). That methods stores the text, color etc. in graphic-independent attributes. The method redrawGthread() is the central method to realize that user stimuli for the implementation graphic layer. That method can use especially the GralWidget.DynamicData and there quest method GralWidget.DynamicData.whatIsChanged. There is no needing of methods such as setText(String) etc. because the user should able to set the text in any thread. See concept of data set described on GralWidget.setText(CharSequence) See GralWidget._wdgImpl.

Since:

2013-06

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	version Version, history and license .

Method Summary

Modifier and Type	Method and Description
GralRectangle	getPixelPositionSize()
java.lang.Object	getWidgetImplementation() Returns the implementation class of the widget.
void	redrawGthread() This method should be implemented in all Widget implementations of the adapter for the underlying graphic system.
void	removeWidgetImplementation() Removes the graphical widget in the graphic.
void	setBoundsPixel(int x, int y, int dx, int dy) Set the bounds of the implementation widget.
boolean	setFocusGThread() Sets the focus to the widget.
GralRectangle	setPosBounds(GralRectangle parentPix) Set the bounds of a widget using the GralWidgetBase.pos() coordinates and the pixels from a parent.
void	setVisibleGThread(boolean bVisible) Sets the implementation widget(s) visible state.
void	updateValuesForAction() This operation should be called before any action is invoked in the user space.

Field Detail

version

static final java.lang.String version

Version, history and license .

• 2023-04-16 setPosBounds(GralRectangle) with GralRectangle for composite widgets.
• 2022-01-29 Hartmut add: updateValuesForAction() used for GralTextField for cursor positions.
• 2013-06-20 Hartmut Creation.

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 ist 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

Method Detail

setFocusGThread

boolean setFocusGThread()

Sets the focus to the widget. See GralMng_ifc#setFocus(GralWidget).

Returns:

true if it has the focus after this operation. false on any error.

setVisibleGThread

void setVisibleGThread(boolean bVisible)

Sets the implementation widget(s) visible state. The widgets are really invisible, or they are visible in principle, but they can be covered by other windows or clipping. This method should set the GralWidgetBase.bVisibleState too. Therewith it is able to quest GralWidget.isVisible() in any thread.

Parameters:

bVisible - true then the widget should be visible, false it is set to invisible.

removeWidgetImplementation

void removeWidgetImplementation()

Removes the graphical widget in the graphic.

redrawGthread

void redrawGthread()

This method should be implemented in all Widget implementations of the adapter for the underlying graphic system.
Implementation hints: In SWT it should call redraw(). In AWT this is named 'repaint()'-
It is possible that the widget consists of more as one graphical widget, then all of it should be redrawn. It is possible that some data are set in another thread, they should be applied to the widgets firstly. It is possible that the widget is removed though a repaintGthread-order is pending from the time before deleting, for example if the graphic layout is changed.

See #repaintRequ

getWidgetImplementation

java.lang.Object getWidgetImplementation()

Returns the implementation class of the widget. If the widget has more as one implementation widgets, this method returns one of the widgets, usual the first important one respectively that widget which represents the implementation layer. A widget of the implementation layer is a SWT.control or a Component.

If more as one widget are part of the GralWidget, use the special GralWidget._wdgImpl class which should contain the references to that implementation widgets.

setBoundsPixel

void setBoundsPixel(int x,
                    int y,
                    int dx,
                    int dy)

Set the bounds of the implementation widget. This is called especially on resize from the panel, but also on creation for comprehensive widgets. If the widget is more comprehensive, consist of more basic widgets, then this operation should care about the parts of the widget.

Parameters:

x -

y -

dx -

dy -

setPosBounds

GralRectangle setPosBounds(GralRectangle parentPix)

Set the bounds of a widget using the GralWidgetBase.pos() coordinates and the pixels from a parent.

Parameters:

parentPix - the bounds of a parent. It is not necessary that this is the bounds of an existing panel. Also a sub region in a panel can be described with it, used for GralWidgComposite.

getPixelPositionSize

GralRectangle getPixelPositionSize()

updateValuesForAction

void updateValuesForAction()

This operation should be called before any action is invoked in the user space. It should update all values from the implementation widget to the GralWidget to enable getting it in the action.