X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/ae3c17b4013e80b99976c750c19fca47729517f6..b5fe7ca67bf3121959a0b5a59afd00c1708f2f03:/interface/wx/sysopt.h diff --git a/interface/wx/sysopt.h b/interface/wx/sysopt.h index 1c8286536a..ef436266b4 100644 --- a/interface/wx/sysopt.h +++ b/interface/wx/sysopt.h @@ -8,68 +8,171 @@ /** @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. - 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} - @category{misc} + @category{cfg} - @see wxSystemOptions::SetOption, wxSystemOptions::GetOptionInt, - wxSystemOptions::HasOption + @see wxSystemSettings */ 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(); /** - 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. - @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. - @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. */ - 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);