]> git.saurik.com Git - wxWidgets.git/blame_incremental - docs/latex/wx/stattext.tex
Added a couple of wxPerl notes.
[wxWidgets.git] / docs / latex / wx / stattext.tex
... / ...
CommitLineData
1\section{\class{wxStaticText}}\label{wxstatictext}
2
3A static text control displays one or more lines of read-only text.
4
5\wxheading{Derived from}
6
7\helpref{wxControl}{wxcontrol}\\
8\helpref{wxWindow}{wxwindow}\\
9\helpref{wxEvtHandler}{wxevthandler}\\
10\helpref{wxObject}{wxobject}
11
12\wxheading{Include files}
13
14<wx/stattext.h>
15
16\wxheading{Window styles}
17
18\twocolwidtha{5cm}
19\begin{twocollist}\itemsep=0pt
20\twocolitem{\windowstyle{wxALIGN\_LEFT}}{Align the text to the left}
21\twocolitem{\windowstyle{wxALIGN\_RIGHT}}{Align the text to the right}
22\twocolitem{\windowstyle{wxALIGN\_CENTRE}}{Center the text (horizontally)}
23\twocolitem{\windowstyle{wxST\_NO\_AUTORESIZE}}{By default, the control will
24adjust its size to exactly fit to the size of the text when
25\helpref{SetLabel}{wxstatictextsetlabel} is called. If this style flag is
26given, the control will not change its size (this style is especially useful
27with controls which also have wxALIGN\_RIGHT or CENTER style because otherwise
28they won't make sense any longer after a call to SetLabel)}
29\end{twocollist}
30
31See also \helpref{window styles overview}{windowstyles}.
32
33\wxheading{See also}
34
35\helpref{wxStaticBitmap}{wxstaticbitmap}, \helpref{wxStaticBox}{wxstaticbox}
36
37\latexignore{\rtfignore{\wxheading{Members}}}
38
39\membersection{wxStaticText::wxStaticText}\label{wxstatictextconstr}
40
41\func{}{wxStaticText}{\void}
42
43Default constructor.
44
45\func{}{wxStaticText}{\param{wxWindow* }{parent}, \param{wxWindowID}{ id},\rtfsp
46\param{const wxString\& }{label}, \param{const wxPoint\& }{pos = wxDefaultPosition}, \param{const wxSize\& }{size = wxDefaultSize},\rtfsp
47\param{long}{ style = 0}, \param{const wxString\& }{name = ``staticText"}}
48
49Constructor, creating and showing a text control.
50
51\wxheading{Parameters}
52
53\docparam{parent}{Parent window. Should not be NULL.}
54
55\docparam{id}{Control identifier. A value of -1 denotes a default value.}
56
57\docparam{label}{Text label.}
58
59\docparam{pos}{Window position.}
60
61\docparam{size}{Window size.}
62
63\docparam{style}{Window style. See \helpref{wxStaticText}{wxstatictext}.}
64
65\docparam{name}{Window name.}
66
67\wxheading{See also}
68
69\helpref{wxStaticText::Create}{wxstatictextcreate}
70
71\membersection{wxStaticText::Create}\label{wxstatictextcreate}
72
73\func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID}{ id},\rtfsp
74\param{const wxString\& }{label}, \param{const wxPoint\& }{pos = wxDefaultPosition}, \param{const wxSize\& }{size = wxDefaultSize},\rtfsp
75\param{long}{ style = 0}, \param{const wxString\& }{name = ``staticText"}}
76
77Creation function, for two-step construction. For details see \helpref{wxStaticText::wxStaticText}{wxstatictextconstr}.
78
79\membersection{wxStaticText::GetLabel}\label{wxstatictextgetlabel}
80
81\constfunc{wxString}{GetLabel}{\void}
82
83Returns the contents of the control.
84
85\membersection{wxStaticText::SetLabel}\label{wxstatictextsetlabel}
86
87\func{virtual void}{SetLabel}{\param{const wxString\& }{ label}}
88
89Sets the static text label and updates the controls size to exactly fit the
90label unless the control has wxST\_NO\_AUTORESIZE flag.
91
92\wxheading{Parameters}
93
94\docparam{label}{The new label to set. It may contain newline characters.}
95