Application object

AppName

String

Specifies the name of the Application object.

ClassDefinition

PowerObject

An object of type PowerObject containing information about the class definition of the object or control.

DDETimeOut

Integer

Not supported in PocketBuilder.

Specifies the number of seconds PowerBuilder acting as the DDE client waits before giving up when trying to communicate with a server via DDE (the default is 10 seconds).

DisplayName

String

User-readable name for your application. This name is displayed, for example, in OLE dialog boxes that show the application’s name. If you do not specify a value, the value of AppName is used for DisplayName.

DWMessageTitle

String

Specifies the title of the message box for any runtime DataWindow errors encountered in the application. If you change the value of this property in script, the new value will be recognized only for DataWindows created (or painted) after the new value is set.

FreeDBLibraries

Boolean

Not supported in PocketBuilder.Specifies if you want PowerBuilder to free database interface libraries upon disconnecting from the database. The default is FALSE (PowerBuilder does not free the libraries upon disconnecting).

MicroHelpDefault

String

Not supported in PocketBuilder.

Specifies the default text of the MicroHelp object (the MicroHelp text that displays when you initiate a PowerBuilder session). The default is Ready.

RightToLeft

Boolean

Not supported in PocketBuilder.

Specifies that characters should be displayed in right-to-left order in MessageBoxes displayed when you call the MessageBox function. The application must be running on an operating system that supports right-to-left display. Values are:

• TRUE – Message box text will display in right-to-left order. The text of the MessageBox buttons will only display in the language of the RightToLeft version of Windows (Arabic or Hebrew) if you are running a localized version of PowerBuilder. Otherwise, the text of the MessageBox buttons will display in English.

• FALSE – Characters display in left-to-right order

TodayBackColor

Long

Specifies the numeric value of the background color: -2 to 16,777,215. The default value assigns the standard Today background color and watermark. This color is listed as Windows Background on the Today Item page of the Application object Properties view.

TodayDisplayApp

String

Specifies an application to control the display of a PocketBuilder Today item.

TodayDisplayText

String

Specifies the text that displays in a PocketBuilder slot on the Today screen.

TodayOrder

Integer

Specifies the position in which the custom item will appear on the Today screen.

TodayName

String

Specifies the name for the Today item that is saved in the device registry. This property is read-only. It cannot be updated after initialization.

TodayRunApp

String

Specifies an application that the user launches by clicking a PocketBuilder Today item.

TodayTextColor

Long

Specifies the numeric value of the color used for text: -2 to 16,777,215. The default value assigns the standard Today text color. This color is listed as Windows Text on the Today Item page of the Application object Properties view.

ToolbarFrameTitle

String

Not supported in PocketBuilder.

Specifies the text that displays as the title for the FrameBar when it is floating.

ToolbarPopMenuText

String

Not supported in PocketBuilder.

Allows you to change the toolbar location text (Left, Top, Right, Bottom, Floating) in the Application’s toolbar pop-up menu. Specify the text as a comma-separated list of items.

ToolbarSheetTitle

String

Not supported in PocketBuilder.

Specifies the text that displays as the title for the SheetBar when it is floating.

ToolbarText

Boolean

Not supported in PocketBuilder.

Specifies whether the text associated with the items in the toolbar displays. Values are:

• TRUE – Text displays in toolbar bar

• FALSE – Text does not display in toolbar

ToolbarTips

Boolean

Not supported in PocketBuilder.

Specifies whether PowerTips display when text is not displayed on the buttons. Values are:

• TRUE – Power Tips are displayed

• FALSE – Power Tips are not displayed

ToolbarUserControl

Boolean

Not supported in PocketBuilder.

Specifies whether users can use the toolbar pop-up menu to hide or show the toolbars, move toolbars, or show text. Values are:

• TRUE – Users can use pop-up menu

• FALSE – Users cannot use pop-up menu

Close

When the user closes the application.

Idle

When the Idle function has been called in an Application object script and the specified number of seconds have elapsed with no mouse or keyboard activity.

Open

When the user runs the application.

SystemError

When a serious execution time error occurs (such as trying to open a nonexistent application). If there is no script for this event, PocketBuilder displays a message box with the PocketBuilder error number and error message text.

For information about error messages, see the User’s Guide.

ClassName

String

Returns the class of the Application object.

GetContextService

Integer

Creates a reference to a context-specific instance of the specified service.

GetParent

PowerObject

Returns a reference to the name of the parent object.

PostEvent

Boolean

Adds an event to the end of the message queue for the Application object.

SetLibraryList

Integer

Sets the PBD library list in an executable. This function can still be used but should be replaced by the system function SetLibraryList.

SetTransPool

Integer

Sets up a pool of database transactions for an application. SetTransPool allows you to minimize the overhead associated with database connections and also limit the total number of database connections permitted.

TodaySave

Integer

Saves changes to the Today item to the registry and refreshes the Today screen. Changes must be saved to the registry to ensure that they are reflected in the Today screen after a reboot.

TriggerEvent

Integer

Triggers a specified event in the Application object and executes the script for the event.

TypeOf

Object

Returns the type of the Application object.