com.goldencode.p2j.ui.client.gui

Class ImageGuiImpl

java.lang.Object

com.goldencode.p2j.ui.client.widget.AbstractWidget<O>

com.goldencode.p2j.ui.client.Image<GuiOutputManager>

com.goldencode.p2j.ui.client.gui.ImageGuiImpl

All Implemented Interfaces:

Widget<GuiOutputManager>, WidgetWithConfig<ImageConfig>, ConfigOwner<ImageConfig>, java.awt.event.MouseListener, java.awt.event.MouseMotionListener, java.awt.event.MouseWheelListener, java.util.EventListener

Direct Known Subclasses:

WindowTitleBar.WindowIcon

public class ImageGuiImpl
extends Image<GuiOutputManager>

Implementation of a IMAGE widget for the GUI driver.

Field Summary

Fields

Modifier and Type	Field and Description
private GuiColorResolver	colorResolver Color resolver
protected ImageWrapper<?>	cutImg The image object.
private GuiDriver	gd The graphics driver.
protected ImageWrapper<?>	img The image object.
private boolean	isIcon To keep track if this is the window icon or not.
protected static CentralLogger	LOG logger

Fields inherited from class com.goldencode.p2j.ui.client.Image

config

Fields inherited from class com.goldencode.p2j.ui.client.widget.AbstractWidget

insets, listeners, location, mousePtr, nativeInsets, physicalLocation

Constructor Summary

Constructors

Constructor and Description
ImageGuiImpl(WidgetId id) Create a new image widget.
ImageGuiImpl(WidgetId id, boolean isIcon) Create a new image widget.
ImageGuiImpl(WidgetId id, ImageConfig cfg) Special constructor used to restore component using given configuration.

Method Summary

Modifier and Type	Method and Description
void	afterConfigUpdate(ImageConfig beforeUpdate) The method is called after the configuration associated with the implementor changes.
protected java.lang.Object[]	calculateDrawingParameters() Calculates the drawing parameters: width = (Integer) drawingParameters[0]; height = (Integer) drawingParameters[1]; offsetX = (Integer) drawingParameters[2]; offsetY = (Integer) drawingParameters[3]; transparent = (Boolean) drawingParameters[4]; stretchToFit = (Boolean) drawingParameters[5]; retainShape = (Boolean) drawingParameters[6]; convert3D = (Boolean) drawingParameters[7];
void	clearImage() Clears the current image and repaint this widget.
void	draw() Draw this image
protected boolean	drawImage() Draw this image.
ZOrderClass	getZOrderClass() Get the Z-Order class
double	height() Get widget height.
int	heightPixels() Get widget height in pixels.
void	initialize(WidgetId id, ImageConfig cfg) Replacement API for the logic which should exist in the widget's c'tor, but the logic can't be executed as it depends on the widget being registered into the official registry.
boolean	isIcon() Checks if the image was icon based.
boolean	isInitialValueLayout() Reports if the initial height/width of the widget should take precedence in the frame layout algorithm.
protected boolean	isStretchToFit() The method returns a value indicating whether this image is supposed to be stretched-to-fit.
boolean	loadImage(java.lang.String fullName) Loads the new image for given image widget from the client side filesystem.
boolean	loadImage(java.lang.String fullName, boolean repaint) Loads the new image for given image widget from the client side filesystem.
protected int[]	mouseActions() Determine the mouse actions processed by this widget.
void	setColorResolver(GuiColorResolver colorResolver) Sets a new color resolver.
boolean	setGreyImage(ImageGuiImpl imgInit) Sets the new image as result of the grey transformation from given image widget.
boolean	setImage(byte[] byteImg) Sets the new image for given image widget on the client side.
boolean	setImage(byte[] byteImg, boolean repaint) Sets the new image for given image widget on the client side.
void	setImage(ImageWrapper imgNew) Sets the new image for this image widget.
double	width() Get widget width.
int	widthPixels() Get widget width in pixels.

Methods inherited from class com.goldencode.p2j.ui.client.Image

config, dimension, focusTraversable, minimumSize

Methods inherited from class com.goldencode.p2j.ui.client.widget.AbstractWidget

