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 section called “GetEnvironment” in PowerScript Reference.

Properties

Environment property

Datatype

Description

CharSet

CharSet (enumerated)

The international character set used by PowerBuilder. Values include:

  • CharSetAnsi!

  • CharSetUnicode!

  • CharSetDBCS!

  • CharSetDBCSJapanese!

The values CharSetAnsiArabic! and CharSetAnsiHebrew! are not valid choices in PowerBuilder 6 or later.

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.

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

LongLong

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 10 for Windows Server 2022/2019/2016 or Windows 11/10. For a complete list, see Operating System Version on MSDN.

OSMinorRevision

Integer

The point release of the operating system. For example, this value would be 0 for Windows 11/10 or Windows Server 2022/2019/2016. For a complete list, see Operating System Version on MSDN.

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 PowerBuilder.

PBFixesRevision

Integer

The maintenance version of PowerBuilder.

PBMajorRevision

Integer

The major version of PowerBuilder.

PBMinorRevision

Integer

The point release of PowerBuilder. 0 indicates GA, 1 indicates R2, and 2 indicates R3.

PBType

PBTypes (enumerated)

Version of the PowerBuilder product. For a complete list of PBType values, see the Enumerated tab of the Browser.

ProcessBitness

Integer

Identifies whether the application is a 32-bit or 64-bit process. Values are:

32 -- stands for 32-bit

64 -- stands for 64-bit

RuntimePath

String

The installation location of PowerBuilder Runtime that is currently used by the application.

ScreenHeight

Long

Height of the screen in pixels.

ScreenWidth

Long

Width of the screen in pixels.

ScreenX

Long

X-coordinate of the screen in pixels.

ScreenY

Long

Y-coordinate 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.