com.goldencode.p2j.extension

Class MsgBlaster

java.lang.Object

com.goldencode.p2j.comauto.ComObject

com.goldencode.p2j.extension.MsgBlaster

All Implemented Interfaces:

Deletable, WrappedResource

public class MsgBlaster
extends ComObject

Encapsulates the Java logic for FWD implementation of MsgBlaster32 COM object.

Field Summary

Fields

Modifier and Type	Field and Description
private java.lang.Integer	hWndTarget The target hWnd.
private boolean	invalid Flags if this object has been yet destroyed and is no longer valid.
private java.util.Map<java.lang.Integer,java.lang.Integer>	msgList Internal data structure.
private java.util.Map<java.lang.Integer,java.lang.Integer>	msgPassage Internal data structure.
private static ContextLocal<java.util.Map<java.lang.Long,MsgBlaster>>	repository Stores all known MsgBlaster instances mapped by their ids.

Fields inherited from class com.goldencode.p2j.comauto.ComObject

includeUnannotatedMethods, LOGGER, methodTable, propertyTable

Constructor Summary

Constructors

Constructor and Description
MsgBlaster() The constructor.

Method Summary

Modifier and Type	Method and Description
void	delete() Perform actual delete of all resources.
void	fire() Test method.
java.lang.String	getActivexName() Obtain the Activex name of this COM object.
integer	getHWndTarget() Obtain the hwnd of the target frame.
static MsgBlaster	getInstanceById(long id) Obtain a specific instance of MsgBlaster using its id.
integer	getMsgList(int index) The getter for MsgList indexed property.
integer	getMsgPassage(int index) The getter for MsgPassage indexed property.
void	incomingMessage(int msgVal, int wParam, int lParam, int lplRetVal) Incoming notification from client-side.
void	sethWndTarget(integer newTarget) Sets the hwnd of the target frame.
void	setMsgList(integer val, int index) The setter for MsgList indexed property.
void	setMsgPassage(integer pass, int index) The setter for MsgPassage indexed property.
boolean	valid() Checks whether this object is valid.

Methods inherited from class com.goldencode.p2j.comauto.ComObject

call, chainCall, checkParameters, deref, destroy, getComObjectClass, getComObjectInstance, getName, getParentControlFrame, getParentProcedure, getProperty, id, id, init, marshal, ref, setName, setParentControlFrame, setProperty, unknown, unmarshal, unmarshal

Methods inherited from class java.lang.Object

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

Methods inherited from interface com.goldencode.p2j.util.Deletable

allowDelete

Field Detail

repository

private static final ContextLocal<java.util.Map<java.lang.Long,MsgBlaster>> repository

Stores all known MsgBlaster instances mapped by their ids.

hWndTarget

private java.lang.Integer hWndTarget

The target hWnd.

msgList

private final java.util.Map<java.lang.Integer,java.lang.Integer> msgList

Internal data structure.

The events that will be captured for the target widget and delivered as COM events.

I found a List Of Windows Messages at https://wiki.winehq.org/List_Of_Windows_Messages.

msgPassage

private final java.util.Map<java.lang.Integer,java.lang.Integer> msgPassage

Internal data structure.

The management of the event after capturing:

• -1 - this event will go back to windows
• 0 - this event does NOT go back to windows

invalid

private boolean invalid

Flags if this object has been yet destroyed and is no longer valid. A MsgBlaster object is valid throughout it lifetime until it is disposed using delete().

Constructor Detail

MsgBlaster

public MsgBlaster()

The constructor. After letting the super class initialize internal data, the object is put in the lookup map for further access by its id.

Method Detail

getInstanceById

public static MsgBlaster getInstanceById(long id)

Obtain a specific instance of MsgBlaster using its id. If such instance was not found (never created or already deleted) null is returned.

Parameters:

id - The id of the MsgBlaster to be returned.

Returns:

The MsgBlaster with the requested id or null if not found.

getActivexName

public java.lang.String getActivexName()

Obtain the Activex name of this COM object.

Specified by:

getActivexName in class ComObject

Returns:

the Activex name of this COM object.

valid

public boolean valid()

Checks whether this object is valid.

Specified by:

valid in interface WrappedResource

Overrides:

valid in class ComObject

Returns:

true if this object is valid.

delete

public void delete()

Perform actual delete of all resources. At the time of this call, it is assumed the resource is valid for deletion (the handle and the resource are both valid).

Specified by:

delete in interface Deletable

Overrides:

delete in class ComObject

getHWndTarget

public integer getHWndTarget()

Obtain the hwnd of the target frame.

Returns:

the hwnd of the target frame.

sethWndTarget

public void sethWndTarget(integer newTarget)

Sets the hwnd of the target frame.

Parameters:

newTarget - the new hwnd of the target frame.

getMsgList

public integer getMsgList(int index)

The getter for MsgList indexed property.

Parameters:

index - The index of the property.

Returns:

The value of the property at requested index.

setMsgList

public void setMsgList(integer val,
                       int index)

The setter for MsgList indexed property.

Parameters:

val - The value to be set for the property at requested index.

index - The index of the property.

getMsgPassage

public integer getMsgPassage(int index)

The getter for MsgPassage indexed property.

Parameters:

index - The index of the property.

Returns:

The value of the property at requested index.

setMsgPassage

public void setMsgPassage(integer pass,
                          int index)

The setter for MsgPassage indexed property.

Possible values (extracted from comments in customer's code):

• -1 = Windows has message digested first;
• 0 = Windows does nothing with message.

Parameters:

pass - The value to be set for the property at requested index.

index - The index of the property.

incomingMessage

public void incomingMessage(int msgVal,
                            int wParam,
                            int lParam,
                            int lplRetVal)

Incoming notification from client-side.

Parameters:

msgVal - The message id. Should be one already added to msgList.

wParam - Message parameter 1.

lParam - Message parameter 2.

lplRetVal - Message parameter / return value.

fire

public void fire()

Test method. Will be removed after debugging.