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

OSFixesRevision

Integer

The maintenance version of the operating system.

OSMajorRevision

Integer

The major version of the operating system. For example, this value would be 4 for Windows 95, 98, ME, and NT 4.x and 5 for Windows 2000, XP, or .NET.

OSMinorRevision

Integer

The point release of the operating system. For example, this value would be 0 for Windows NT 4.x and 2000, 1 for Windows XP, 2 for Windows .NET, and 5 for SunOS 5.5 (Solaris 5.5).

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.

NumberOfColors

LongLong

Number of colors on the screen.

ScreenHeight

Long

Height of the screen in pixels.

ScreenWidth

Long

Width of the screen in pixels.

OSType

OSTypes (enumerated)

Operating system or environment. For a complete list of OSType values, see the Enumerated tab of the Browser.

PBType

PBTypes (enumerated)

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

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.