se.entra.phantom.server

Class VirtualCUserWindow

java.lang.Object

se.entra.phantom.server.VirtualControl

se.entra.phantom.server.VirtualCUserWindow

All Implemented Interfaces:

NetPhantomConstants, PhantomControlType, VirtualChangeEvent, VirtualClientMessages, VirtualInterface, VirtualTooltipInterface

public class VirtualCUserWindow
extends VirtualControl

The class wrapping virtual user windows on the Server side.

Field Summary

Fields inherited from interface se.entra.phantom.server.PhantomControlType

CTRLTYPE_BUTTON, CTRLTYPE_CHECK, CTRLTYPE_COMBO, CTRLTYPE_FRAME, CTRLTYPE_GRAPH, CTRLTYPE_GROUP, CTRLTYPE_INOUT, CTRLTYPE_LIST, CTRLTYPE_MLE, CTRLTYPE_NOTE, CTRLTYPE_OUT, CTRLTYPE_RADIO, CTRLTYPE_RECT, CTRLTYPE_SPIN, CTRLTYPE_SUB, CTRLTYPE_TEXT, CTRLTYPE_TREE, CTRLTYPE_UNKNOWN, CTRLTYPE_USER, CTRLTYPES_COUNT, names

Fields inherited from interface se.entra.phantom.server.VirtualInterface

TOOLTIP_TEXT

Fields inherited from interface se.entra.phantom.common.NetPhantomConstants

