[wxWidgets.git] / docs / latex / wx / settings.tex

\section{\class{wxSystemSettings}}\label{wxsystemsettings}

wxSystemSettings allows the application to ask for details about
the system. This can include settings such as standard colours, fonts,
and user interface element sizes.

\wxheading{Derived from}

\helpref{wxObject}{wxobject}

\wxheading{Include files}

<wx/settings.h>

\wxheading{See also}

\helpref{wxFont}{wxfont}, \helpref{wxColour}{wxcolour}

\latexignore{\rtfignore{\wxheading{Members}}}

\membersection{wxSystemSettings::wxSystemSettings}

\func{}{wxSystemSettings}{\void}

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

\membersection{wxSystemSettings::GetSystemColour}\label{wxsystemsettingsgetsystemcolour}

\func{static wxColour}{GetSystemColour}{\param{int}{ index}}

Returns a system colour.

{\it index} can be one of:

\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf wxSYS\_COLOUR\_SCROLLBAR}}{The scrollbar grey area.}
\twocolitem{{\bf wxSYS\_COLOUR\_BACKGROUND}}{The desktop colour.}
\twocolitem{{\bf wxSYS\_COLOUR\_ACTIVECAPTION}}{Active window caption.}
\twocolitem{{\bf wxSYS\_COLOUR\_INACTIVECAPTION}}{Inactive window caption.}
\twocolitem{{\bf wxSYS\_COLOUR\_MENU}}{Menu background.}
\twocolitem{{\bf wxSYS\_COLOUR\_WINDOW}}{Window background.}
\twocolitem{{\bf wxSYS\_COLOUR\_WINDOWFRAME}}{Window frame.}
\twocolitem{{\bf wxSYS\_COLOUR\_MENUTEXT}}{Menu text.}
\twocolitem{{\bf wxSYS\_COLOUR\_WINDOWTEXT}}{Text in windows.}
\twocolitem{{\bf wxSYS\_COLOUR\_CAPTIONTEXT}}{Text in caption, size box and scrollbar arrow box.}
\twocolitem{{\bf wxSYS\_COLOUR\_ACTIVEBORDER}}{Active window border.}
\twocolitem{{\bf wxSYS\_COLOUR\_INACTIVEBORDER}}{Inactive window border.}
\twocolitem{{\bf wxSYS\_COLOUR\_APPWORKSPACE}}{Background colour MDI applications.}
\twocolitem{{\bf wxSYS\_COLOUR\_HIGHLIGHT}}{Item(s) selected in a control.}
\twocolitem{{\bf wxSYS\_COLOUR\_HIGHLIGHTTEXT}}{Text of item(s) selected in a control.}
\twocolitem{{\bf wxSYS\_COLOUR\_BTNFACE}}{Face shading on push buttons.}
\twocolitem{{\bf wxSYS\_COLOUR\_BTNSHADOW}}{Edge shading on push buttons.}
\twocolitem{{\bf wxSYS\_COLOUR\_GRAYTEXT}}{Greyed (disabled) text.}
\twocolitem{{\bf wxSYS\_COLOUR\_BTNTEXT}}{Text on push buttons.}
\twocolitem{{\bf wxSYS\_COLOUR\_INACTIVECAPTIONTEXT}}{Colour of text in active captions.}
\twocolitem{{\bf wxSYS\_COLOUR\_BTNHIGHLIGHT}}{Highlight colour for buttons (same as wxSYS\_COLOUR\_3DHILIGHT).}
\twocolitem{{\bf wxSYS\_COLOUR\_3DDKSHADOW}}{Dark shadow for three-dimensional dispaly elements.}
\twocolitem{{\bf wxSYS\_COLOUR\_3DLIGHT}}{Light colour for three-dimensional display elements.}
\twocolitem{{\bf wxSYS\_COLOUR\_INFOTEXT}}{Text colour for tooltip controls.}
\twocolitem{{\bf wxSYS\_COLOUR\_INFOBK}}{Background colour for tooltip controls.}
\twocolitem{{\bf wxSYS\_COLOUR\_DESKTOP}}{Same as wxSYS\_COLOUR\_BACKGROUND.}
\twocolitem{{\bf wxSYS\_COLOUR\_3DFACE}}{Same as wxSYS\_COLOUR\_BTNFACE.}
\twocolitem{{\bf wxSYS\_COLOUR\_3DSHADOW}}{Same as wxSYS\_COLOUR\_BTNSHADOW.}
\twocolitem{{\bf wxSYS\_COLOUR\_3DHIGHLIGHT}}{Same as wxSYS\_COLOUR\_BTNHIGHLIGHT.}
\twocolitem{{\bf wxSYS\_COLOUR\_3DHILIGHT}}{Same as wxSYS\_COLOUR\_BTNHIGHLIGHT.}
\twocolitem{{\bf wxSYS\_COLOUR\_BTNHILIGHT}}{Same as wxSYS\_COLOUR\_BTNHIGHLIGHT.}
\end{twocollist}

