wx.PlatformInformation

This class holds information about the operating system, the toolkit and the basic architecture bitness of the machine where the application is currently running.

This class does not only have getters for the information above, it also has setters. This allows you to e.g. save the current platform information in a data file (maybe in string form) so that when you later load it, you can easily retrieve (see the static getters for string.enum conversion functions) and store inside a PlatformInfo instance (using its setters) the signature of the system which generated it.

In general however you only need to use the static Get function and then access the various information for the current platform:

wx.LogMessage("This application is running under %s." % wx.PlatformInformation.Get().GetOperatingSystemIdName())

See also

wx.GetOsVersion , wx.IsPlatformLittleEndian , wx.IsPlatform64Bit , wx.AppTraits, Network, User and OS

Class Hierarchy

Inheritance diagram for class PlatformInformation:

Methods Summary

__init__	Initializes the instance with the values corresponding to the currently running platform.
CheckOSVersion	Returns True if the OS version is at least major.minor.micro .
CheckToolkitVersion	Returns True if the toolkit version is at least major.minor.micro .
Get	Returns the global PlatformInfo object, initialized with the values for the currently running platform.
GetArch
GetArchName
GetArchitecture
GetBitness	Returns the architecture bitness ID of this PlatformInfo instance.
GetBitnessName	Returns the name for the given Bitness enumeration value.
GetCpuArchitectureName	Returns the CPU architecture name, if available.
GetDesktopEnvironment	Returns the desktop environment associated with this PlatformInfo instance.
GetEndianness	Returns the endianness ID of this PlatformInfo instance.
GetEndiannessName	Returns the name for the endianness of this PlatformInfo instance.
GetLinuxDistributionInfo	Returns the Linux distribution info associated with this PlatformInfo instance.
GetNativeCpuArchitectureName	Returns the native CPU architecture name, if available.
GetOSMajorVersion	Returns the run-time major version of the OS associated with this PlatformInfo instance.
GetOSMicroVersion	Returns the run-time micro version of the OS associated with this PlatformInfo instance.
GetOSMinorVersion	Returns the run-time minor version of the OS associated with this PlatformInfo instance.
GetOperatingSystemDescription	Returns the description of the operating system of this PlatformInfo instance.
GetOperatingSystemDirectory	Returns the operating system directory.
GetOperatingSystemFamilyName	Returns the operating system family name of the OS associated with this PlatformInfo instance.
GetOperatingSystemId	Returns the operating system ID of this PlatformInfo instance.
GetOperatingSystemIdName	Returns the operating system name of the OS associated with this PlatformInfo instance.
GetPortId	Returns the wxWidgets port ID associated with this PlatformInfo instance.
GetPortIdName	Returns the name of the wxWidgets port ID associated with this PlatformInfo instance.
GetPortIdShortName	Returns the short name of the wxWidgets port ID associated with this PlatformInfo instance.
GetToolkitMajorVersion	Returns the run-time major version of the toolkit associated with this PlatformInfo instance.
GetToolkitMicroVersion	Returns the run-time micro version of the toolkit associated with this PlatformInfo instance.
GetToolkitMinorVersion	Returns the run-time minor version of the toolkit associated with this PlatformInfo instance.
IsOk	Returns True if this instance is fully initialized with valid values.
IsUsingUniversalWidgets	Returns True if this PlatformInfo describes wxUniversal build.
SetArchitecture
SetBitness	Sets the architecture bitness enum value associated with this PlatformInfo instance.
SetDesktopEnvironment	Sets the desktop environment associated with this PlatformInfo instance.
SetEndianness	Sets the endianness enum value associated with this PlatformInfo instance.
SetLinuxDistributionInfo	Sets the linux distribution info associated with this PlatformInfo instance.
SetOSVersion	Sets the version of the operating system associated with this PlatformInfo instance.
SetOperatingSystemDescription	Sets the operating system description associated with this PlatformInfo instance.
SetOperatingSystemId	Sets the operating system associated with this PlatformInfo instance.
SetPortId	Sets the wxWidgets port ID associated with this PlatformInfo instance.
SetToolkitVersion	Sets the version of the toolkit associated with this PlatformInfo instance.
__ne__	Inequality operator.
__eq__	Equality operator.

