org.mases.jcobridge

Interface IJCGraphicContainer

public interface IJCGraphicContainer

The IJCGraphicContainer interface represents a generic entry point to manage graphic containers which wraps and embed JVM graphic object within WPF/WinForms hosting applications

JCOBridge offers an implementation for AWT/Swing

Since:

2.2.0.0

Author:

MASES S.R.L.

Method Summary

Modifier and Type	Method and Description
void	destroy() Destroy the graphic container
void	endMeasureOverride() End MeasureOverride operation
Object	getGraphicObject() The graphic Object hosted from the graphic container
int	getMeasureOverrideHeight() MeasureOverride Height
int	getMeasureOverrideWidth() MeasureOverride Width
long	getNativeWindowHandle() Retrieves the native handle to the hosting window
boolean	hasFocusWithinCore() Get focus state
boolean	hasMeasureOverride() Return if the graphic container implements management of MeasureOverride
boolean	hasWndProcHandler() Return if the graphic container implements management for WndProc
void	initialize(long hwndHost) Initialize the graphic container
boolean	isRemoteManaged() Return if the graphic container implements embedding styles and all management for window placement On Windows this means to remove from the HWND: WS_CAPTION | WS_THICKFRAME | WS_MINIMIZEBOX | WS_MAXIMIZEBOX | WS_SYSMENU and add the child behavior using WS_CHILDWINDOW
void	setSizeAndVisibility(boolean isVisible, int x, int y, int width, int height) Sets visibility and bounding rectangle
void	startMeasureOverride(int width, int height) Starts a MeasureOverride operation
boolean	wndProcHandler(long hwnd, int msg, long wParam, long lParam, boolean handled) Accesses the window process (handle) of the hosted child window

Method Detail

initialize

void initialize(long hwndHost)

Initialize the graphic container

Parameters:

hwndHost - The HWND of the hosting application

destroy

void destroy()

Destroy the graphic container

isRemoteManaged

boolean isRemoteManaged()

Return if the graphic container implements embedding styles and all management for window placement

On Windows this means to remove from the HWND: WS_CAPTION | WS_THICKFRAME | WS_MINIMIZEBOX | WS_MAXIMIZEBOX | WS_SYSMENU and add the child behavior using WS_CHILDWINDOW

Returns:

True if the graphic container implements embedding styles and management

setSizeAndVisibility

void setSizeAndVisibility(boolean isVisible,
                          int x,
                          int y,
                          int width,
                          int height)

Sets visibility and bounding rectangle

Parameters:

isVisible - Set visibility

x - The x-axis value of the left side of the rectangle.

y - The y-axis value of the top side of the rectangle.

width - A positive number that represents the width of the rectangle.

height - A positive number that represents the height of the rectangle.

hasMeasureOverride

boolean hasMeasureOverride()

Return if the graphic container implements management of MeasureOverride

Returns:

True if the object manages MeasureOverride

startMeasureOverride

void startMeasureOverride(int width,
                          int height)

Starts a MeasureOverride operation

Parameters:

width - The width constraint received

height - The height constraint received

getMeasureOverrideWidth

int getMeasureOverrideWidth()

MeasureOverride Width

Returns:

The width measured

getMeasureOverrideHeight

int getMeasureOverrideHeight()

MeasureOverride Height

Returns:

The height measured

endMeasureOverride

void endMeasureOverride()

End MeasureOverride operation

hasWndProcHandler

boolean hasWndProcHandler()

Return if the graphic container implements management for WndProc

Returns:

True if the object manages WndProc

wndProcHandler

boolean wndProcHandler(long hwnd,
                       int msg,
                       long wParam,
                       long lParam,
                       boolean handled)

Accesses the window process (handle) of the hosted child window

Parameters:

hwnd: - The window handle of the hosted window.

msg: - The message to act upon.

wParam: - Information that may be relevant to handling the message. This is typically used to store small pieces of information, such as flags.

lParam: - Information that may be relevant to handling the message. This is typically used to reference an object.

handled: - The handled value coming from the orginal call.

Returns:

True if the event was handled

hasFocusWithinCore

boolean hasFocusWithinCore()

Get focus state

Returns:

the focus state of the graphic container

getNativeWindowHandle

long getNativeWindowHandle()

Retrieves the native handle to the hosting window

Returns:

The native pointer

getGraphicObject

Object getGraphicObject()

The graphic Object hosted from the graphic container

Returns:

Object hosted