\membersection{wxSystemSettings::GetSystemFont}\label{wxsystemsettingsgetsystemfont}

\func{static wxFont}{GetSystemFont}{\param{int}{ index}}

Returns a system font.

{\it index} can be one of:

\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf wxSYS\_OEM\_FIXED\_FONT}}{Original equipment manufacturer dependent fixed-pitch font.}
\twocolitem{{\bf wxSYS\_ANSI\_FIXED\_FONT}}{Windows fixed-pitch font.}
\twocolitem{{\bf wxSYS\_ANSI\_VAR\_FONT}}{Windows variable-pitch (proportional) font.}
\twocolitem{{\bf wxSYS\_SYSTEM\_FONT}}{System font.}
\twocolitem{{\bf wxSYS\_DEVICE\_DEFAULT\_FONT}}{Device-dependent font (Windows NT only).}
\twocolitem{{\bf wxSYS\_DEFAULT\_GUI\_FONT}}{Default font for user interface objects such as menus and dialog boxes.
Not available in versions of Windows earlier than Windows 95 or Windows NT 4.0.}
\end{twocollist}

\membersection{wxSystemSettings::GetSystemMetric}\label{wxsystemsettingsgetsystemmetric}

\func{static int}{GetSystemMetric}{\param{int}{ index}}

Returns a system metric.

{\it index} can be one of:

