]>
Commit | Line | Data |
---|---|---|
1 | \section{\class{wxStaticText}}\label{wxstatictext} | |
2 | ||
3 | A 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 | |
24 | adjust its size to exactly fit to the size of the text when | |
25 | \helpref{SetLabel}{wxstatictextsetlabel} is called. If this style flag is | |
26 | given, the control will not change its size (this style is especially useful | |
27 | with controls which also have wxALIGN\_RIGHT or CENTER style because otherwise | |
28 | they won't make sense any longer after a call to SetLabel)} | |
29 | \end{twocollist} | |
30 | ||
31 | See 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 | ||
43 | Default 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 | ||
49 | Constructor, 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 | ||
77 | Creation 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 | ||
83 | Returns the contents of the control. | |
84 | ||
85 | \membersection{wxStaticText::SetLabel}\label{wxstatictextsetlabel} | |
86 | ||
87 | \func{virtual void}{SetLabel}{\param{const wxString\& }{ label}} | |
88 | ||
89 | Sets the static text label and updates the controls size to exactly fit the | |
90 | label 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 |