+/////////////////////////////////////////////////////////////////////////////
+// Name: stattext.h
+// Purpose: wxStaticText base header
+// Author: Julian Smart
+// Modified by:
+// Created:
+// Copyright: (c) Julian Smart
+// RCS-ID: $Id$
+// Licence: wxWindows licence
+/////////////////////////////////////////////////////////////////////////////
+
#ifndef _WX_STATTEXT_H_BASE_
#define _WX_STATTEXT_H_BASE_
+#include "wx/defs.h"
+
#if wxUSE_STATTEXT
#include "wx/control.h"
-WXDLLEXPORT_DATA(extern const wxChar*) wxStaticTextNameStr;
+/*
+ * wxStaticText flags
+ */
+#define wxST_NO_AUTORESIZE 0x0001
+#define wxST_MARKUP 0x0002
+
+#define wxST_ELLIPSIZE_START 0x0004
+#define wxST_ELLIPSIZE_MIDDLE 0x0008
+#define wxST_ELLIPSIZE_END 0x0010
+
+
+extern WXDLLEXPORT_DATA(const wxChar) wxStaticTextNameStr[];
class WXDLLEXPORT wxStaticTextBase : public wxControl
{
public:
- // overriden base class virtuals
- virtual bool AcceptsFocus() const { return FALSE; }
+ wxStaticTextBase() { }
+
+ // 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):
+
+ // 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)) { }
+
+private:
+ DECLARE_NO_COPY_CLASS(wxStaticTextBase)
};
#if defined(__WXUNIVERSAL__)
#include "wx/msw/stattext.h"
#elif defined(__WXMOTIF__)
#include "wx/motif/stattext.h"
-#elif defined(__WXGTK__)
+#elif defined(__WXGTK20__)
#include "wx/gtk/stattext.h"
-#elif defined(__WXQT__)
- #include "wx/qt/stattext.h"
+#elif defined(__WXGTK__)
+ #include "wx/gtk1/stattext.h"
#elif defined(__WXMAC__)
#include "wx/mac/stattext.h"
+#elif defined(__WXCOCOA__)
+ #include "wx/cocoa/stattext.h"
#elif defined(__WXPM__)
#include "wx/os2/stattext.h"
-#elif defined(__WXSTUBS__)
- #include "wx/stubs/stattext.h"
+#elif defined(__WXPALMOS__)
+ #include "wx/palmos/stattext.h"
#endif
#endif // wxUSE_STATTEXT