_setHidden, _setVisible, activateDirectManipulation, addFocusListener, addKeyListener, afterConfigUpdateBase, ancestor, ancestorId, autoResize, bounds, clear, clearWidget, clipRectangle, clipRectangle, clipWith, copyColors, copyState, createMouseHoverAction, deactivateDirectManipulation, debug, destroy, disable, disableTooltip, displayPhysicalLocation, drawCaret, enable, enableTooltip, enclosingFrame, findMouseSource, forceCursorOnFocus, forceVisibility, getActualBounds, getAndResetBitmap, getAndSetBitmap, getBitmapCopy, getCachedScreenLocation, getCachedScreenPhysicalLocation, getCustomMousePointer, getDefaultEvent, getEffectiveMousePointer, getId, getLoadedMousePointer, getMenuMouse, getMouseActions, getMousePosition, getPortableMouseEventCoordinates, getSelectedText, getState, getTextHeight, getTextHeightNative, getTextHeightNative, getTextWidth, getTextWidth, getTextWidthNative, getTextWidthNative, getVisiblePart, hasFocus, hasTooltip, hidden, hide, highlighted, ignoreAction, initialHeight, initialWidth, insets, isCurrent, isDirectManipulationActive, isDirectManipulationActiveOrInUIB, isDirectManipulationCapable, isDirectManipulationRequired, isDisplayed, isEnabled, isFocusable, isHeader, isMouseDrag, isRealized, isRepaintDisabled, isRMBEntrySupported, isScreenLocationCached, isTabStop, isThreeD, isTotallyObscured, isVisible, isVisible, location, manageSystemActions, mouseClicked, mouseDragged, mouseEntered, mouseExited, mouseMoved, mousePressed, mouseReleased, mouseWheelMoved, moveToBottom, moveToTop, name, navigable, oleDoDrop, oleDrag, oleDragging, oleStartDragging, onOleDragging, onOleDropEnd, parent, parent, parentObject, parentOrSelf, parentOrSelfObject, physicalBounds, physicalDimension, physicalLocation, postprocessConfig, prepParentLocation, preventFocusWhenMouseDownEventDefined, processDirectManipulationEvent, processEvent, processFocusEvent, processKeyEvent, processKeyEventForSelectableWidget, processKeyListeners, processMnemonic, processMnemonicImpl, processSystemKey, raiseLegacyMouseEvents, reflectAncestorChange, reflectLocationChanged, reflectSizeChanged, refresh, registerWidgetListener, repaint, repaint, repaint, requestFocus, requestSync, resetBitmap, resizeTo, resolveFont, resolvePopupMenuId, resolveTitleFont, screen, screenDimension, screenHeight, screenLocation, screenPhysicalLocation, screenWidth, setBitmap, setCachedScreenLocation, setCachedScreenPhysicalLocation, setDirectManipulationActive, setEnabled, setHidden, setHighlighted, setLocation, setLocation, setMousePointer, setMousePointer, setParent, setPhysicalDimensionInt, setPhysicalLocation, setSensitiveForUIB, setState, setVisible, setWindow, show, showPopupMenu, supportsCustomMousePointer, sync, topLevelWindow, toString, translate, triggerLocationChanged, unrealize, unregisterWidgetListener, updateSizeWorker, updateSystemParent, widgetRealized, widgetStateChanged, window

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.goldencode.p2j.ui.client.widget.Widget

acceptsEscAsAnyKey, acceptTrigger, canMovetoTop, completeTrigger, defaultMousePtr, enforceDefaultMousePtr, getIdForTrigger, getLegacyWidget, getTriggerWidget, getTriggerWidget, hasFocus, ignoreEnable, isCurrent, isDirectManipulable, isDroppable, isLegacyFocus, isProcessProgressEvent, maySwitchFocus, parent, refreshWidget, requestFocus, requestFocus, startTrigger, systemFocusGrabbed, validateDisplayValue

Field Detail

LOG

protected static final CentralLogger LOG

logger

img

protected ImageWrapper<?> img

The image object.

cutImg

protected ImageWrapper<?> cutImg

The image object.

gd

private GuiDriver gd

The graphics driver.

isIcon

private boolean isIcon

To keep track if this is the window icon or not.

colorResolver

private GuiColorResolver colorResolver

Color resolver

Constructor Detail

ImageGuiImpl

public ImageGuiImpl(WidgetId id)

Create a new image widget.

Parameters:

id - The widget's ID.

ImageGuiImpl

public ImageGuiImpl(WidgetId id,
                    boolean isIcon)

Create a new image widget.

Parameters:

id - The widget's ID.

isIcon - Flag indicating the image is the window title bar icoon.

ImageGuiImpl

public ImageGuiImpl(WidgetId id,
                    ImageConfig cfg)

Special constructor used to restore component using given configuration.

Parameters:

id - The widget's ID.

cfg - Configuration data.

Method Detail

initialize

public void initialize(WidgetId id,
                       ImageConfig cfg)

Replacement API for the logic which should exist in the widget's c'tor, but the logic can't be executed as it depends on the widget being registered into the official registry.

This API is called after the widget is created and added to the registry.

Specified by:

initialize in interface WidgetWithConfig<ImageConfig>

Overrides:

initialize in class Image<GuiOutputManager>

Parameters:

id - The widget's ID.

