/////////////////////////////////////////////////////////////////////////////
// Name: stattext.h
-// Purpose: documentation for wxStaticText class
+// Purpose: interface of wxStaticText
// Author: wxWidgets team
// RCS-ID: $Id$
// Licence: wxWindows license
@category{ctrl}
@appearance{statictext.png}
- @seealso
- wxStaticBitmap, wxStaticBox
+ @see wxStaticBitmap, wxStaticBox
*/
class wxStaticText : public wxControl
{
//@{
/**
Constructor, creating and showing a text control.
-
+
@param parent
- Parent window. Should not be @NULL.
-
+ Parent window. Should not be @NULL.
@param id
- Control identifier. A value of -1 denotes a default value.
-
+ Control identifier. A value of -1 denotes a default value.
@param label
- Text label.
-
+ Text label.
@param pos
- Window position.
-
+ Window position.
@param size
- Window size.
-
+ Window size.
@param style
- Window style. See wxStaticText.
-
+ Window style. See wxStaticText.
@param name
- Window name.
-
- @sa Create()
+ Window name.
+
+ @see Create()
*/
wxStaticText();
wxStaticText(wxWindow* parent, wxWindowID id,
/**
Returns the contents of the control.
-
Note that the returned string contains both the mnemonics (@c characters),
if any, and markup tags, if any.
-
Use GetLabelText() if only the
label text is needed.
*/
- wxString GetLabel();
+ wxString GetLabel() const;
//@{
/**
The first form returns the control's label without the mnemonics characters (if
any)
and without the markup (if the control has @c wxST_MARKUP style).
-
- The second (static) version returns the given @e label string without the
+ The second (static) version returns the given @a label string without the
mnemonics
characters (if any) and without the markup.
*/
wxString GetLabelText();
- static wxString GetLabelText(const wxString& label);
+ const static wxString GetLabelText(const wxString& label);
//@}
/**
Sets the static text label and updates the controls size to exactly fit the
label unless the control has wxST_NO_AUTORESIZE flag.
-
This function allows to set decorated static label text on platforms which
support it (currently only GTK+ 2). For the other platforms, the markup is
ignored.
-
The supported tags are:
-
-
+
b
-
-
+
bold text
-
+
big
-
-
+
bigger text
-
+
i
-
-
+
italic text
-
+
s
-
-
+
strike-through text
-
+
sub
-
-
+
subscript text
-
+
sup
-
-
+
superscript text
-
+
small
-
-
+
smaller text
-
+
tt
-
-
+
monospaced text
-
+
u
-
-
+
underlined text
-
+
span
-
-
+
generic formatter tag; see Pango Markup for more information.
-
+
Note that the string must be well-formed (e.g. all tags must be correctly
closed)
otherwise it can be not shown correctly or at all.
-
Also note that you need to escape the following special characters:
-
-
+
@b Special character
-
-
+
@b Escape as
-
+
@c
-
-
+
@c amp; or as @c
-
+
@c '
-
-
+
@c apos;
-
+
@c "
-
-
+
@c quot;
-
+
@c
-
-
+
@c lt;
-
+
@c
-
-
+
@c gt;
-
+
The non-escaped ampersand @c characters are interpreted as
mnemonics; see wxControl::SetLabel.
+
Example:
-
+
@param label
- The new label to set. It may contain newline characters and the markup tags
+ The new label to set. It may contain newline characters and the markup tags
described above.
*/
virtual void SetLabel(const wxString& label);
/**
This functions wraps the controls label so that each of its lines becomes at
- most @e width pixels wide if possible (the lines are broken at words
+ most @a width pixels wide if possible (the lines are broken at words
boundaries so it might not be the case if words are too long). If @e width
is negative, no wrapping is done.
-
- This function is new since wxWidgets version 2.6.2
+
+ @wxsince{2.6.2}
*/
void Wrap(int width);
};
+
projects / wxWidgets.git / blobdiff