Chapter 2: System Object Properties, Events, and Functions

Environment object

The Environment object is a system structure used to hold information about the computing platform the PowerBuilder application is running on. You populate the Environment object using the GetEnvironment function.

The Environment object has no events.

For more information about the GetEnvironment function, see the PowerScript Reference.

Properties

Environment property	Datatype	Description
CharSet	CharSet (enumerated)	The international character set used by PocketBuilder. Values include: CharSetAnsi! CharSetUnicode! CharSetDBCS! CharSetDBCSJapanese!
ClassDefinition	PowerObject	An object of type PowerObject containing information about the class definition of the object or control.
CPUType	CPUTypes (enumerated)	The type of CPU. For a complete list of CPUTypes values, see the Enumerated tab of the Browser.
CurrentTrustMode	Integer	The assigned trust level of the process based on whether the certificat is a device’s privileged store. Values are: 1 – The operating system trusts the program to run, but restricts certain function calls such as making phone calls or updating the Subscriber Identity Module (SIM) 2 – The operating system trusts the program to perform any function calls
DeviceID	String	Unique value for the device hosting the operating system.
Language	LanguageID (enumerated)	Specifies the value of the language setting for the machine. For a complete list of LanguageID values, see the Enumerated tab of the Browser.
MachineCode	Boolean	Specifies whether the application executable is machine code (compiled). Values are: TRUE – Executable is machine code FALSE – Executable is not machine code (pseudo-code)
NumberOfColors	Long	Number of colors on the screen.
OSFixesRevision	Integer	The maintenance version of the operating system.
OSMajorRevision	Integer	The major version of the operating system. For example, this value would be 3 for Windows CE 2002 and 4 for Windows CE 2003. On the desktop, this value would be 5 for Windows 2000 or XP.
OSMinorRevision	Integer	The point release of the operating system. For example, this value would be 0 for Windows CE 2002 and 20 for Windows CE 2003. On the desktop, this value would be 1 for Windows XP and 2 for Windows .NET.
OSType	OSTypes (enumerated)	Operating system or environment. For a complete list of OSType values, see the Enumerated tab of the Browser.
PBBuildNumber	Integer	The build number of this version of PocketBuilder.
PBFixesRevision	Integer	The maintenance version of PocketBuilder.
PBMajorRevision	Integer	The major version of PocketBuilder.
PBMinorRevision	Integer	The point release of PocketBuilder.
PBType	PBTypes (enumerated)	Version of PocketBuilder product. For a complete list of PBType values, see the Enumerated tab of the Browser.
PhoneCapable	Boolean	Indicates whether the device is capable of using the phone system, but does not determine whether subscriptions or phone accounts are enabled.
ScreenHeight	Long	Height of the screen in pixels.
ScreenWidth	Long	Width of the screen in pixels.
Win16 (obsolete)	Boolean	Indicates the type of the operating system in which the application executable is running. Values are: TRUE – Executable is running under a 16-bit operating system FALSE – Executable is running under a 32-bit operating system

Functions

Environment function	Datatype returned	Description
ClassName	String	Returns the name assigned to the 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.
TypeOf	Object	Returns the type of the object.

View this book as PDF