82a16d7e5e
git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@30770 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
111 lines
3.9 KiB
TeX
111 lines
3.9 KiB
TeX
\section{\class{wxSystemOptions}}\label{wxsystemoptions}
|
|
|
|
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:
|
|
|
|
\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.
|
|
}
|
|
\twocolitem{msw.xp-tab-ok}{(wxMSW under Windows XP or later only) Some versions
|
|
of Windows XP don't render \helpref{wxNotebook}{wxnotebook} controls with tabs
|
|
not on the top of it correctly, so wxWidgets by default always uses
|
|
\texttt{wxTOP} style under XP. If you are sure that this problem will not be
|
|
present on your users machines, set this option to a non zero value to enable
|
|
tabs with non default orientation.}
|
|
\twocolitem{mgl.aa-threshold}{(wxMGL only) Set this integer option to point
|
|
size below which fonts are not antialiased. Default: 10.
|
|
}
|
|
\twocolitem{mgl.screen-refresh}{(wxMGL only) Screen refresh rate in Hz.
|
|
Reasonable default is used if not specified.
|
|
}
|
|
\end{twocollist}
|
|
|
|
The compile-time option to include or exclude this functionality
|
|
is wxUSE\_SYSTEM\_OPTIONS.
|
|
|
|
\wxheading{Derived from}
|
|
|
|
\helpref{wxObject}{wxobject}
|
|
|
|
\wxheading{Include files}
|
|
|
|
<wx/sysopt.h>
|
|
|
|
\latexignore{\rtfignore{\wxheading{Members}}}
|
|
|
|
|
|
\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}.
|
|
|
|
\wxheading{See also}
|
|
|
|
\helpref{wxSystemOptions::SetOption}{wxsystemoptionssetoption},\rtfsp
|
|
\helpref{wxSystemOptions::GetOption}{wxsystemoptionsgetoption},\rtfsp
|
|
\helpref{wxSystemOptions::GetOptionInt}{wxsystemoptionsgetoptionint}
|
|
|
|
|
|
\membersection{wxSystemOptions::SetOption}\label{wxsystemoptionssetoption}
|
|
|
|
\func{void}{SetOption}{\param{const wxString\&}{ name}, \param{const wxString\&}{ value}}
|
|
|
|
\func{void}{SetOption}{\param{const wxString\&}{ name}, \param{int}{ value}}
|
|
|
|
Sets an option. The function is case-insensitive to {\it name}.
|
|
|
|
\wxheading{See also}
|
|
|
|
\helpref{wxSystemOptions::GetOption}{wxsystemoptionsgetoption},\rtfsp
|
|
\helpref{wxSystemOptions::GetOptionInt}{wxsystemoptionsgetoptionint},\rtfsp
|
|
\helpref{wxSystemOptions::HasOption}{wxsystemoptionshasoption}
|
|
|