ACTION_CLOSEWINDOW, ACTION_CONTROL, ACTION_HOSTKEY, ACTION_MENU, ACTION_NONE, ACTION_NOTEBOOKPAGE, ACTION_POPUPMENU, CC_BACKGROUND, CC_BOTH, CC_FOREGROUND, CC_NONE, CLIPBOARD_GET, CLIPBOARD_SET, DATEF_DMY, DATEF_MDY, DATEF_SYSTEM, DATEF_YMD, DDE_ADVISE, DDE_EXECUTE, DDE_INITIATE, DDE_POKE, DDE_REQUEST, DDE_TERMINATE, DDE_UNADVISE, DDE_UPDATE, DDEVAR_DISABLE, DDEVAR_ENABLE, DDEVAR_REQUEST, DDEVAR_SET, DDEVAR_VALIDATE, EFT_AMOUNT, EFT_DATE, EFT_DATEAMOUNT, EFT_NORMAL, EFT_PASSWORD, EVENT_CHAR, EVENT_CHECK, EVENT_CLICK, EVENT_COMMAND, EVENT_DBLCLICK, EVENT_DDECONNECTION, EVENT_DDEDATA, EVENT_DDEERROR, EVENT_DDEEXECUTE, EVENT_DDEINVALIDATE, EVENT_DDEPOKE, EVENT_DDEREQUEST, EVENT_DEFOCUS, EVENT_FOCUS, EVENT_PAGEDOWN, EVENT_PAGEUP, EVENT_SELECT, EVENT_UNKNOWN, EVENT_USERCHANGE, EXTENDEDINFO_IDS_TO_CLIENT, FOCUSTYPE_CLIENTTARGET, FOCUSTYPE_CONTROL, FOCUSTYPE_NONE, ICON_CRITICAL, ICON_INFORMATION, ICON_NOICON, ICON_QUERY, ICON_WARNING, J_AUTO, J_BOTTOM, J_BOTTOMLEFT, J_BOTTOMRIGHT, J_CENTER, J_LEFT, J_RIGHT, J_TOP, J_TOPLEFT, J_TOPRIGHT, MAX_PANELS_PER_SESSION, MAX_SESSIONS, MB_ABORTRETRYIGNORE, MB_CANCEL, MB_ENTER, MB_ENTERCANCEL, MB_OK, MB_OKCANCEL, MB_RETRYCANCEL, MB_YESNO, MB_YESNOCANCEL, MBID_CANCEL, MBID_DEFAULT, MBID_ENTER, MBID_IGNORE, MBID_NO, MBID_OK, MBID_RETRY, MBID_YES, MS_MOVE, MS_NONE, MS_SIZE, NETPHANTOM_COPYRIGHT, NETPHANTOM_COPYRIGHT2, NETPHANTOM_VERSION, OBJEVENT_CHECK, OBJEVENT_CLICK, OBJEVENT_DBLCLICK, OBJEVENT_DEFOCUS, OBJEVENT_FOCUS, OBJEVENT_SELECT, OBJEVENT_USERCHANGE, PANELCREATE_APPPANEL, PANELCREATE_DANGLINGPANEL, PANELCREATE_DLGFRAME, PANELCREATE_EXTENDEDINFO, PANELCREATE_ICON, PANELCREATE_INDIVIDUALSIZE, PANELCREATE_POPUP, REPLYTYPE_CLIENTEXECUTE, REPLYTYPE_CLIPBOARD, REPLYTYPE_DDE, REPLYTYPE_FFONTLIST, REPLYTYPE_MESSAGEBOX, REPLYTYPE_REPORT, REPLYTYPE_SAVEPROPS, REPLYTYPE_TERMMARK, RPRT_CANCELPRINTJOB, RPRT_CLOSEPRINTJOB, RPRT_CONTPRINTJOB, RPRT_OPENPRINTJOB, RPRT_PRINTJOBCANCLD, RPRT_PRINTJOBCLOSED, RPRT_PRINTJOBCONT, RPRT_PRINTJOBOPENED, RPRT_PRINTJOBSTARTED, RPRT_STARTPRINTJOB, SELMODE_NORMAL, SELMODE_NOTALLOWED, SELMODE_REQUIRED, SELTYPE_MULTIPLE, SELTYPE_SINGLE, SEPARATOR, SEPARATORCHAR, TRANS_APPLICATIONCHANGE, TRANS_CALLOBJECT, TRANS_CANCELEXIT, TRANS_CLEARLOCK, TRANS_CLIENTEXECUTE, TRANS_CLIENTJARS, TRANS_CLIENTTEXTTABLE, TRANS_CLIENTUPDATED, TRANS_CLIENTUPDATEDNOLOCK, TRANS_CLIPBOARD, TRANS_CLIPBOARDCOMPONENT, TRANS_CLOSETERMINALWINDOW, TRANS_CONNECTIONREFUSED, TRANS_COUNTRYINFO, TRANS_CREATEPANEL, TRANS_CREATESESSION, TRANS_DDE, TRANS_DDEEVENT, TRANS_DDEEVENTREPLY, TRANS_DDEVAREVENT, TRANS_DISPLAYHELP, TRANS_DISPLAYTERMINAL, TRANS_DISPLAYTOOLTIPS, TRANS_ENDCONVERSATION, TRANS_EXIT, TRANS_FONTSUBSTITUTION, TRANS_HOSTCOLORTABLE, TRANS_HOSTPRINT, TRANS_HWND, TRANS_INACTIVESESSION, TRANS_INITIATE, TRANS_KEEPALIVE, TRANS_LOCALE, TRANS_LOGEVENT, TRANS_MESSAGEBOX, TRANS_MESSAGEBOXWITHREPLY, TRANS_MODALREPLY, TRANS_MULTTERM, TRANS_PING, TRANS_PRINTCOMPONENT, TRANS_PRINTPANEL, TRANS_PRINTREPORT, TRANS_PRTWINKEY, TRANS_RECONNECT, TRANS_REDIRECTION, TRANS_REMOVEPANELATLEVEL, TRANS_REMOVETERMINAL, TRANS_RENEGOTIATESSL, TRANS_REQUESTHELP, TRANS_RESOURCEURL, TRANS_SELECTSESSION, TRANS_SESSIONACTIVE, TRANS_SESSIONSELECTED, TRANS_SETCOLORS, TRANS_SETFOCUS, TRANS_SETLOCK, TRANS_SETPANELNESTLEVEL, TRANS_SETUPPARAMS, TRANS_SHOWDOCUMENT, TRANS_SOCKET, TRANS_SOUNDALARM, TRANS_STARTUPINFO, TRANS_STOPSESSION, TRANS_TERMINALDATA, TRANS_TERMINALUPDATE, TRANS_TERMINALWINDOW, TRANS_TERMWINTEXT, TRANS_UPDATEAPPLICATION, TRANS_UPDATEPANEL, TRANS_USEREXITPRTKEY, TRANSACTION_VERSION, TS_CLOSE, TS_DATA, TS_ERROR, TS_OPEN, VSIGN_MINUS, VSIGN_NONE, VSIGN_PLUSMINUS, YEARF_6DIG, YEARF_8DIG, YEARF_EXP8