\twocolwidtha{7cm}
\begin{twocollist}\itemsep=0pt
\twocolitem{{\bf wxSYS\_MOUSE\_BUTTONS}}{Number of buttons on mouse, or zero if no mouse was installed.}
\twocolitem{{\bf wxSYS\_BORDER\_X}}{Width of single border.}
\twocolitem{{\bf wxSYS\_BORDER\_Y}}{Height of single border.}
\twocolitem{{\bf wxSYS\_CURSOR\_X}}{Width of cursor.}
\twocolitem{{\bf wxSYS\_CURSOR\_Y}}{Height of cursor.}
\twocolitem{{\bf wxSYS\_DCLICK\_X}}{Width in pixels of rectangle within which two successive mouse
clicks must fall to generate a double-click.}
\twocolitem{{\bf wxSYS\_DCLICK\_Y}}{Height in pixels of rectangle within which two successive mouse
clicks must fall to generate a double-click.}
\twocolitem{{\bf wxSYS\_DRAG\_X}}{Width in pixels of a rectangle centered on a drag point
to allow for limited movement of the mouse pointer before a drag operation begins.}
\twocolitem{{\bf wxSYS\_DRAG\_Y}}{Height in pixels of a rectangle centered on a drag point
to allow for limited movement of the mouse pointer before a drag operation begins.}
\twocolitem{{\bf wxSYS\_EDGE\_X}}{Width of a 3D border, in pixels. }
\twocolitem{{\bf wxSYS\_EDGE\_Y}}{Height of a 3D border, in pixels. }
\twocolitem{{\bf wxSYS\_HSCROLL\_ARROW\_X}}{Width of arrow bitmap on horizontal scrollbar.}
\twocolitem{{\bf wxSYS\_HSCROLL\_ARROW\_Y}}{Height of arrow bitmap on horizontal scrollbar.}
\twocolitem{{\bf wxSYS\_HTHUMB\_X}}{Width of horizontal scrollbar thumb.}
\twocolitem{{\bf wxSYS\_ICON\_X}}{The default width of an icon.}
\twocolitem{{\bf wxSYS\_ICON\_Y}}{The default height of an icon.}
\twocolitem{{\bf wxSYS\_ICONSPACING\_X}}{Width of a grid cell for items in large icon view,
in pixels. Each item fits into a rectangle of this size when arranged.}
\twocolitem{{\bf wxSYS\_ICONSPACING\_Y}}{Height of a grid cell for items in large icon view,
in pixels. Each item fits into a rectangle of this size when arranged.}
\twocolitem{{\bf wxSYS\_WINDOWMIN\_X}}{Minimum width of a window.}
\twocolitem{{\bf wxSYS\_WINDOWMIN\_Y}}{Minimum height of a window.}
\twocolitem{{\bf wxSYS\_SCREEN\_X}}{Width of the screen in pixels.}
\twocolitem{{\bf wxSYS\_SCREEN\_Y}}{Height of the screen in pixels.}
\twocolitem{{\bf wxSYS\_FRAMESIZE\_X}}{Width of the window frame for a wxTHICK\_FRAME window.}
\twocolitem{{\bf wxSYS\_FRAMESIZE\_Y}}{Height of the window frame for a wxTHICK\_FRAME window.}
\twocolitem{{\bf wxSYS\_SMALLICON\_X}}{Recommended width of a small icon (in window captions, and small icon view).}
\twocolitem{{\bf wxSYS\_SMALLICON\_Y}}{Recommended height of a small icon (in window captions, and small icon view).}
\twocolitem{{\bf wxSYS\_HSCROLL\_Y}}{Height of horizontal scrollbar in pixels.}
\twocolitem{{\bf wxSYS\_VSCROLL\_X}}{Width of vertical scrollbar in pixels.}
\twocolitem{{\bf wxSYS\_VSCROLL\_ARROW\_X}}{Width of arrow bitmap on a vertical scrollbar.}
\twocolitem{{\bf wxSYS\_VSCROLL\_ARROW\_Y}}{Height of arrow bitmap on a vertical scrollbar.}
\twocolitem{{\bf wxSYS\_VTHUMB\_Y}}{Height of vertical scrollbar thumb.}
\twocolitem{{\bf wxSYS\_CAPTION\_Y}}{Height of normal caption area.}
\twocolitem{{\bf wxSYS\_MENU\_Y}}{Height of single-line menu bar.}
\twocolitem{{\bf wxSYS\_NETWORK\_PRESENT}}{1 if there is a network present, 0 otherwise.}
\twocolitem{{\bf wxSYS\_PENWINDOWS\_PRESENT}}{1 if PenWindows is installed, 0 otherwise.}
\twocolitem{{\bf wxSYS\_SHOW\_SOUNDS}}{Non-zero if the user requires an application to present information visually in situations
where it would otherwise present the information only in audible form; zero otherwise.}
\twocolitem{{\bf wxSYS\_SWAP\_BUTTONS}}{Non-zero if the meanings of the left and right mouse buttons are swapped; zero otherwise.}
\end{twocollist}
Commit	Line	Data
a660d684 KB	1	\section{\class{wxSystemSettings}}\label{wxsystemsettings}
	2
	3	wxSystemSettings allows the application to ask for details about
	4	the system. This can include settings such as standard colours, fonts,
	5	and user interface element sizes.
	6
	7	\wxheading{Derived from}
	8
	9	\helpref{wxObject}{wxobject}
	10
954b8ae6 JS	11	\wxheading{Include files}
	12
	13	<wx/settings.h>
	14