Properties Summary

ArchName	See GetArchName
Architecture	See GetArchitecture and SetArchitecture
Bitness	See GetBitness and SetBitness
BitnessName	See GetBitnessName
CpuArchitectureName	See GetCpuArchitectureName
DesktopEnvironment	See GetDesktopEnvironment and SetDesktopEnvironment
Endianness	See GetEndianness and SetEndianness
EndiannessName	See GetEndiannessName
LinuxDistributionInfo	See GetLinuxDistributionInfo and SetLinuxDistributionInfo
NativeCpuArchitectureName	See GetNativeCpuArchitectureName
OSMajorVersion	See GetOSMajorVersion
OSMicroVersion	See GetOSMicroVersion
OSMinorVersion	See GetOSMinorVersion
OperatingSystemDescription	See GetOperatingSystemDescription and SetOperatingSystemDescription
OperatingSystemFamilyName	See GetOperatingSystemFamilyName
OperatingSystemId	See GetOperatingSystemId and SetOperatingSystemId
OperatingSystemIdName	See GetOperatingSystemIdName
PortId	See GetPortId and SetPortId
PortIdName	See GetPortIdName
PortIdShortName	See GetPortIdShortName
ToolkitMajorVersion	See GetToolkitMajorVersion
ToolkitMicroVersion	See GetToolkitMicroVersion
ToolkitMinorVersion	See GetToolkitMinorVersion

Class API

class wx.PlatformInformation(object)

PlatformInfo() PlatformInfo(pid, tkMajor=-1, tkMinor=-1, id=OS_UNKNOWN, osMajor=-1, osMinor=-1, bitness=BITNESS_INVALID, endian=ENDIAN_INVALID)

This class holds information about the operating system, the toolkit and the basic architecture bitness of the machine where the application is currently running.

Methods

__init__(self, *args, **kw)

Overloaded Implementations:

---

__init__ (self)

Initializes the instance with the values corresponding to the currently running platform.

This is a fast operation because it only requires to copy the values internally cached for the currently running platform.

See also

Get

---

__init__ (self, pid, tkMajor=-1, tkMinor=-1, id=OS_UNKNOWN, osMajor=-1, osMinor=-1, bitness=BITNESS_INVALID, endian=ENDIAN_INVALID)

Initializes the object using given values.

Parameters

• pid (PortId) –

• tkMajor (int) –

• tkMinor (int) –

• id (OperatingSystemId) –

• osMajor (int) –

• osMinor (int) –

• bitness (Bitness) –

• endian (Endianness) –

---

---

CheckOSVersion(self, major, minor, micro=0)

Returns True if the OS version is at least major.minor.micro .

Parameters

• major (int) –

• minor (int) –

• micro (int) –

Return type

bool

See also

GetOSMajorVersion , GetOSMinorVersion , GetOSMicroVersion , CheckToolkitVersion

---

CheckToolkitVersion(self, major, minor, micro=0)

Returns True if the toolkit version is at least major.minor.micro .

Parameters

• major (int) –

• minor (int) –

• micro (int) –

Return type

bool

See also

GetToolkitMajorVersion , GetToolkitMinorVersion , GetToolkitMicroVersion , CheckOSVersion

---

static Get()

Returns the global PlatformInfo object, initialized with the values for the currently running platform.

Return type

PlatformInfo

---

static GetArch(arch)

Parameters

arch (string) –

Return type

wx.Architecture

Deprecated

Use GetBitness instead.

---

GetArchName(self)

Return type

string

Deprecated

Use GetBitnessName instead.

---

GetArchitecture(self)

Return type

wx.Architecture

Deprecated

Use GetBitness instead.

---

GetBitness(self)

Returns the architecture bitness ID of this PlatformInfo instance.

Return type

wx.Bitness

New in version 4.1/wxWidgets-3.1.5.

