X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/2049ba38adafa0ec146880de29f26e32dd69a125..a43bd048a35bd6275867c067032f505046f14ef5:/include/wx/stattext.h diff --git a/include/wx/stattext.h b/include/wx/stattext.h index 0cf342680b..3a1c6cb047 100644 --- a/include/wx/stattext.h +++ b/include/wx/stattext.h @@ -1,13 +1,123 @@ -#ifndef __STATTEXTH_BASE__ -#define __STATTEXTH_BASE_ +///////////////////////////////////////////////////////////////////////////// +// Name: stattext.h +// Purpose: wxStaticText base header +// Author: Julian Smart +// Modified by: +// Created: +// Copyright: (c) Julian Smart +// RCS-ID: $Id$ +// Licence: wxWindows licence +///////////////////////////////////////////////////////////////////////////// -#if defined(__WXMSW__) -#include "wx/msw/stattext.h" +#ifndef _WX_STATTEXT_H_BASE_ +#define _WX_STATTEXT_H_BASE_ + +#include "wx/defs.h" + +#if wxUSE_STATTEXT + +#include "wx/control.h" + +/* + * 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: + 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): + + // 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)) { } + +private: + DECLARE_NO_COPY_CLASS(wxStaticTextBase) +}; + +#if defined(__WXUNIVERSAL__) + #include "wx/univ/stattext.h" +#elif defined(__WXMSW__) + #include "wx/msw/stattext.h" #elif defined(__WXMOTIF__) -#include "wx/xt/stattext.h" + #include "wx/motif/stattext.h" +#elif defined(__WXGTK20__) + #include "wx/gtk/stattext.h" #elif defined(__WXGTK__) -#include "wx/gtk/stattext.h" + #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(__WXPALMOS__) + #include "wx/palmos/stattext.h" #endif +#endif // wxUSE_STATTEXT + #endif - // __STATTEXTH_BASE__ + // _WX_STATTEXT_H_BASE_