]> git.saurik.com Git - wxWidgets.git/blobdiff - interface/platinfo.h
documented that Freeze and Thaw are now recursive
[wxWidgets.git] / interface / platinfo.h
index 6f809ec28fef760d131f8b3f72392aa575957a3a..17101b23c4abfc643a0d2ebe6478add76571cd44 100644 (file)
@@ -1,6 +1,6 @@
 /////////////////////////////////////////////////////////////////////////////
 // Name:        platinfo.h
-// Purpose:     documentation for wxPlatformInfo class
+// Purpose:     interface of wxPlatformInfo
 // Author:      wxWidgets team
 // RCS-ID:      $Id$
 // Licence:     wxWindows license
@@ -9,17 +9,17 @@
 /**
     @class wxPlatformInfo
     @wxheader{platinfo.h}
-    
+
     This class holds informations about the operating system and the toolkit that
     the application
     is running under and some basic architecture info of the machine where it's
     running.
-    
+
     @library{wxbase}
     @category{FIXME}
-    
-    @seealso
-    wxGetOSVersion, wxIsPlatformLittleEndian, wxIsPlatform64Bit, wxAppTraits
+
+    @see wxGetOSVersion(), wxIsPlatformLittleEndian(), wxIsPlatform64Bit(),
+    wxAppTraits
 */
 class wxPlatformInfo : public wxObject
 {
@@ -29,38 +29,37 @@ public:
         Initializes the object using given values.
     */
     wxPlatformInfo();
-        wxPlatformInfo(wxPortId pid = wxPORT_UNKNOWN,
-                       int tkMajor = -1,
-                       int tkMinor = -1,
-                       wxOperatingSystemId id = wxOS_UNKNOWN,
-                       int osMajor = -1,
-                       int osMinor = -1,
-                       wxArchitecture arch = wxARCH_INVALID,
-                       wxEndianness endian = wxENDIAN_INVALID);
+    wxPlatformInfo(wxPortId pid = wxPORT_UNKNOWN,
+                   int tkMajor = -1,
+                   int tkMinor = -1,
+                   wxOperatingSystemId id = wxOS_UNKNOWN,
+                   int osMajor = -1,
+                   int osMinor = -1,
+                   wxArchitecture arch = wxARCH_INVALID,
+                   wxEndianness endian = wxENDIAN_INVALID);
     //@}
 
     /**
         Returns @true if the OS version is at least @c major.minor.
-        
-        @sa GetOSMajorVersion(), GetOSMinorVersion(),
-              CheckToolkitVersion()
+
+        @see GetOSMajorVersion(), GetOSMinorVersion(),
+             CheckToolkitVersion()
     */
-    bool CheckOSVersion(int major, int minor);
+    bool CheckOSVersion(int major, int minor) const;
 
     /**
         Returns @true if the toolkit version is at least @c major.minor.
-        
-        @sa GetToolkitMajorVersion(),
-              GetToolkitMinorVersion(),
-              CheckOSVersion()
+
+        @see GetToolkitMajorVersion(),
+             GetToolkitMinorVersion(), CheckOSVersion()
     */
-    bool CheckToolkitVersion(int major, int minor);
+    bool CheckToolkitVersion(int major, int minor) const;
 
     /**
         Returns the global wxPlatformInfo object, initialized with the values for the
         currently running platform.
     */
-#define static const wxPlatformInfo Get()     /* implementation is private */
+    static const wxPlatformInfo Get();
 
     /**
         Converts the given string to a wxArchitecture enum value or to
@@ -73,64 +72,64 @@ public:
     /**
         Returns the name for the architecture of this wxPlatformInfo instance.
     */
-    static wxString GetArchName(wxArchitecture arch);
-        wxString GetArchName();
+    static wxString GetArchName(wxArchitecture arch) const;
+    wxString GetArchName() const;
     //@}
 
     /**
         Returns the architecture ID of this wxPlatformInfo instance.
     */
-    wxArchitecture GetArchitecture();
+    wxArchitecture GetArchitecture() const;
 
     //@{
     /**
         Returns the endianness ID of this wxPlatformInfo instance.
     */
-    static wxEndianness GetEndianness(const wxString& end);
-        wxEndianness GetEndianness();
+    static wxEndianness GetEndianness(const wxString& end) const;
+    wxEndianness GetEndianness() const;
     //@}
 
     //@{
     /**
         Returns the name for the endianness of this wxPlatformInfo instance.
     */
-    static wxString GetEndiannessName(wxEndianness end);
-        wxString GetEndiannessName();
+    static wxString GetEndiannessName(wxEndianness end) const;
+    wxString GetEndiannessName() const;
     //@}
 
     /**
         Returns the run-time major version of the OS associated with this
         wxPlatformInfo instance.
-        See wxGetOsVersion for more info.
-        
-        @sa CheckOSVersion()
+        See wxGetOsVersion() for more info.
+
+        @see CheckOSVersion()
     */
-    int GetOSMajorVersion();
+    int GetOSMajorVersion() const;
 
     /**
         Returns the run-time minor version of the OS associated with this
         wxPlatformInfo instance.
-        See wxGetOsVersion for more info.
-        
-        @sa CheckOSVersion()
+        See wxGetOsVersion() for more info.
+
+        @see CheckOSVersion()
     */
-    int GetOSMinorVersion();
+    int GetOSMinorVersion() const;
 
     //@{
     /**
         Returns the operating system family name of the OS associated with this
         wxPlatformInfo instance.
     */
-    static wxString GetOperatingSystemFamilyName(wxOperatingSystemId os);
-        wxString GetOperatingSystemFamilyName();
+    static wxString GetOperatingSystemFamilyName(wxOperatingSystemId os) const;
+    wxString GetOperatingSystemFamilyName() const;
     //@}
 
     //@{
     /**
         Returns the operating system ID of this wxPlatformInfo instance.
     */
-    static wxOperatingSystemId GetOperatingSystemId(const wxString& name);
-        wxOperatingSystemId GetOperatingSystemId();
+    static wxOperatingSystemId GetOperatingSystemId(const wxString& name) const;
+    wxOperatingSystemId GetOperatingSystemId() const;
     //@}
 
     //@{
@@ -138,16 +137,16 @@ public:
         Returns the operating system name of the OS associated with this wxPlatformInfo
         instance.
     */
-    static wxString GetOperatingSystemIdName(wxOperatingSystemId os);
-        wxString GetOperatingSystemIdName();
+    static wxString GetOperatingSystemIdName(wxOperatingSystemId os) const;
+    wxString GetOperatingSystemIdName() const;
     //@}
 
     //@{
     /**
         Returns the wxWidgets port ID associated with this wxPlatformInfo instance.
     */
-    static wxPortId GetPortId(const wxString& portname);
-        wxPortId GetPortId();
+    static wxPortId GetPortId(const wxString& portname) const;
+    wxPortId GetPortId() const;
     //@}
 
     //@{
@@ -155,8 +154,8 @@ public:
         Returns the name of the wxWidgets port ID associated with this wxPlatformInfo
         instance.
     */
-    static wxString GetPortIdName(wxPortId port, bool usingUniversal);
-        wxString GetPortIdName();
+    static wxString GetPortIdName(wxPortId port, bool usingUniversal) const;
+    wxString GetPortIdName() const;
     //@}
 
     //@{
@@ -165,8 +164,8 @@ public:
         wxPlatformInfo instance.
     */
     static wxString GetPortIdShortName(wxPortId port,
-                                       bool usingUniversal);
-        wxString GetPortIdShortName();
+                                       bool usingUniversal) const;
+    wxString GetPortIdShortName() const;
     //@}
 
     /**
@@ -174,34 +173,32 @@ public:
         wxPlatformInfo instance.
         Note that if GetPortId() returns wxPORT_BASE, then this value is zero (unless
         externally modified with wxPlatformInfo::SetToolkitVersion); that is, no native toolkit is in use.
-        
         See wxAppTraits::GetToolkitVersion for more info.
-        
-        @sa CheckToolkitVersion()
+
+        @see CheckToolkitVersion()
     */