---

static GetBitnessName(*args, **kw)

Overloaded Implementations:

---

GetBitnessName (bitness)

Returns the name for the given Bitness enumeration value.

Parameters

bitness (Bitness) –

Return type

string

New in version 4.1/wxWidgets-3.1.5.

---

GetBitnessName (self)

Returns the name for the architecture bitness of this PlatformInfo instance.

Return type

string

New in version 4.1/wxWidgets-3.1.5.

---

---

GetCpuArchitectureName(self)

Returns the CPU architecture name, if available.

Return type

string

New in version 4.1/wxWidgets-3.1.5.

See also

wx.GetCpuArchitectureName , wx.GetNativeCpuArchitectureName

---

GetDesktopEnvironment(self)

Returns the desktop environment associated with this PlatformInfo instance.

See wx.AppTraits.GetDesktopEnvironment for more info.

Return type

string

---

GetEndianness(self)

Returns the endianness ID of this PlatformInfo instance.

Return type

wx.Endianness

---

GetEndiannessName(self)

Returns the name for the endianness of this PlatformInfo instance.

Return type

string

---

GetLinuxDistributionInfo(self)

Returns the Linux distribution info associated with this PlatformInfo instance.

See wx.GetLinuxDistributionInfo for more info.

Return type

wx.LinuxDistributionInfo

---

GetNativeCpuArchitectureName(self)

Returns the native CPU architecture name, if available.

Return type

string

New in version 4.1/wxWidgets-3.1.6.

See also

wx.GetNativeCpuArchitectureName , wx.GetCpuArchitectureName

---

GetOSMajorVersion(self)

Returns the run-time major version of the OS associated with this PlatformInfo instance.

Return type

int

See also

wx.GetOsVersion , CheckOSVersion

---

GetOSMicroVersion(self)

Returns the run-time micro version of the OS associated with this PlatformInfo instance.

Return type

int

New in version 4.1/wxWidgets-3.1.1.

See also

wx.GetOsVersion , CheckOSVersion

---

GetOSMinorVersion(self)

Returns the run-time minor version of the OS associated with this PlatformInfo instance.

Return type

int

See also

wx.GetOsVersion , CheckOSVersion

---

GetOperatingSystemDescription(self)

Returns the description of the operating system of this PlatformInfo instance.

See wx.GetOsDescription for more info.

Return type

string

---

static GetOperatingSystemDirectory()

Returns the operating system directory.

See GetOSDirectory for more info.

Return type

string

---

GetOperatingSystemFamilyName(self)

Returns the operating system family name of the OS associated with this PlatformInfo instance.

Return type

string

---

GetOperatingSystemId(self)

Returns the operating system ID of this PlatformInfo instance.

See wx.GetOsVersion for more info.

Return type

wx.OperatingSystemId

---

GetOperatingSystemIdName(self)

Returns the operating system name of the OS associated with this PlatformInfo instance.

Return type

string

---

GetPortId(self)

Returns the wxWidgets port ID associated with this PlatformInfo instance.

Return type

wx.PortId

---

GetPortIdName(self)

Returns the name of the wxWidgets port ID associated with this PlatformInfo instance.

Return type

string

---

GetPortIdShortName(self)

Returns the short name of the wxWidgets port ID associated with this PlatformInfo instance.

Return type

string

---

GetToolkitMajorVersion(self)

Returns the run-time major version of the toolkit associated with this PlatformInfo instance.

Note that if GetPortId returns PORT_BASE , then this value is zero (unless externally modified with SetToolkitVersion ); that is, no native toolkit is in use. See wx.AppTraits.GetToolkitVersion for more info.

Return type

int

See also

CheckToolkitVersion

---

GetToolkitMicroVersion(self)

Returns the run-time micro version of the toolkit associated with this PlatformInfo instance.

Note that if GetPortId returns PORT_BASE , then this value is zero (unless externally modified with SetToolkitVersion ); that is, no native toolkit is in use. See wx.AppTraits.GetToolkitVersion for more info.

