+ 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 the wxST_MARKUP style is set)
+ virtual wxString GetLabelText() const;
+
+ // set label text (mnemonics and markup, if the wxST_MARKUP style is set,
+ // will be escaped)
+ virtual void SetLabelText(const wxString& text);
+
+
+ // static utilities for markup handling
+ // (symmetric to those in wxControl about mnemonics)
+ // -------------------------------------------------
+
+ // get the string without mnemonic characters ('&') and without markup
+ // (note that markup is always removed; this function is static and cannot
+ // check for wxST_MARKUP style presence/absence!)
+ static wxString GetLabelText(const wxString& label);
+
+ // removes the markup recognized by wxStaticText and returns the cleaned string
+ static wxString RemoveMarkup(const wxString& str);
+
+ // escapes all special symbols (<>"'&) present in the given string
+ // using the corresponding entities (< > " ' &)
+ static wxString EscapeMarkup(const wxString& str);
+
+protected: // functions required for wxST_ELLIPSIZE_* support
+
+ // choose the default border for this window
+ virtual wxBorder GetDefaultBorder() const { return wxBORDER_NONE; }
+
+ // calls only RemoveMarkup() on the original label
+ // if the wxST_MARKUP style is set
+ // (but unlike GetLabelText won't remove mnemonics)
+ virtual wxString GetLabelWithoutMarkup() const;
+
+ // just calls RemoveMarkup() & Ellipsize() on the original label
+ // if the wxST_MARKUP & wxST_ELLIPSIZE_* styles are set
+ // (but unlike GetLabelText won't remove mnemonics)
+ 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_labelOrig 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
+ // but may contain the mnemonic characters.
+ virtual void DoSetLabel(const wxString& WXUNUSED(str)) { }
+