a660d684 KB	15	\wxheading{See also}
	16
	17	\helpref{wxFont}{wxfont}, \helpref{wxColour}{wxcolour}
	18
	19	\latexignore{\rtfignore{\wxheading{Members}}}
	20
	21	\membersection{wxSystemSettings::wxSystemSettings}
	22
	23	\func{}{wxSystemSettings}{\void}
	24
	25	Default constructor. You don't need to create an instance of wxSystemSettings
	26	since all of its functions are static.
	27
	28	\membersection{wxSystemSettings::GetSystemColour}\label{wxsystemsettingsgetsystemcolour}
	29
	30	\func{static wxColour}{GetSystemColour}{\param{int}{ index}}
	31
	32	Returns a system colour.
	33
	34	{\it index} can be one of:
	35
	36	\twocolwidtha{7cm}
	37	\begin{twocollist}\itemsep=0pt
	38	\twocolitem{{\bf wxSYS\_COLOUR\_SCROLLBAR}}{The scrollbar grey area.}
	39	\twocolitem{{\bf wxSYS\_COLOUR\_BACKGROUND}}{The desktop colour.}
	40	\twocolitem{{\bf wxSYS\_COLOUR\_ACTIVECAPTION}}{Active window caption.}
	41	\twocolitem{{\bf wxSYS\_COLOUR\_INACTIVECAPTION}}{Inactive window caption.}
	42	\twocolitem{{\bf wxSYS\_COLOUR\_MENU}}{Menu background.}
	43	\twocolitem{{\bf wxSYS\_COLOUR\_WINDOW}}{Window background.}
	44	\twocolitem{{\bf wxSYS\_COLOUR\_WINDOWFRAME}}{Window frame.}
	45	\twocolitem{{\bf wxSYS\_COLOUR\_MENUTEXT}}{Menu text.}
	46	\twocolitem{{\bf wxSYS\_COLOUR\_WINDOWTEXT}}{Text in windows.}
	47	\twocolitem{{\bf wxSYS\_COLOUR\_CAPTIONTEXT}}{Text in caption, size box and scrollbar arrow box.}
	48	\twocolitem{{\bf wxSYS\_COLOUR\_ACTIVEBORDER}}{Active window border.}
	49	\twocolitem{{\bf wxSYS\_COLOUR\_INACTIVEBORDER}}{Inactive window border.}
	50	\twocolitem{{\bf wxSYS\_COLOUR\_APPWORKSPACE}}{Background colour MDI applications.}
	51	\twocolitem{{\bf wxSYS\_COLOUR\_HIGHLIGHT}}{Item(s) selected in a control.}
	52	\twocolitem{{\bf wxSYS\_COLOUR\_HIGHLIGHTTEXT}}{Text of item(s) selected in a control.}
	53	\twocolitem{{\bf wxSYS\_COLOUR\_BTNFACE}}{Face shading on push buttons.}
	54	\twocolitem{{\bf wxSYS\_COLOUR\_BTNSHADOW}}{Edge shading on push buttons.}
	55	\twocolitem{{\bf wxSYS\_COLOUR\_GRAYTEXT}}{Greyed (disabled) text.}
	56	\twocolitem{{\bf wxSYS\_COLOUR\_BTNTEXT}}{Text on push buttons.}
	57	\twocolitem{{\bf wxSYS\_COLOUR\_INACTIVECAPTIONTEXT}}{Colour of text in active captions.}
	58	\twocolitem{{\bf wxSYS\_COLOUR\_BTNHIGHLIGHT}}{Highlight colour for buttons (same as wxSYS\_COLOUR\_3DHILIGHT).}
	59	\twocolitem{{\bf wxSYS\_COLOUR\_3DDKSHADOW}}{Dark shadow for three-dimensional dispaly elements.}
	60	\twocolitem{{\bf wxSYS\_COLOUR\_3DLIGHT}}{Light colour for three-dimensional display elements.}
	61	\twocolitem{{\bf wxSYS\_COLOUR\_INFOTEXT}}{Text colour for tooltip controls.}
	62	\twocolitem{{\bf wxSYS\_COLOUR\_INFOBK}}{Background colour for tooltip controls.}
	63	\twocolitem{{\bf wxSYS\_COLOUR\_DESKTOP}}{Same as wxSYS\_COLOUR\_BACKGROUND.}
	64	\twocolitem{{\bf wxSYS\_COLOUR\_3DFACE}}{Same as wxSYS\_COLOUR\_BTNFACE.}
	65	\twocolitem{{\bf wxSYS\_COLOUR\_3DSHADOW}}{Same as wxSYS\_COLOUR\_BTNSHADOW.}
	66	\twocolitem{{\bf wxSYS\_COLOUR\_3DHIGHLIGHT}}{Same as wxSYS\_COLOUR\_BTNHIGHLIGHT.}
	67	\twocolitem{{\bf wxSYS\_COLOUR\_3DHILIGHT}}{Same as wxSYS\_COLOUR\_BTNHIGHLIGHT.}
	68	\twocolitem{{\bf wxSYS\_COLOUR\_BTNHILIGHT}}{Same as wxSYS\_COLOUR\_BTNHIGHLIGHT.}
	69	\end{twocollist}
	70
	71	\membersection{wxSystemSettings::GetSystemFont}\label{wxsystemsettingsgetsystemfont}
	72
	73	\func{static wxFont}{GetSystemFont}{\param{int}{ index}}
	74
	75	Returns a system font.
	76
	77	{\it index} can be one of:
	78
