X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/a660d684eda27638bca0384b2058911a31c8e845..8dba8632c5bcd64724e2e9e2d40e295555a0cb86:/docs/latex/wx/stattext.tex diff --git a/docs/latex/wx/stattext.tex b/docs/latex/wx/stattext.tex index a8678e27e5..433a509909 100644 --- a/docs/latex/wx/stattext.tex +++ b/docs/latex/wx/stattext.tex @@ -2,10 +2,6 @@ A static text control displays one or more lines of read-only text. -TODO: should a static text have a validator? E.g. if you wanted -to use it to initialise the control with some text taken from -the validator. - \wxheading{Derived from} \helpref{wxControl}{wxcontrol}\\ @@ -13,9 +9,24 @@ the validator. \helpref{wxEvtHandler}{wxevthandler}\\ \helpref{wxObject}{wxobject} +\wxheading{Include files} + + + \wxheading{Window styles} -There are no special styles for this control. +\twocolwidtha{5cm} +\begin{twocollist}\itemsep=0pt +\twocolitem{\windowstyle{wxALIGN\_LEFT}}{Align the text to the left} +\twocolitem{\windowstyle{wxALIGN\_RIGHT}}{Align the text to the right} +\twocolitem{\windowstyle{wxALIGN\_CENTRE}}{Center the text (horisontally)} +\twocolitem{\windowstyle{wxST\_NO\_AUTORESIZE}}{By default, the control will +adjust its size to exactly fit to the size of the text when +\helpref{SetLabel}{wxstatictextsetlabel} is called. If this style flag is +given, the control will not change its size (this style is especially useful +with controls which also have wxALIGN\_RIGHT or CENTER style because otherwise +they won't make sense any longer after a call to SetLabel)} +\end{twocollist} See also \helpref{window styles overview}{windowstyles}. @@ -31,9 +42,9 @@ See also \helpref{window styles overview}{windowstyles}. Default constructor. -\func{}{wxStaticText}{\param{wxWindow* }{parent}, \param{const wxWindowID}{ id},\rtfsp -\param{const wxString\& }{label = ``"}, \param{const wxPosition\& }{pos}, \param{const wxSize\& }{size = wxDefaultSize},\rtfsp -\param{const long}{ style = 0}, \param{const wxString\& }{name = ``staticText"}} +\func{}{wxStaticText}{\param{wxWindow* }{parent}, \param{wxWindowID}{ id},\rtfsp +\param{const wxString\& }{label}, \param{const wxPoint\& }{pos}, \param{const wxSize\& }{size = wxDefaultSize},\rtfsp +\param{long}{ style = 0}, \param{const wxString\& }{name = ``staticText"}} Constructor, creating and showing a text control. @@ -59,9 +70,9 @@ Constructor, creating and showing a text control. \membersection{wxStaticText::Create}\label{wxstatictextcreate} -\func{bool}{Create}{\param{wxWindow* }{parent}, \param{const wxWindowID}{ id},\rtfsp -\param{const wxString\& }{label = ``"}, \param{const wxPosition\& }{pos}, \param{const wxSize\& }{size = wxDefaultSize},\rtfsp -\param{const long}{ style = 0}, \param{const wxString\& }{name = ``staticText"}} +\func{bool}{Create}{\param{wxWindow* }{parent}, \param{wxWindowID}{ id},\rtfsp +\param{const wxString\& }{label}, \param{const wxPoint\& }{pos}, \param{const wxSize\& }{size = wxDefaultSize},\rtfsp +\param{long}{ style = 0}, \param{const wxString\& }{name = ``staticText"}} Creation function, for two-step construction. For details see \helpref{wxStaticText::wxStaticText}{wxstatictextconstr}. @@ -75,10 +86,10 @@ Returns the contents of the control. \func{virtual void}{SetLabel}{\param{const wxString\& }{ label}} -Sets the static text label. +Sets the static text label and updates the controls size to exactly fit the +label unless the control has wxST\_NO\_AUTORESIZE flag. \wxheading{Parameters} \docparam{label}{The new label to set. It may contain newline characters.} -