Return type

int

New in version 4.1/wxWidgets-3.1.1.

See also

CheckToolkitVersion

---

GetToolkitMinorVersion(self)

Returns the run-time minor version of the toolkit associated with this PlatformInfo instance.

Note that if GetPortId returns PORT_BASE , then this value is zero (unless externally modified with SetToolkitVersion ); that is, no native toolkit is in use. See wx.AppTraits.GetToolkitVersion for more info.

Return type

int

See also

CheckToolkitVersion

---

IsOk(self)

Returns True if this instance is fully initialized with valid values.

Return type

bool

---

IsUsingUniversalWidgets(self)

Returns True if this PlatformInfo describes wxUniversal build.

Return type

bool

---

SetArchitecture(self, n)

Parameters

n (Architecture) –

Deprecated

Use SetBitness instead.

---

SetBitness(self, n)

Sets the architecture bitness enum value associated with this PlatformInfo instance.

Parameters

n (Bitness) –

New in version 4.1/wxWidgets-3.1.5.

---

SetDesktopEnvironment(self, de)

Sets the desktop environment associated with this PlatformInfo instance.

Parameters

de (string) –

---

SetEndianness(self, n)

Sets the endianness enum value associated with this PlatformInfo instance.

Parameters

n (Endianness) –

---

SetLinuxDistributionInfo(self, di)

Sets the linux distribution info associated with this PlatformInfo instance.

Parameters

di (wx.LinuxDistributionInfo) –

---

SetOSVersion(self, major, minor, micro=0)

Sets the version of the operating system associated with this PlatformInfo instance.

Parameters

• major (int) –

• minor (int) –

• micro (int) –

---

SetOperatingSystemDescription(self, desc)

Sets the operating system description associated with this PlatformInfo instance.

Parameters

desc (string) –

---

SetOperatingSystemId(self, n)

Sets the operating system associated with this PlatformInfo instance.

Parameters

n (OperatingSystemId) –

---

SetPortId(self, n)

Sets the wxWidgets port ID associated with this PlatformInfo instance.

Parameters

n (PortId) –

---

SetToolkitVersion(self, major, minor, micro=0)

Sets the version of the toolkit associated with this PlatformInfo instance.

Parameters

• major (int) –

• minor (int) –

• micro (int) –

---

__ne__(self)

Inequality operator.

Tests all class’ internal variables.

Parameters

t (PlatformInfo) –

---

__eq__(self)

Equality operator.

Tests all class’ internal variables.

Parameters

t (PlatformInfo) –

Properties

ArchName

See GetArchName

---

Architecture

See GetArchitecture and SetArchitecture

---

Bitness

See GetBitness and SetBitness

---

BitnessName

See GetBitnessName

---

CpuArchitectureName

See GetCpuArchitectureName

---

DesktopEnvironment

See GetDesktopEnvironment and SetDesktopEnvironment

---

Endianness

See GetEndianness and SetEndianness

---

EndiannessName

See GetEndiannessName

---

LinuxDistributionInfo

See GetLinuxDistributionInfo and SetLinuxDistributionInfo

---

NativeCpuArchitectureName

See GetNativeCpuArchitectureName

---

OSMajorVersion

See GetOSMajorVersion

---

OSMicroVersion

See GetOSMicroVersion

---

OSMinorVersion

See GetOSMinorVersion

---

OperatingSystemDescription

See GetOperatingSystemDescription and SetOperatingSystemDescription

---

OperatingSystemFamilyName

See GetOperatingSystemFamilyName

---

OperatingSystemId

See GetOperatingSystemId and SetOperatingSystemId

---

OperatingSystemIdName

See GetOperatingSystemIdName

---

PortId

See GetPortId and SetPortId

---

PortIdName

See GetPortIdName

---

PortIdShortName

See GetPortIdShortName

---

ToolkitMajorVersion

See GetToolkitMajorVersion

---

ToolkitMicroVersion

See GetToolkitMicroVersion

---

ToolkitMinorVersion

See GetToolkitMinorVersion