79	\twocolwidtha{7cm}
80	\begin{twocollist}\itemsep=0pt
81	\twocolitem{{\bf wxSYS\_OEM\_FIXED\_FONT}}{Original equipment manufacturer dependent fixed-pitch font.}
82	\twocolitem{{\bf wxSYS\_ANSI\_FIXED\_FONT}}{Windows fixed-pitch font.}
83	\twocolitem{{\bf wxSYS\_ANSI\_VAR\_FONT}}{Windows variable-pitch (proportional) font.}
84	\twocolitem{{\bf wxSYS\_SYSTEM\_FONT}}{System font.}
85	\twocolitem{{\bf wxSYS\_DEVICE\_DEFAULT\_FONT}}{Device-dependent font (Windows NT only).}
86	\twocolitem{{\bf wxSYS\_DEFAULT\_GUI\_FONT}}{Default font for user interface objects such as menus and dialog boxes.
87	Not available in versions of Windows earlier than Windows 95 or Windows NT 4.0.}
88	\end{twocollist}
89
90	\membersection{wxSystemSettings::GetSystemMetric}\label{wxsystemsettingsgetsystemmetric}
91
92	\func{static int}{GetSystemMetric}{\param{int}{ index}}
93
94	Returns a system metric.
95
96	{\it index} can be one of:
97
98	\twocolwidtha{7cm}
99	\begin{twocollist}\itemsep=0pt
100	\twocolitem{{\bf wxSYS\_MOUSE\_BUTTONS}}{Number of buttons on mouse, or zero if no mouse was installed.}
101	\twocolitem{{\bf wxSYS\_BORDER\_X}}{Width of single border.}
102	\twocolitem{{\bf wxSYS\_BORDER\_Y}}{Height of single border.}
103	\twocolitem{{\bf wxSYS\_CURSOR\_X}}{Width of cursor.}
104	\twocolitem{{\bf wxSYS\_CURSOR\_Y}}{Height of cursor.}
105	\twocolitem{{\bf wxSYS\_DCLICK\_X}}{Width in pixels of rectangle within which two successive mouse
106	clicks must fall to generate a double-click.}
107	\twocolitem{{\bf wxSYS\_DCLICK\_Y}}{Height in pixels of rectangle within which two successive mouse
108	clicks must fall to generate a double-click.}
109	\twocolitem{{\bf wxSYS\_DRAG\_X}}{Width in pixels of a rectangle centered on a drag point
110	to allow for limited movement of the mouse pointer before a drag operation begins.}
111	\twocolitem{{\bf wxSYS\_DRAG\_Y}}{Height in pixels of a rectangle centered on a drag point
112	to allow for limited movement of the mouse pointer before a drag operation begins.}
113	\twocolitem{{\bf wxSYS\_EDGE\_X}}{Width of a 3D border, in pixels. }
114	\twocolitem{{\bf wxSYS\_EDGE\_Y}}{Height of a 3D border, in pixels. }
115	\twocolitem{{\bf wxSYS\_HSCROLL\_ARROW\_X}}{Width of arrow bitmap on horizontal scrollbar.}
116	\twocolitem{{\bf wxSYS\_HSCROLL\_ARROW\_Y}}{Height of arrow bitmap on horizontal scrollbar.}
117	\twocolitem{{\bf wxSYS\_HTHUMB\_X}}{Width of horizontal scrollbar thumb.}
118	\twocolitem{{\bf wxSYS\_ICON\_X}}{The default width of an icon.}
119	\twocolitem{{\bf wxSYS\_ICON\_Y}}{The default height of an icon.}
120	\twocolitem{{\bf wxSYS\_ICONSPACING\_X}}{Width of a grid cell for items in large icon view,
121	in pixels. Each item fits into a rectangle of this size when arranged.}
122	\twocolitem{{\bf wxSYS\_ICONSPACING\_Y}}{Height of a grid cell for items in large icon view,
123	in pixels. Each item fits into a rectangle of this size when arranged.}
124	\twocolitem{{\bf wxSYS\_WINDOWMIN\_X}}{Minimum width of a window.}
125	\twocolitem{{\bf wxSYS\_WINDOWMIN\_Y}}{Minimum height of a window.}
126	\twocolitem{{\bf wxSYS\_SCREEN\_X}}{Width of the screen in pixels.}
127	\twocolitem{{\bf wxSYS\_SCREEN\_Y}}{Height of the screen in pixels.}
128	\twocolitem{{\bf wxSYS\_FRAMESIZE\_X}}{Width of the window frame for a wxTHICK\_FRAME window.}
129	\twocolitem{{\bf wxSYS\_FRAMESIZE\_Y}}{Height of the window frame for a wxTHICK\_FRAME window.}
130	\twocolitem{{\bf wxSYS\_SMALLICON\_X}}{Recommended width of a small icon (in window captions, and small icon view).}
131	\twocolitem{{\bf wxSYS\_SMALLICON\_Y}}{Recommended height of a small icon (in window captions, and small icon view).}
132	\twocolitem{{\bf wxSYS\_HSCROLL\_Y}}{Height of horizontal scrollbar in pixels.}
133	\twocolitem{{\bf wxSYS\_VSCROLL\_X}}{Width of vertical scrollbar in pixels.}
134	\twocolitem{{\bf wxSYS\_VSCROLL\_ARROW\_X}}{Width of arrow bitmap on a vertical scrollbar.}
135	\twocolitem{{\bf wxSYS\_VSCROLL\_ARROW\_Y}}{Height of arrow bitmap on a vertical scrollbar.}
136	\twocolitem{{\bf wxSYS\_VTHUMB\_Y}}{Height of vertical scrollbar thumb.}
137	\twocolitem{{\bf wxSYS\_CAPTION\_Y}}{Height of normal caption area.}
138	\twocolitem{{\bf wxSYS\_MENU\_Y}}{Height of single-line menu bar.}
139	\twocolitem{{\bf wxSYS\_NETWORK\_PRESENT}}{1 if there is a network present, 0 otherwise.}
140	\twocolitem{{\bf wxSYS\_PENWINDOWS\_PRESENT}}{1 if PenWindows is installed, 0 otherwise.}
141	\twocolitem{{\bf wxSYS\_SHOW\_SOUNDS}}{Non-zero if the user requires an application to present information visually in situations
142	where it would otherwise present the information only in audible form; zero otherwise.}
143	\twocolitem{{\bf wxSYS\_SWAP\_BUTTONS}}{Non-zero if the meanings of the left and right mouse buttons are swapped; zero otherwise.}
144	\end{twocollist}
145