]> git.saurik.com Git - wxWidgets.git/blame_incremental - docs/latex/wx/fontdlg.tex
Overwrote(!!) with source files that compile and link with latest wxGTK.
[wxWidgets.git] / docs / latex / wx / fontdlg.tex
... / ...
CommitLineData
1\section{\class{wxFontData}}\label{wxfontdata}
2
3\overview{wxFontDialog overview}{wxfontdialogoverview}
4
5This class holds a variety of information related to font dialogs.
6
7\wxheading{Derived from}
8
9\helpref{wxObject}{wxobject}
10
11\wxheading{See also}
12
13\helpref{Overview}{wxfontdialogoverview}, \helpref{wxFontDialog}{wxfontdialog}
14
15\latexignore{\rtfignore{\wxheading{Members}}}
16
17\membersection{wxFontData::wxFontData}
18
19\func{}{wxFontData}{\void}
20
21Constructor. Initializes {\it fontColour} to black, {\it showHelp} to black,
22\rtfsp{\it allowSymbols} to TRUE, {\it enableEffects} to TRUE,
23\rtfsp{\it minSize} to 0 and {\it maxSize} to 0.
24
25\membersection{wxFontData::\destruct{wxFontData}}
26
27\func{}{\destruct{wxFontData}}{\void}
28
29Destructor.
30
31\membersection{wxFontData::EnableEffects}
32
33\func{void}{EnableEffects}{\param{bool}{ enable}}
34
35Enables or disables `effects' under MS Windows only. This refers to the
36controls for manipulating colour, strikeout and underline properties.
37
38The default value is TRUE.
39
40\membersection{wxFontData::GetAllowSymbols}
41
42\func{bool}{GetAllowSymbols}{\void}
43
44Under MS Windows, returns a flag determining whether symbol fonts can be selected. Has no
45effect on other platforms.
46
47The default value is TRUE.
48
49\membersection{wxFontData::GetColour}
50
51\func{wxColour\&}{GetColour}{\void}
52
53Gets the colour associated with the font dialog.
54
55The default value is black.
56
57\membersection{wxFontData::GetChosenFont}
58
59\func{wxFont}{GetChosenFont}{\void}
60
61Gets the font chosen by the user. If the user pressed OK (wxFontDialog::Show returned TRUE), this returns
62a new font which is now `owned' by the application, and should be deleted
63if not required. If the user pressed Cancel (wxFontDialog::Show returned FALSE) or
64the colour dialog has not been invoked yet, this will return NULL.
65
66\membersection{wxFontData::GetEnableEffects}
67
68\func{bool}{GetEnableEffects}{\void}
69
70Determines whether `effects' are enabled under Windows. This refers to the
71controls for manipulating colour, strikeout and underline properties.
72
73The default value is TRUE.
74
75\membersection{wxFontData::GetInitialFont}
76
77\func{wxFont}{GetInitialFont}{\void}
78
79Gets the font that will be initially used by the font dialog. This should have
80previously been set by the application.
81
82\membersection{wxFontData::GetShowHelp}
83
84\func{bool}{GetShowHelp}{\void}
85
86Returns TRUE if the Help button will be shown (Windows only).
87
88The default value is FALSE.
89
90\membersection{wxFontData::SetAllowSymbols}
91
92\func{void}{SetAllowSymbols}{\param{bool}{ allowSymbols}}
93
94Under MS Windows, determines whether symbol fonts can be selected. Has no
95effect on other platforms.
96
97The default value is TRUE.
98
99\membersection{wxFontData::SetChosenFont}
100
101\func{void}{SetChosenFont}{\param{const wxFont\& }{font}}
102
103Sets the font that will be returned to the user (for internal use only).
104
105\membersection{wxFontData::SetColour}
106
107\func{void}{SetColour}{\param{const wxColour\&}{ colour}}
108
109Sets the colour that will be used for the font foreground colour.
110
111The default colour is black.
112
113\membersection{wxFontData::SetInitialFont}
114
115\func{void}{SetInitialFont}{\param{const wxFont\&}{font}}
116
117Sets the font that will be initially used by the font dialog.
118
119\membersection{wxFontData::SetRange}
120
121\func{void}{SetRange}{\param{int}{ min}, \param{int}{ max}}
122
123Sets the valid range for the font point size (Windows only).
124
125The default is 0, 0 (unrestricted range).
126
127\membersection{wxFontData::SetShowHelp}
128
129\func{void}{SetShowHelp}{\param{bool}{ showHelp}}
130
131Determines whether the Help button will be displayed in the font dialog (Windows only).
132
133The default value is FALSE.
134
135\membersection{wxFontData::operator $=$}
136
137\func{void}{operator $=$}{\param{const wxFontData\&}{ data}}
138
139Assingment operator for the font data.
140
141\section{\class{wxFontDialog}}\label{wxfontdialog}
142
143This class represents the font chooser dialog.
144
145\wxheading{Derived from}
146
147\helpref{wxDialog}{wxdialog}\\
148\helpref{wxWindow}{wxwindow}\\
149\helpref{wxEvtHandler}{wxevthandler}\\
150\helpref{wxObject}{wxobject}
151
152\wxheading{See also}
153
154\helpref{Overview}{wxfontdialogoverview}, \helpref{wxFontData}{wxfontdata}
155
156\latexignore{\rtfignore{\wxheading{Members}}}
157
158\membersection{wxFontDialog::wxFontDialog}
159
160\func{}{wxFontDialog}{\param{wxWindow* }{parent}, \param{wxFontData* }{data = NULL}}
161
162Constructor. Pass a parent window, and optionally a pointer to a block of font
163data, which will be copied to the font dialog's font data.
164
165\membersection{wxFontDialog::\destruct{wxFontDialog}}
166
167\func{}{\destruct{wxFontDialog}}{\void}
168
169Destructor.
170
171\membersection{wxFontDialog::GetFontData}
172
173\func{wxFontData\&}{GetFontData}{\void}
174
175Returns the \helpref{font data}{wxfontdata} associated with the font dialog.
176
177\membersection{wxFontDialog::ShowModal}
178
179\func{int}{ShowModal}{\void}
180
181Shows the dialog, returning wxID\_OK if the user pressed Ok, and wxID\_CANCEL
182otherwise.
183
184If the user cancels the dialog (ShowModal returns wxID\_CANCEL), no font will be
185created. If the user presses OK (ShowModal returns wxID\_OK), a new wxFont will
186be created and stored in the font dialog's wxFontData structure.
187