cfg - The config used to initialize this widget.

afterConfigUpdate

public void afterConfigUpdate(ImageConfig beforeUpdate)

The method is called after the configuration associated with the implementor changes. The parameter points to a reference representing the original configuration state. This reference can be used to detect what configuration fields changed and so optimize any processing related to the configuration change.

Specified by:

afterConfigUpdate in interface ConfigOwner<ImageConfig>

Overrides:

afterConfigUpdate in class Image<GuiOutputManager>

Parameters:

beforeUpdate - Config reference capturing the config state before the owner's config was modified.

draw

public void draw()

Draw this image

Specified by:

draw in interface Widget<GuiOutputManager>

Specified by:

draw in class AbstractWidget<GuiOutputManager>

height

public double height()

Get widget height.

Specified by:

height in interface Widget<GuiOutputManager>

Specified by:

height in class AbstractWidget<GuiOutputManager>

Returns:

widget height.

heightPixels

public int heightPixels()

Get widget height in pixels.

Returns:

widget height.

width

public double width()

Get widget width.

Specified by:

width in interface Widget<GuiOutputManager>

Specified by:

width in class AbstractWidget<GuiOutputManager>

Returns:

widget width.

widthPixels

public int widthPixels()

Get widget width in pixels.

Returns:

widget width.

setImage

public boolean setImage(byte[] byteImg)

Sets the new image for given image widget on the client side.

Parameters:

byteImg - A new image array data.

Returns:

TRUE if operation successful FALSE otherwise.

setImage

public boolean setImage(byte[] byteImg,
                        boolean repaint)

Sets the new image for given image widget on the client side.

Parameters:

byteImg - A new image array data.

repaint - Need immediate repaint of the new image.

Returns:

TRUE if operation successful FALSE otherwise.

setImage

public void setImage(ImageWrapper imgNew)

Sets the new image for this image widget.

Parameters:

imgNew - A new image data container.

setGreyImage

public boolean setGreyImage(ImageGuiImpl imgInit)

Sets the new image as result of the grey transformation from given image widget.

Parameters:

imgInit - The image widget with original data to transform.

Returns:

TRUE if operation successful FALSE otherwise.

loadImage

public boolean loadImage(java.lang.String fullName)

Loads the new image for given image widget from the client side filesystem.

Parameters:

fullName - The fully qualified file name for the image to be loaded.

Returns:

TRUE if operation successful FALSE otherwise.

loadImage

public boolean loadImage(java.lang.String fullName,
                         boolean repaint)

Loads the new image for given image widget from the client side filesystem.

Parameters:

fullName - The fully qualified file name for the image to be loaded.

repaint - Need immediate repaint of the new image.

Returns:

TRUE if operation successful FALSE otherwise.

clearImage

public void clearImage()

Clears the current image and repaint this widget.

isIcon

public boolean isIcon()

Checks if the image was icon based.

Returns:

TRUE if icon assumed, FALSE otherwide.

setColorResolver

public void setColorResolver(GuiColorResolver colorResolver)

Sets a new color resolver.

Parameters:

colorResolver - The color resolver

isInitialValueLayout

public boolean isInitialValueLayout()

Reports if the initial height/width of the widget should take precedence in the frame layout algorithm. The initial height/width is that which is set during frame setup for static widgets. This means it was hard coded in the original static definition of the widget in in the 4GL source code.

Returns:

true if the initial values control layout.

getZOrderClass

public ZOrderClass getZOrderClass()

Get the Z-Order class

Specified by:

getZOrderClass in interface Widget<GuiOutputManager>

Overrides:

getZOrderClass in class AbstractWidget<GuiOutputManager>

Returns:

Z-Order class of the widget

calculateDrawingParameters

protected java.lang.Object[] calculateDrawingParameters()

Calculates the drawing parameters: width = (Integer) drawingParameters[0]; height = (Integer) drawingParameters[1]; offsetX = (Integer) drawingParameters[2]; offsetY = (Integer) drawingParameters[3]; transparent = (Boolean) drawingParameters[4]; stretchToFit = (Boolean) drawingParameters[5]; retainShape = (Boolean) drawingParameters[6]; convert3D = (Boolean) drawingParameters[7];

Returns:

The array filled with drawing parameters.

drawImage

protected boolean drawImage()

Draw this image.

Returns:

A value indicating the result of the operation, true means the image was requested to be drawn by the driver, false otherwise.

mouseActions

protected int[] mouseActions()

Determine the mouse actions processed by this widget.

Overrides:

mouseActions in class AbstractWidget<GuiOutputManager>

Returns:

See above.

isStretchToFit

protected boolean isStretchToFit()

The method returns a value indicating whether this image is supposed to be stretched-to-fit.

Returns:

See above.