org.vishia.gral.base

Class GralWidgetBase.GralWidgComposite

java.lang.Object

org.vishia.gral.base.GralWidgetBase.GralWidgComposite

Enclosing class:

GralWidgetBase

public final class GralWidgetBase.GralWidgComposite
extends java.lang.Object

This inner class is used for the instance GralWidgetBase._cdata if the widget is a composite widget.

Field Summary

Fields

Modifier and Type	Field and Description
protected java.util.Map<java.lang.String,GralWidgetBase>	idxWidgets Map of widgets by name of this composite widget.
protected GralWidgetBase_ifc	primaryWidget The widget which should be focused if this composite widget (panel) is focused.
protected java.util.List<GralWidgetBase>	widgetList List of all widgets which are contained in this panel.
java.util.List<GralWidgetBase>	widgetsToResize Widgets which should be resized if this parent widget is resized.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	GralWidgComposite() Only used in ctor of GralWidgetBase.GralWidgetBase(GralPos, String, boolean), nothing else.

Method Summary

Modifier and Type	Method and Description
protected void	addWidget(GralWidgetBase widg, boolean toResize) Adds a widget to this composite (its panel).
void	removeWidget(GralWidgetBase widg) Removes the widget from the lists of this composite (panel).
(package private) void	reportAllContent(java.lang.Appendable out, int recursion) Writes the content of this composite widget in a readable form to debug the graphic assembling.
protected void	resizeWidgets(GralRectangle parentPixelRectangle, int recursion) Resizes the current widget and all child widgets with the known GralWidgetBase._wdgPos and the parent bounds.

Methods inherited from class java.lang.Object

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

Field Detail

widgetList

protected java.util.List<GralWidgetBase> widgetList

List of all widgets which are contained in this panel. This list is used in the communication thread to update the content of all widgets in the panel.

widgetsToResize

public java.util.List<GralWidgetBase> widgetsToResize

Widgets which should be resized if this parent widget is resized.

primaryWidget

protected GralWidgetBase_ifc primaryWidget

The widget which should be focused if this composite widget (panel) is focused. It is possible to set any current widget to store the focus situation, It is possible too to have only one dedicated widget to focus. if the panel gets the focus.

idxWidgets

protected final java.util.Map<java.lang.String,GralWidgetBase> idxWidgets

Map of widgets by name of this composite widget.

Constructor Detail

GralWidgComposite

protected GralWidgComposite()

Only used in ctor of GralWidgetBase.GralWidgetBase(GralPos, String, boolean), nothing else.

Method Detail

addWidget

protected void addWidget(GralWidgetBase widg,
                         boolean toResize)

Adds a widget to this composite (its panel). This method is only used in the ctor of GralWidgetBase.GralWidgetBase(GralPos, String, boolean) to add the yet created widget to its parent (panel) given due the GralPos.

Parameters:

widg -

toResize -

removeWidget

public void removeWidget(GralWidgetBase widg)

Removes the widget from the lists of this composite (panel). This method is not intent to invoke by an application. It is only used in GralWidgetBase.remove(). Use the last one method to remove a widget includint is disposition and remove from the panel.

Parameters:

widg - The widget.

resizeWidgets

protected void resizeWidgets(GralRectangle parentPixelRectangle,
                             int recursion)

Resizes the current widget and all child widgets with the known GralWidgetBase._wdgPos and the parent bounds. This operation is called recursively for all children widgets which have composite children ( GralWidgetBase._cdata is given ). The implementing graphic should only call this operation in the resize listener of the window. All others is done recursively. A resize listener of panels (swt.widget.Composite) is not necessary, because the widget structure is completely contained in this class itself. Specific operations to determine the bounds of widgets are not necessary.
But for any widget the operation GralWidgetBase.resizePostPreparation() is called. This operation is empty per default but can be overridden, for example to detect number of shown lines in the GralTable.
The user's application should never call this operation. It is only a Gral system operation to resize. Thats why it is protected.

Parameters:

parentPixelRectangle - parent bounds, either the client area of a window by the first call or the bounds of the parent, which are set before, calculated from the size of the parent.

recursion - as usual on recursively call, prevents too much erroneous recursions, to prevent a stack overflow on faulty situations. The limit is 50, it means 50 nested widgets, enough at all.

reportAllContent

void reportAllContent(java.lang.Appendable out,
                      int recursion)
               throws java.io.IOException

Writes the content of this composite widget in a readable form to debug the graphic assembling.

Parameters:

out - to this output

recursion - if level >=50 then it does not get deeper. this operation is recursively called in the tree of widgets.

Throws:

java.io.IOException