3da9cffc79
This is an incompatible change which removes the wxStaticText-specific wxST_MARKUP style and adds wxControl::SetLabelMarkup() replacing it. It doesn't actually change anything yet but it simplifies wxStaticText code a lot by getting rid of many markup-related functions in it which had to behave differently depending on whether wxST_MARKUP was used or not and also paves way for adding markup support for the other controls in the future. git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@67055 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
112 lines
4.0 KiB
Objective-C
112 lines
4.0 KiB
Objective-C
/////////////////////////////////////////////////////////////////////////////
|
|
// Name: stattext.h
|
|
// Purpose: interface of wxStaticText
|
|
// Author: wxWidgets team
|
|
// RCS-ID: $Id$
|
|
// Licence: wxWindows licence
|
|
/////////////////////////////////////////////////////////////////////////////
|
|
|
|
/**
|
|
@class wxStaticText
|
|
|
|
A static text control displays one or more lines of read-only text.
|
|
wxStaticText supports the three classic text alignments, label
|
|
ellipsization i.e. replacing parts of the text with the ellipsis ("...") if
|
|
the label doesn't fit into the provided space and also formatting markup
|
|
with wxControl::SetLabelMarkup().
|
|
|
|
@beginStyleTable
|
|
@style{wxALIGN_LEFT}
|
|
Align the text to the left.
|
|
@style{wxALIGN_RIGHT}
|
|
Align the text to the right.
|
|
@style{wxALIGN_CENTRE}
|
|
Center the text (horizontally).
|
|
@style{wxST_NO_AUTORESIZE}
|
|
By default, the control will adjust its size to exactly fit to the
|
|
size of the text when SetLabel() 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 the @c wxALIGN_RIGHT or
|
|
the @c wxALIGN_CENTRE style because otherwise they won't make sense any
|
|
longer after a call to SetLabel()).
|
|
@style{wxST_ELLIPSIZE_START}
|
|
If the labeltext width exceeds the control width, replace the beginning
|
|
of the label with an ellipsis; uses wxControl::Ellipsize.
|
|
@style{wxST_ELLIPSIZE_MIDDLE}
|
|
If the label text width exceeds the control width, replace the middle
|
|
of the label with an ellipsis; uses wxControl::Ellipsize.
|
|
@style{wxST_ELLIPSIZE_END}
|
|
If the label text width exceeds the control width, replace the end
|
|
of the label with an ellipsis; uses wxControl::Ellipsize.
|
|
@endStyleTable
|
|
|
|
@library{wxcore}
|
|
@category{ctrl}
|
|
@appearance{statictext.png}
|
|
|
|
@see wxStaticBitmap, wxStaticBox
|
|
*/
|
|
class wxStaticText : public wxControl
|
|
{
|
|
public:
|
|
/**
|
|
Default constructor.
|
|
*/
|
|
wxStaticText();
|
|
|
|
/**
|
|
Constructor, creating and showing a text control.
|
|
|
|
@param parent
|
|
Parent window. Should not be @NULL.
|
|
@param id
|
|
Control identifier. A value of -1 denotes a default value.
|
|
@param label
|
|
Text label.
|
|
@param pos
|
|
Window position.
|
|
@param size
|
|
Window size.
|
|
@param style
|
|
Window style. See wxStaticText.
|
|
@param name
|
|
Window name.
|
|
|
|
@see Create()
|
|
*/
|
|
wxStaticText(wxWindow* parent, wxWindowID id,
|
|
const wxString& label,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize,
|
|
long style = 0,
|
|
const wxString& name = wxStaticTextNameStr);
|
|
|
|
/**
|
|
Creation function, for two-step construction. For details see wxStaticText().
|
|
*/
|
|
bool Create(wxWindow* parent, wxWindowID id, const wxString& label,
|
|
const wxPoint& pos = wxDefaultPosition,
|
|
const wxSize& size = wxDefaultSize, long style = 0,
|
|
const wxString& name = wxStaticTextNameStr);
|
|
|
|
/**
|
|
Returns @true if the window styles for this control contains one of the
|
|
@c wxST_ELLIPSIZE_START, @c wxST_ELLIPSIZE_MIDDLE or @c wxST_ELLIPSIZE_END styles.
|
|
*/
|
|
bool IsEllipsized() const;
|
|
|
|
/**
|
|
This functions wraps the controls label so that each of its lines becomes at
|
|
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 @a width is negative, no wrapping is done. Note that this width is not
|
|
necessarily the total width of the control, since a few pixels for the
|
|
border (depending on the controls border style) may be added.
|
|
|
|
@since 2.6.2
|
|
*/
|
|
void Wrap(int width);
|
|
};
|
|
|