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

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 architecture bitness of this PlatformInfo instance.
`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() . None PlatformInfo(pid : PortId, tkMajor: int=-1, tkMinor: int=-1, id: OperatingSystemId=OS_UNKNOWN, osMajor: int=-1, osMinor: int=-1, bitness: Bitness=BITNESS_INVALID, endian: Endianness=ENDIAN_INVALID) . None

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.

Return type:: None

See also

Get

__init__ (self, pid : PortId, tkMajor: int=-1, tkMinor: int=-1, id: OperatingSystemId=OS_UNKNOWN, osMajor: int=-1, osMinor: int=-1, bitness: Bitness=BITNESS_INVALID, endian: Endianness=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)

Return type:

None

CheckOSVersion(self, major: int, minor: int, micro: int = 0)¶

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

Parameters:

major (int)
minor (int)
micro (int)

Return type:

bool

CheckToolkitVersion(self, major: int, minor: int, micro: int = 0)¶

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

Parameters:

major (int)
minor (int)
micro (int)

Return type:

bool

static Get()¶

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

Return type:: PlatformInfo

static GetArch(arch: str)¶

Parameters:: arch (string)
Return type:: wx.Architecture

Deprecated

Use GetBitness instead.

GetArchName(self)¶

Return type:: str

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

Added in version 4.1/wxWidgets-3.1.5.

GetBitnessName(self, *args, **kw)¶

Overloaded Implementations:

GetBitnessName (self)

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

Return type:: str

Added in version 4.1/wxWidgets-3.1.5.

GetBitnessName (bitness : Bitness)

Returns the name for the given Bitness enumeration value.

Parameters:: bitness (Bitness)
Return type:: str

Added in version 4.1/wxWidgets-3.1.5.

GetCpuArchitectureName(self)¶

Returns the CPU architecture name, if available.

Return type:: str

Added in version 4.1/wxWidgets-3.1.5.

GetDesktopEnvironment(self)¶

Returns the desktop environment associated with this PlatformInfo instance.

See wx.AppTraits.GetDesktopEnvironment for more info.

Return type:: str

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:: str

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:: str

Added in version 4.1/wxWidgets-3.1.6.

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

Added 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:: str

static GetOperatingSystemDirectory()¶

Returns the operating system directory.

See GetOSDirectory for more info.

Return type:: str

GetOperatingSystemFamilyName(self)¶

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

Return type:: str

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:: str

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:: str

GetPortIdShortName(self)¶

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

Return type:: str

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

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