-    int GetToolkitMajorVersion();
+    int GetToolkitMajorVersion() const;
 
     /**
         Returns the run-time minor version of the toolkit associated with this
         wxPlatformInfo instance.
         Note that if GetPortId() returns wxPORT_BASE, then this value is zero (unless
         externally modified with wxPlatformInfo::SetToolkitVersion); that is, no native toolkit is in use.
-        
         See wxAppTraits::GetToolkitVersion for more info.
-        
-        @sa CheckToolkitVersion()
+
+        @see CheckToolkitVersion()
     */
-    int GetToolkitMinorVersion();
+    int GetToolkitMinorVersion() const;
 
     /**
         Returns @true if this instance is fully initialized with valid values.
     */
-#define bool IsOk()     /* implementation is private */
+    bool IsOk() const;
 
     /**
         Returns @true if this wxPlatformInfo describes wxUniversal build.
     */
-    bool IsUsingUniversalWidgets();
+    bool IsUsingUniversalWidgets() const;
 
     /**
         Sets the architecture enum value associated with this wxPlatformInfo instance.
@@ -237,10 +234,11 @@ public:
     /**
         Inequality operator. Tests all class' internal variables.
     */
-    bool operator!=(const wxPlatformInfo& t);
+    bool operator!=(const wxPlatformInfo& t) const;
 
     /**
         Equality operator. Tests all class' internal variables.
     */
-    bool operator==(const wxPlatformInfo& t);
+    bool operator==(const wxPlatformInfo& t) const;
 };
+