Removing more CodeWarrior project files.

[wxWidgets.git] / interface / wx / sysopt.h

diff --git a/interface/wx/sysopt.h b/interface/wx/sysopt.h
index 1c8286536aad34a06881a661105ebd4f406cde61..ef436266b4ac7edc0a5f73f4c9ed7ebb6d9a316f 100644 (file)
--- a/interface/wx/sysopt.h
+++ b/interface/wx/sysopt.h
@@ -8,68 +8,171 @@
 
 /**
     @class wxSystemOptions
 
 /**
     @class wxSystemOptions

-    @wxheader{sysopt.h}

 
     wxSystemOptions stores option/value pairs that wxWidgets itself or
     applications can use to alter behaviour at run-time. It can be
     used to optimize behaviour that doesn't deserve a distinct API,
     but is still important to be able to configure.
 
 
     wxSystemOptions stores option/value pairs that wxWidgets itself or
     applications can use to alter behaviour at run-time. It can be
     used to optimize behaviour that doesn't deserve a distinct API,
     but is still important to be able to configure.
 

-    These options are currently recognised by wxWidgets.
+    These options are currently recognised by wxWidgets:
+
+
+    @section sysopt_win Windows
+
+    @beginFlagTable
+    @flag{no-maskblt}
+        1 to never use WIN32's MaskBlt function, 0 to allow it to be used where possible.
+        Default: 0. In some circumstances the MaskBlt function can be slower than using
+        the fallback code, especially if using DC cacheing. By default, MaskBlt will be
+        used where it is implemented by the operating system and driver.
+    @flag{msw.remap}
+        If 1 (the default), wxToolBar bitmap colours will be remapped to the current
+        theme's values. Set this to 0 to disable this functionality, for example if
+        you're using more than 16 colours in your tool bitmaps.
+    @flag{msw.window.no-clip-children}
+        If 1, windows will not automatically get the WS_CLIPCHILDREN style.
+        This restores the way windows are refreshed back to the method used in
+        versions of wxWidgets earlier than 2.5.4, and for some complex window
+        hierarchies it can reduce apparent refresh delays.
+        You may still specify wxCLIP_CHILDREN for individual windows.
+    @flag{msw.notebook.themed-background}
+        If set to 0, globally disables themed backgrounds on notebook pages.
+        Note that this won't disable the theme on the actual notebook background
+        (noticeable only if there are no pages).
+    @flag{msw.staticbox.optimized-paint}
+        If set to 0, switches off optimized wxStaticBox painting.
+        Setting this to 0 causes more flicker, but allows applications to paint
+        graphics on the parent of a static box (the optimized refresh causes any
+        such drawing to disappear).
+    @flag{msw.display.directdraw}
+        If set to 1, use DirectDraw-based implementation of wxDisplay.
+        By default the standard Win32 functions are used.
+    @flag{msw.font.no-proof-quality}
+        If set to 1, use default fonts quality instead of proof quality when
+        creating fonts. With proof quality the fonts have slightly better
+        appearance but not all fonts are available in this quality,
+        e.g. the Terminal font in small sizes is not and this option may be
+        used if wider fonts selection is more important than higher quality.
+    @flag{wince.dialog.real-ok-cancel}
+        The PocketPC guidelines recommend for Ok/Cancel dialogs to use an OK button
+        located inside the caption bar and implement Cancel functionality through
+        Undo outside the dialog.
+        wxDialog::CreateButtonSizer will follow the native behaviour on WinCE but
+        it can be overridden with real wxButtons by setting the option below to 1.
+    @endFlagTable
+
+
+    @section sysopt_gtk GTK+
+
+    @beginFlagTable
+    @flag{gtk.tlw.can-set-transparent}
+        wxTopLevelWindow::CanSetTransparent() method normally tries to detect
+        automatically whether transparency for top level windows is currently
+        supported, however this may sometimes fail and this option allows to
+        override the automatic detection. Setting it to 1 makes the transparency
+        be always available (setting it can still fail, of course) and setting it
+        to 0 makes it always unavailable.
+    @flag{gtk.desktop}
+        This option can be set to override the default desktop environment
+        determination. Supported values are GNOME and KDE.
+    @flag{gtk.window.force-background-colour}
+        If 1, the backgrounds of windows with the wxBG_STYLE_COLOUR background
+        style are cleared forcibly instead of relying on the underlying GTK+
+        window colour. This works around a display problem when running
+        applications under KDE with the gtk-qt theme installed (0.6 and below).
+    @endFlagTable
+
+
+    @section sysopt_mac Mac
+
+    @beginFlagTable
+    @flag{mac.window-plain-transition}
+        If 1, uses a plainer transition when showing a window.
+        You can also use the symbol wxMAC_WINDOW_PLAIN_TRANSITION.
+    @flag{window-default-variant}
+        The default variant used by windows (cast to integer from the wxWindowVariant enum).
+        Also known as wxWINDOW_DEFAULT_VARIANT.
+    flag{mac.listctrl.always_use_generic}
+        Tells wxListCtrl to use the generic control even when it is capable of
+        using the native control instead. Also knwon as wxMAC_ALWAYS_USE_GENERIC_LISTCTRL.
+    flag{mac.textcontrol-use-spell-checker}
+        This option only has effect for Mac OS X 10.4 and higher.
+        If 1 activates the spell checking in wxTextCtrl.
+    @endFlagTable
+
+
+    @section sysopt_mgl MGL
+
+    @beginFlagTable
+    @flag{mgl.aa-threshold}
+        Set this integer option to point size below which fonts are not antialiased. Default: 10.
+    @flag{mgl.screen-refresh}
+        Screen refresh rate in Hz. A reasonable default is used if not specified.
+    @endFlagTable
+
+
+    @section sysopt_motif Motif
+
+    @beginFlagTable
+    @flag{motif.largebuttons}
+        If 1, uses a bigger default size for wxButtons.
+    @endFlagTable
+
+
+    The compile-time option to include or exclude this functionality is wxUSE_SYSTEM_OPTIONS.

 
     @library{wxbase}
 
     @library{wxbase}

-    @category{misc}
+    @category{cfg}

 
 

-    @see wxSystemOptions::SetOption, wxSystemOptions::GetOptionInt,
-    wxSystemOptions::HasOption
+    @see wxSystemSettings

 */
 class wxSystemOptions : public wxObject
 {
 public:
     /**
 */
 class wxSystemOptions : public wxObject
 {
 public:
     /**

-        Default constructor. You don't need to create an instance of wxSystemOptions
-        since all of its functions are static.
+        Default constructor.
+
+        You don't need to create an instance of wxSystemOptions since all
+        of its functions are static.

     */
     wxSystemOptions();
 
     /**
     */
     wxSystemOptions();
 
     /**

-        Gets an option. The function is case-insensitive to @e name.
+        Gets an option. The function is case-insensitive to @a name.

         Returns empty string if the option hasn't been set.
 
         Returns empty string if the option hasn't been set.
 

-        @see SetOption(), GetOptionInt(),
-             HasOption()
+        @see SetOption(), GetOptionInt(), HasOption()

     */
     */

-    wxString GetOption(const wxString& name) const;
+    static wxString GetOption(const wxString& name);

 
     /**
 
     /**

-        Gets an option as an integer. The function is case-insensitive to @e name.
+        Gets an option as an integer. The function is case-insensitive to @a name.

         If the option hasn't been set, this function returns 0.
 
         If the option hasn't been set, this function returns 0.
 

-        @see SetOption(), GetOption(),
-             HasOption()
+        @see SetOption(), GetOption(), HasOption()

     */
     */

-    int GetOptionInt(const wxString& name) const;
+    static int GetOptionInt(const wxString& name);

 
     /**
 
     /**

-        Returns @true if the given option is present. The function is
-        case-insensitive to @e name.
+        Returns @true if the given option is present.
+        The function is case-insensitive to @a name.

 
 

-        @see SetOption(), GetOption(),
-             GetOptionInt()
+        @see SetOption(), GetOption(), GetOptionInt()

     */
     */

-    bool HasOption(const wxString& name) const;
+    static bool HasOption(const wxString& name);

 
     /**
 
     /**

-        Returns @true if the option with the given @a name had been set to 0
-        value. This is mostly useful for boolean options for which you can't use
+        Returns @true if the option with the given @a name had been set to 0 value.
+
+        This is mostly useful for boolean options for which you can't use

         @c GetOptionInt(name) == 0 as this would also be @true if the option
         hadn't been set at all.
     */
         @c GetOptionInt(name) == 0 as this would also be @true if the option
         hadn't been set at all.
     */

-    bool IsFalse(const wxString& name) const;
+    static bool IsFalse(const wxString& name);

 
     //@{
     /**
 
     //@{
     /**

-        Sets an option. The function is case-insensitive to @e name.
+        Sets an option. The function is case-insensitive to @a name.

     */
     void SetOption(const wxString& name, const wxString& value);
     void SetOption(const wxString& name, int value);
     */
     void SetOption(const wxString& name, const wxString& value);
     void SetOption(const wxString& name, int value);