X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/cc81d32f2bf8c159f3b1bf6ddaf62e6d77720209..0bd2681966523df88ad5cf8e505b532843e58d74:/docs/latex/wx/sysopt.tex

diff --git a/docs/latex/wx/sysopt.tex b/docs/latex/wx/sysopt.tex
index d937268bdd..7078bd6fa5 100644
--- a/docs/latex/wx/sysopt.tex
+++ b/docs/latex/wx/sysopt.tex
@@ -1,20 +1,89 @@
 \section{\class{wxSystemOptions}}\label{wxsystemoptions}
 
-wxSystemOptions stores option/value pairs that wxWindows itself or
+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 wxWindows:
+These options are currently recognised by wxWidgets.
+
+\wxheading{Windows}
 
 \twocolwidtha{7cm}
 \begin{twocollist}\itemsep=0pt
 \twocolitem{{\bf Option}}{{\bf Value}}
 \twocolitem{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.
-}
+DC cacheing. By default, MaskBlt will be used where it is implemented by the operating system and driver.}
+\twocolitem{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.}
+\twocolitem{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.}
+\twocolitem{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).}
+\twocolitem{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).}
+\twocolitem{msw.display.directdraw}{If set to 1, use DirectDraw-based implementation of
+\helpref{wxDisplay}{wxdisplay}. By default the standard Win32 functions are
+used.}
+\twocolitem{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.}
+\end{twocollist}
+
+\wxheading{GTK}
+
+\twocolwidtha{7cm}
+\begin{twocollist}\itemsep=0pt
+\twocolitem{{\bf Option}}{{\bf Value}}
+\twocolitem{gtk.tlw.can-set-transparent}{\helpref{wxTopLevelWindow::CanSetTransparent()}{wxtoplevelwindowcansettransparent} 
+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.}
+\twocolitem{gtk.desktop}{This option can be set to override the default desktop
+environment determination. Supported values are \texttt{GNOME} and \texttt{KDE}.}
+\end{twocollist}
+
+\wxheading{Mac}
+
+\twocolwidtha{7cm}
+\begin{twocollist}\itemsep=0pt
+\twocolitem{{\bf Option}}{{\bf Value}}
+\twocolitem{mac.window-plain-transition}{If 1, uses a plainer transition when showing
+a window. You can also use the symbol wxMAC\_WINDOW\_PLAIN\_TRANSITION.}
+\twocolitem{window-default-variant}{The default variant used by windows (cast to integer from the wxWindowVariant enum).
+Also known as wxWINDOW\_DEFAULT\_VARIANT.}
+\twocolitem{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.}
+\end{twocollist}
+
+\wxheading{MGL}
+
+\twocolwidtha{7cm}
+\begin{twocollist}\itemsep=0pt
+\twocolitem{{\bf Option}}{{\bf Value}}
+\twocolitem{mgl.aa-threshold}{Set this integer option to point
+size below which fonts are not antialiased. Default: 10.}
+\twocolitem{mgl.screen-refresh}{Screen refresh rate in Hz.
+A reasonable default is used if not specified.}
+\end{twocollist}
+
+\wxheading{Motif}
+
+\twocolwidtha{7cm}
+\begin{twocollist}\itemsep=0pt
+\twocolitem{{\bf Option}}{{\bf Value}}
+\twocolitem{motif.largebuttons}{If 1, uses a bigger default size for wxButtons.}
 \end{twocollist}
 
 The compile-time option to include or exclude this functionality
@@ -30,42 +99,50 @@ is wxUSE\_SYSTEM\_OPTIONS.
 
 \latexignore{\rtfignore{\wxheading{Members}}}
 
-\membersection{wxSystemOptions::wxSystemOptions}
+
+\membersection{wxSystemOptions::wxSystemOptions}\label{wxsystemoptionsctor}
 
 \func{}{wxSystemOptions}{\void}
 
 Default constructor. You don't need to create an instance of wxSystemOptions
 since all of its functions are static.
 
+
 \membersection{wxSystemOptions::GetOption}\label{wxsystemoptionsgetoption}
 
 \constfunc{wxString}{GetOption}{\param{const wxString\&}{ name}}
 
 Gets an option. The function is case-insensitive to {\it name}.
 
+Returns empty string if the option hasn't been set.
+
 \wxheading{See also}
 
 \helpref{wxSystemOptions::SetOption}{wxsystemoptionssetoption},\rtfsp
 \helpref{wxSystemOptions::GetOptionInt}{wxsystemoptionsgetoptionint},\rtfsp
 \helpref{wxSystemOptions::HasOption}{wxsystemoptionshasoption}
 
+
 \membersection{wxSystemOptions::GetOptionInt}\label{wxsystemoptionsgetoptionint}
 
 \constfunc{int}{GetOptionInt}{\param{const wxString\&}{ name}}
 
 Gets an option as an integer. The function is case-insensitive to {\it name}.
 
+If the option hasn't been set, this function returns $0$.
+
 \wxheading{See also}
 
 \helpref{wxSystemOptions::SetOption}{wxsystemoptionssetoption},\rtfsp
 \helpref{wxSystemOptions::GetOption}{wxsystemoptionsgetoption},\rtfsp
 \helpref{wxSystemOptions::HasOption}{wxsystemoptionshasoption}
 
+
 \membersection{wxSystemOptions::HasOption}\label{wxsystemoptionshasoption}
 
 \constfunc{bool}{HasOption}{\param{const wxString\&}{ name}}
 
-Returns true if the given option is present. The function is case-insensitive to {\it name}.
+Returns \true if the given option is present. The function is case-insensitive to {\it name}.
 
 \wxheading{See also}
 
@@ -73,6 +150,17 @@ Returns true if the given option is present. The function is case-insensitive to
 \helpref{wxSystemOptions::GetOption}{wxsystemoptionsgetoption},\rtfsp
 \helpref{wxSystemOptions::GetOptionInt}{wxsystemoptionsgetoptionint}
 
+
+\membersection{wxSystemOptions::IsFalse}\label{wxsystemoptionsisfalse}
+
+\constfunc{bool}{IsFalse}{\param{const wxString\&}{ name}}
+
+Returns \true if the option with the given \arg{name} had been set to $0$
+value. This is mostly useful for boolean options for which you can't use
+\texttt{GetOptionInt(name) == 0} as this would also be true if the option
+hadn't been set at all.
+
+
 \membersection{wxSystemOptions::SetOption}\label{wxsystemoptionssetoption}
 
 \func{void}{SetOption}{\param{const wxString\&}{ name}, \param{const wxString\&}{ value}}