AppHolder Hosting (WsTabPageHosting)

This is an application holder tab page class. The page includes an ActiveX control that supports the use of nested applications. The Repository for nested applications is the same as for general applications.

Note: In order to determine the connection between the nested application and tab, it is necessary to get the handle to the Application owner window (the ActiveX), and then search in the Workspace Tab Ctrl for the relevant tab according to the given handle.

The following API returns if the window is part of a nested application inside Application Holder ActiveX. This API is implemented for all kind of applications (coverages).

bool IsNested()

Property

Description

String HostingId

Gets Jacada:Hosting id.

int Handle

Gets ActiveX window handle.

string ExeName

Gets executable name for nested application in JacadaHosting page.

string WorkingDir

Gets working directory for nested application in JacadaHosting page.

string Arguments

Gets arguments for nested application in JacadaHosting page.

 

Method

Description

Parameters

Return Value

int RunApplication(string fullPath, string workingDir, string arguments)

Runs the nested application inside the ActiveX

•string fullPath: Full path of the application

•string workingDir: Working directory of the application

•string arguments: Application arguments

If the function succeeds, returns the application process id. Otherwise, returns zero.

bool IsApplications
Running()

Checks whether there are running nested applications

 

•true: At least one application is running.

•false: There are no running applications.

void CloseApplications()

Terminates processes

 

 

bool Scroll(ScrollOrientation Orientation, ScrollEventType ScrollType, int   repeat)

Moves a scrollbar in a given direction by a given number of positions

•ScrollOrientation Orientation: Specifies the scroll bar orientation. (HorizontalScroll, VerticalScroll)

•ScrollEventType  ScrollType: Specifies the scrollbar action type. Can be one of the following:

oFirst: Move to minimum position.

oLast: Move to maximum position.

oSmallDecrement: Move small distance by pressing the top or left arrow key.

oSmallIncrement: Move small distance by pressing the right or bottom arrow key.

oLargeDecrement: Move large distance by pressing the PgUp key.

oLargeIncrement: Move large distance by pressing the PgDn key.

•int repeat: The repeat amount of the operation.