Constructor Summary

Constructors

Constructor and Description
VirtualCUserWindow(VirtualPanel panel, PhantomCUserWindow data) The constructor of the control always calls the superclass.

Method Summary

Modifier and Type	Method and Description
boolean	areTextPromptsAlwaysRefreshed() If the class has a need to refresh the text prompt at all host changed, it must reply true to this method call.
boolean	callControl() "Calls" the control in question.
void	clientUpdated(Transaction trans) This method is called from the VirtualPanel to cause a client transaction to update the panels.
boolean	deleteAll() Deletes all lines in a list capable control.
boolean	deleteLine(int line) Deletes a line in a list capable control.
void	dispose() This method is called whenever a panel has been disposed of, in order to remove listeners, etc, in order to free up memory.
void	fireCreate(Transaction trans) This method fires the creation data transaction to the client.
void	fireUpdate(Transaction trans) This method is used to fire an update message to the client by a virtual class.
int	getBackgroundColor() Gets the background color of an item.
String	getCell(int col, int line) Gets a single cell in a list capable control.
se.entra.phantom.geditor.NPPColor	getColor() Get color of an item.
int	getFont() Gets the font index of an item.
int	getForegroundColor() Gets the foreground color of an item.
String	getId() Gets the ID of the user window.
int	getLength() Gets the control length.
String	getLine(int line) Sets a line in a list capable control.
int	getLineCount() Gets the line count for a list capable control.
int	getNextSelection(int line) Gets the next selected line in a list capable control.
VirtualUserWindowInterface	getPeer() Gets the peer of the user window, i.e.
Object	getProperty(String propertyName) Gets a property of a virtual component.
String	getText() Gets the text of an item.
void	hostScreenChanged(PhantomHostScreen screen) The connected host screen has changed.
boolean	insertLine(String data, int line) Inserts a line in a list capable control.
int	isChecked() Gets the check state of a control (e.g.
void	issueAction(Transaction trans) This method is invoked by the server kernel whenever a user window has issued an action on the client side.
void	refresh() This method is used to refresh all virtual controls when e.g.
void	refreshTextPrompts() This method is used to refresh all virtual controls when e.g.
boolean	selectField() Performs a visual selection of the field.
boolean	setBackgroundColor(int colorIndex) Sets the background color of an item.
boolean	setCell(int col, int line, String data) Sets a single cell in a list capable control.
boolean	setChecked(int state) Sets the check state of a control (e.g.
boolean	setColor(se.entra.phantom.geditor.NPPColor newcolor) Set the color of an item.
boolean	setEnabled(boolean state) Sets the enabled state of an item.
boolean	setFileFromList(PhantomOutputFile pFile) Insert the contents of a list into a file.
boolean	setFocus() Sets the focus to this control.
boolean	setFont(int font) Sets the font index of an item.
boolean	setForegroundColor(int colorIndex) Sets the foreground color of an item.
boolean	setLength(int length) Sets the control length.
boolean	setLine(String data, int line) Sets a line in a list capable control.
boolean	setListFromFile(String fileName) Sets the contents of a list capable control from a file.
boolean	setProperty(String propertyName, Object property) Sets a property of a virtual component.
boolean	setSelection(int line, boolean select) Sets a line as selected (or not) in a list capable control.
boolean	setText(String text) Sets the text of an item.
boolean	setVisible(boolean state) Sets the visibility state of an item.

Methods inherited from class se.entra.phantom.server.VirtualControl

appendCreateTransaction, appendFieldCheckTransaction, appendFontTransaction, appendUpdateTransaction, callObject, callObject, getBasicData, getClientSession, getComponentLockObject, getControlConnectedToHost, getControlID, getControlIDHostFieldID, getControlType, getCurrentHostSession, getExtraUpdateFlags, getHostField, getID, getIndex, getObject, getPanel, getPreviousConnectedControl, getSelectableControl, getTextData, getTooltipText, getVirtualSessionManager, hasChanged, isConnectToNextControlPropertySet, isDirectChecked, isEnabled, isNewGroup, issueControlAction, isTabSkipped, isVisible, parseRuntimeFont, refreshTextPrompts, requestFocus, setChanged, setFocus, setTooltipText, setupControlIDObject, setVirtualText, textFileChanged

Methods inherited from class java.lang.Object

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

Constructor Detail

VirtualCUserWindow

public VirtualCUserWindow(VirtualPanel panel,
                          PhantomCUserWindow data)

The constructor of the control always calls the superclass.

Method Detail

dispose

public void dispose()

This method is called whenever a panel has been disposed of, in order to remove listeners, etc, in order to free up memory. Normal controls doesn't need to do anything here.

Overrides:

dispose in class VirtualControl

getPeer

public VirtualUserWindowInterface getPeer()

Gets the peer of the user window, i.e. the server user window if it exists.

Returns:

null if it doesn't exist.

hostScreenChanged

public void hostScreenChanged(PhantomHostScreen screen)

The connected host screen has changed. This can cause a need to change the host screen for host fields.

Overrides:

hostScreenChanged in class VirtualControl

refresh

public void refresh()

This method is used to refresh all virtual controls when e.g. a new panel is created or when any host change occurs.

Specified by:

refresh in interface VirtualClientMessages

Overrides:

refresh in class VirtualControl

refreshTextPrompts

public void refreshTextPrompts()

This method is used to refresh all virtual controls when e.g. a new panel is created or recreated.

Specified by:

refreshTextPrompts in interface VirtualClientMessages

Overrides:

refreshTextPrompts in class VirtualControl

areTextPromptsAlwaysRefreshed

public boolean areTextPromptsAlwaysRefreshed()

If the class has a need to refresh the text prompt at all host changed, it must reply true to this method call. Otherwise return false.

A class extending VirtualControl have to override this method and return true if the text prompts need a constant refresh.

Specified by:

areTextPromptsAlwaysRefreshed in interface VirtualClientMessages

Overrides:

areTextPromptsAlwaysRefreshed in class VirtualControl

fireCreate

public void fireCreate(Transaction trans)

This method fires the creation data transaction to the client. The first thing must be to call the superclass.

Specified by:

fireCreate in interface VirtualClientMessages

Overrides:

fireCreate in class VirtualControl

fireUpdate

public void fireUpdate(Transaction trans)

This method is used to fire an update message to the client by a virtual class.

Specified by:

fireUpdate in interface VirtualClientMessages

Overrides:

fireUpdate in class VirtualControl

clientUpdated

public void clientUpdated(Transaction trans)

This method is called from the VirtualPanel to cause a client transaction to update the panels. This method provides the appropriate control behavior, matching the client request.

Specified by:

clientUpdated in class VirtualControl

Parameters:

trans - A transaction that is already being processed.

issueAction

public void issueAction(Transaction trans)

This method is invoked by the server kernel whenever a user window has issued an action on the client side. Every updateable control (in the VirtualNnnn classes) are set to reflect the changes made on the client side.

Specified by:

issueAction in class VirtualControl

Parameters:

trans - A transaction that is already being processed.

setProperty

public boolean setProperty(String propertyName,
                           Object property)

Sets a property of a virtual component.

Specified by:

setProperty in interface VirtualInterface

Overrides:

setProperty in class VirtualControl

Returns:

true for successful operation.
false for failure.

getProperty

public Object getProperty(String propertyName)

Gets a property of a virtual component.

Specified by:

getProperty in interface VirtualInterface

Overrides:

getProperty in class VirtualControl

Returns:

Object The object containing the property.
null for failure.

setText

public boolean setText(String text)

Sets the text of an item.

Specified by:

setText in interface VirtualInterface

Overrides:

setText in class VirtualControl

Returns:

true for successful operation.
false for failure.

getText

public String getText()

Gets the text of an item.

Specified by:

getText in interface VirtualInterface

Overrides:

getText in class VirtualControl

Returns:

null for no text support.

setFocus

public boolean setFocus()

Sets the focus to this control.

Specified by:

setFocus in interface VirtualInterface

Overrides:

setFocus in class VirtualControl

Returns:

false This version of the Server doesn't support focusable user window on the Server side.

setEnabled

public boolean setEnabled(boolean state)

Sets the enabled state of an item.

Specified by:

setEnabled in interface VirtualInterface

Overrides:

setEnabled in class VirtualControl

Returns:

true for successful operation.
false for failure.

setVisible

public boolean setVisible(boolean state)

Sets the visibility state of an item.

Specified by:

setVisible in interface VirtualInterface

Overrides:

setVisible in class VirtualControl

Returns:

true for successful operation.
false for failure.

setColor

public boolean setColor(se.entra.phantom.geditor.NPPColor newcolor)

Set the color of an item.

Specified by:

setColor in interface VirtualInterface

Overrides:

setColor in class VirtualControl

Returns:

false for failure.

getColor

public se.entra.phantom.geditor.NPPColor getColor()

Get color of an item.

Specified by:

getColor in interface VirtualInterface

Overrides:

getColor in class VirtualControl

Returns:

NPPColor foreground and background color of the item. null Failure.

setForegroundColor

public boolean setForegroundColor(int colorIndex)

Sets the foreground color of an item. See NPPColorItemManager for indexes.

Specified by:

setForegroundColor in interface VirtualInterface

Overrides:

setForegroundColor in class VirtualControl

Returns:

true for successful operation.
false for failure.

getForegroundColor

public int getForegroundColor()

Gets the foreground color of an item. See NPPColorItemManager for indexes.

Specified by:

getForegroundColor in interface VirtualInterface

Overrides:

getForegroundColor in class VirtualControl

Returns:

0-nn foreground color index.
-1 for failure.

setBackgroundColor

public boolean setBackgroundColor(int colorIndex)

Sets the background color of an item. See NPPColorItemManager for indexes.

Specified by:

setBackgroundColor in interface VirtualInterface

Overrides:

setBackgroundColor in class VirtualControl

Returns:

true for successful operation.
false for failure.

getBackgroundColor

public int getBackgroundColor()

Gets the background color of an item. See NPPColorItemManager for indexes.

Specified by:

getBackgroundColor in interface VirtualInterface

Overrides:

getBackgroundColor in class VirtualControl

Returns:

0-nn background color.
-1 for failure.

setFont

public boolean setFont(int font)

Sets the font index of an item.

Specified by:

setFont in interface VirtualInterface

Overrides:

setFont in class VirtualControl

Returns:

true for successful operation.
false for failure.

getFont

public int getFont()

Gets the font index of an item.

Specified by:

getFont in interface VirtualInterface

Overrides:

getFont in class VirtualControl

Returns:

0-nn font index.
-1 for failure.

selectField

public boolean selectField()

Performs a visual selection of the field. It is mainly used for entry capable controls.

Specified by:

selectField in interface VirtualInterface

Overrides:

selectField in class VirtualControl

Returns:

true for successful operation.
false for failure.

getLength

public int getLength()

Gets the control length. It is mainly used for entry capable controls.

Specified by:

getLength in interface VirtualInterface

Overrides:

getLength in class VirtualControl

Returns:

-1 for error (getLength not implemented for control)
0-nn control length.

setLength

public boolean setLength(int length)

Sets the control length. It is mainly used for entry capable controls that is not host connected.

Specified by:

setLength in interface VirtualInterface

Overrides:

setLength in class VirtualControl

Returns:

true for successful operation.
false for failure.

setChecked

public boolean setChecked(int state)

Sets the check state of a control (e.g. check box) or a menu item.

Specified by:

setChecked in interface VirtualInterface

Overrides:

setChecked in class VirtualControl

Returns:

true for successful operation.
false for failure.

isChecked

public int isChecked()

Gets the check state of a control (e.g. check box) or a menu item.

Specified by:

isChecked in interface VirtualInterface

Overrides:

isChecked in class VirtualControl

Returns:

0 item is unchecked.
1 item is checked.
2 item is in third state.
-1 for failure.

getLineCount

public int getLineCount()

Gets the line count for a list capable control.

Specified by:

getLineCount in interface VirtualInterface

Overrides:

getLineCount in class VirtualControl

Returns:

0-nn the count of lines.
-1 failure.

insertLine

public boolean insertLine(String data,
                          int line)

Inserts a line in a list capable control.

Specified by:

insertLine in interface VirtualInterface

Overrides:

insertLine in class VirtualControl

Returns:

true for successful operation.
false for failure.

setLine

public boolean setLine(String data,
                       int line)

Sets a line in a list capable control.

Specified by:

setLine in interface VirtualInterface

Overrides:

setLine in class VirtualControl

Returns:

true for successful operation.
false for failure.

getLine

public String getLine(int line)

Sets a line in a list capable control.

Specified by:

getLine in interface VirtualInterface

Overrides:

getLine in class VirtualControl

Returns:

null for failure, otherwise the string.

deleteLine

public boolean deleteLine(int line)

Deletes a line in a list capable control.

Specified by:

deleteLine in interface VirtualInterface

Overrides:

deleteLine in class VirtualControl

Returns:

true for successful operation.
false for failure.

deleteAll

public boolean deleteAll()

Deletes all lines in a list capable control.

Specified by:

deleteAll in interface VirtualInterface

Overrides:

deleteAll in class VirtualControl

Returns:

true for successful operation.
false for failure.

setCell

public boolean setCell(int col,
                       int line,
                       String data)

Sets a single cell in a list capable control.

Specified by:

setCell in interface VirtualInterface

Overrides:

setCell in class VirtualControl

Parameters:

col - The column for the cell.

line - The line for the column.

data - The data for the cell.

Returns:

True for successful operation
false for failure.

getCell

public String getCell(int col,
                      int line)

Gets a single cell in a list capable control.

Specified by:

getCell in interface VirtualInterface

Overrides:

getCell in class VirtualControl

Parameters:

col - The column for the cell.

line - The line for the column.

Returns:

The contents of the cell.

setSelection

public boolean setSelection(int line,
                            boolean select)

Sets a line as selected (or not) in a list capable control.

Specified by:

setSelection in interface VirtualInterface

Overrides:

setSelection in class VirtualControl

Returns:

true for successful operation.
false for failure.

getNextSelection

public int getNextSelection(int line)

Gets the next selected line in a list capable control.

Specified by:

getNextSelection in interface VirtualInterface

Overrides:

getNextSelection in class VirtualControl

Returns:

0-nn the next selected line.
-1 no more selected lines or failure.

setFileFromList

public boolean setFileFromList(PhantomOutputFile pFile)

Insert the contents of a list into a file. true for successful operation.
false for failure.

Specified by:

setFileFromList in interface VirtualInterface

Overrides:

setFileFromList in class VirtualControl

Returns:

true for successful operation.
false for failure.

setListFromFile

public boolean setListFromFile(String fileName)
                        throws IOException

Sets the contents of a list capable control from a file.

Specified by:

setListFromFile in interface VirtualInterface

Overrides:

setListFromFile in class VirtualControl

Parameters:

fileName - the file name.

Returns:

true for successful operation.
false for failure.

Throws:

IOException - for file failures.

callControl

public boolean callControl()

"Calls" the control in question. It is used by push buttons and menu items. When called, it generates a transaction to the client that causes it to update the server immediately. When this transaction is received, the control is "called", much like if the user had pressed and released the push button or selected the menu item.

Specified by:

callControl in interface VirtualInterface

Overrides:

callControl in class VirtualControl

Returns:

true for successful operation.
false the control doesn't support being "called".

getId

public String getId()

Gets the ID of the user window.