Using the SashXB WindowApp Location

The WindowApp location allows you to write full-fledged applications that use DHTML and JavaScript to reder their interface. You can think of a WindowApp weblication as web page on steroids.

Registration information must be stored in the weblication's WDF file. Use the sash-wdf-editor to edit the WDF file (Look under the 'Actions' tab). WindowApp registration includes an HTML file (which will probably contain some Sash code) and the height and width of the desired window for the weblication.

For example, the Checkers weblication contains the following registration information:


<registration>
    <htmlfile>checkers.html</htmlfile>
    <width>400</width>
    <height>510</height>
</registration>

1. Sash.WindowApp

Properties
`boolean` IsMDIMode	Read-only boolean property that has a value of true if the weblication is a MDI and false otherwise. NOTE: This is always false.
`sashIMainWindow` MainWindow	Read-only property of type MainWindow; Use this to access your weblication's main window properties

2. Sash.WinApp.MainWindow

Event	Receiver prototype	Description
OnActivate	handler(`boolean` isActive)	Event invoked when the weblication is started.
OnClose	handler()	Event invoked when the user closes the weblication's main window.
OnMaximize	handler()	Event invoked when the weblication's main window is maximized. NOTE: Currently not implemented.
OnMinimize	handler()	Event invoked when the weblication's main window is minimized. NOTE: Currently not implemented.
OnRestore	handler()	Event invoked when the weblication's main window is restored to its normal size. NOTE: Currently not implemented.
OnSaveModified	handler()
OnSetForeGround	handler( ftpConnection, fileName)	Event invoked when the weblication's main window is restored to its normal size. NOTE: Currently not implemented.

Properties
`boolean` AlwaysOnTop	Boolean property which is true if the main window should "hover" above all other visible windows
`boolean` CaptionVisible	Boolean property which is true if the main window's title bar should be visible. NOTE: Currently not implemented.
`boolean` MaximizeBoxEnabled	Boolean property which is true if the main window has a Maximize box displayed on the title bar. NOTE: This is currently read-only.
`boolean` Maximized	Boolean property which is true if the main window is in its maximized state. NOTE: This is currently not supported.
`boolean` Minimized	Boolean property which is true if the main window is in its minimized state. NOTE: This is currently not supported (getting it always returns false and setting it is not implemented).
`boolean` ClientEdge	NOTE: This is currently not supported.
`boolean` Resizable	Boolean property which is true if the main window can be resized by the user
`boolean` StatusVisible	Boolean property which is true if the main window's status bar is visible
`boolean` Visible	Boolean property which is true if the main window is visible
`string` StatusText	String property that holds the status bar text
`string` TitleText	String property that holds the main window's title (caption)
`long` Height	Integer property that holds the main-window's height in pixels. Can be get or set.
`long` Width	Integer property that holds the main-window's width in pixels. Can be get or set.
`long` MinHeight	Integer property that holds the main-window's minimum allowed height in pixels
`long` MinWidth	Integer property that holds the main-window's minimum allowed width in pixels
`long` Top	Integer property that holds the main window's top-left corner Y position relative to the top of the screen
`long` Left	Integer property that holds the main window's top-left corner X position relative to the top of the screen
`readonly string` DataFileName	NOTE: This is currently not supported.
Methods
`void` Close()	Close the main window (same as if the user closed the window)
`void` SetForegroundWindow()	Set the window to be in the foreground.
`void` SetIcon(`string` iconLocation)	Read the icon specified by the file name iconLocation; This icon is visible in the task list of the Gnome Panel, and depending on the current theme may be visible in the weblication's title bar. Icon format is .xpm. NOTE: This is currently not supported.

Wing Yung, Stefan Atev

Last modified: Tue Jun 11 18:57:22 EDT 2002