+ // wrap the text of the control so that no line is longer than the given
+ // width (if possible: this function won't break words)
+ // This function will modify the value returned by GetLabel()!
+ void Wrap(int width);
+
+ // overriden base virtuals
+ virtual bool AcceptsFocus() const { return false; }
+ virtual bool HasTransparentBackground() { return true; }
+
+ bool IsEllipsized() const
+ {
+ return HasFlag(wxST_ELLIPSIZE_START) ||
+ HasFlag(wxST_ELLIPSIZE_MIDDLE) ||
+ HasFlag(wxST_ELLIPSIZE_END);
+ }
+
+ // get the string without mnemonic characters ('&') and without markup
+ // (if wxST_MARKUP is being used)
+ virtual wxString GetLabelText() const;
+
+ // public utilities (symmetric to those in wxControl about mnemonics):
+
+ // get the string without mnemonic characters ('&') and without markup
+ static wxString GetLabelText(const wxString& label);
+
+ // removes the markup accepted by wxStaticText when wxST_MARKUP is used,
+ // and then returns the cleaned string
+ static wxString RemoveMarkup(const wxString& str);
+
+ // escapes the alls special symbols (<>"'&) present inside the given string
+ // using the corresponding entities (< > " ' &)
+ static wxString EscapeMarkup(const wxString& str);
+
+
+protected: // functions required for wxST_ELLIPSIZE_* support
+
+ // just calls RemoveMarkup & Ellipsize on the original label.
+ virtual wxString GetEllipsizedLabelWithoutMarkup() const;
+
+ // replaces parts of the string with ellipsis if needed
+ wxString Ellipsize(const wxString& label) const;
+
+ // to be called when updating the size of the static text:
+ // updates the label redoing ellipsization calculations
+ void UpdateLabel();
+
+ // These functions are platform-specific and must be overridden in ports
+ // which do not natively support ellipsization and they must be implemented
+ // in a way so that the m_label member of wxControl is not touched:
+
+ // returns the real label currently displayed inside the control.
+ virtual wxString DoGetLabel() const { return wxEmptyString; }
+
+ // sets the real label currently displayed inside the control,
+ // _without_ invalidating the size. The text passed is always markup-free.
+ virtual void DoSetLabel(const wxString& WXUNUSED(str)) { }