The Application Object


 

The application object controls the PL/B Automation Server. Once the PL/B Automation Server starts by creating either an application object or a program object or using the -automation command line, only the Quit method of the application object will terminate the PL/B Automation Server. This method will also terminate any program objects. Caution should be used.

 

The application object is created by using the ‘Plbwin.Application’ program identifier, or the {E7D59A65-6223-11d4-B417-0000B43D1661} class identifier. For environments that do not support events (i.e., ASP), the Plbwin.ProgramNE class must be used.

 

The application object supports the following properties and methods:

 

Property Name

Return Type

Description

Application

VT_DISPATCH

Returns the Application object; read-only.

FullName

VT_BSTR

Returns the file specification for the application, including path; read-only.

Name

VT_BSTR

Returns the name of the application; read-only.

Parent

VT_DISPATCH

Returns the Application object; read-only.

Visible

VT_BOOL

Sets or returns whether the application is visible to the user;read/write. The default is FALSE when the application is started with the /Automation command line switch.

 

Method Name

Return Type

Description

Quit

VT_EMPTY

Exits the application and terminates all running programs.

CreateProgram

VT_DISPATCH

Creates and returns a new program object.

 

 

See Also: Automation



Compiler and Runtime Options Introduction to the Automation Server The Program Object