X-Git-Url: https://git.saurik.com/wxWidgets.git/blobdiff_plain/2ecf902bc836f2808444b34eff48cdb12f289460..7bd30a12ade503fd135c686ecc98a6f6d5fecbeb:/include/wx/stattext.h diff --git a/include/wx/stattext.h b/include/wx/stattext.h index cf49abca92..a7124c440d 100644 --- a/include/wx/stattext.h +++ b/include/wx/stattext.h @@ -1,10 +1,10 @@ ///////////////////////////////////////////////////////////////////////////// -// Name: stattext.h +// Name: wx/stattext.h // Purpose: wxStaticText base header -// Author: wxWidgets Team +// Author: Julian Smart // Modified by: // Created: -// Copyright: (c) wxWidgets Team +// Copyright: (c) Julian Smart // RCS-ID: $Id$ // Licence: wxWindows licence ///////////////////////////////////////////////////////////////////////////// @@ -18,31 +18,86 @@ #include "wx/control.h" -extern WXDLLEXPORT_DATA(const wxChar*) wxStaticTextNameStr; +/* + * wxStaticText flags + */ +#define wxST_NO_AUTORESIZE 0x0001 +// free 0x0002 bit +#define wxST_ELLIPSIZE_START 0x0004 +#define wxST_ELLIPSIZE_MIDDLE 0x0008 +#define wxST_ELLIPSIZE_END 0x0010 -class WXDLLEXPORT wxStaticTextBase : public wxControl +extern WXDLLIMPEXP_DATA_CORE(const char) wxStaticTextNameStr[]; + +class WXDLLIMPEXP_CORE wxStaticTextBase : public wxControl { public: wxStaticTextBase() { } - // overriden base virtuals + // 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); + + // overridden 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); + } + +protected: // functions required for wxST_ELLIPSIZE_* support + + // choose the default border for this window + virtual wxBorder GetDefaultBorder() const { return wxBORDER_NONE; } + + // Calls Ellipsize() on the real label if necessary. Unlike GetLabelText(), + // keeps the mnemonics instead of removing them. + virtual wxString GetEllipsizedLabel() const; + + // Replaces parts of the string with ellipsis according to the ellipsize + // style. Shouldn't be called if we don't have any. + 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)) { } + private: - DECLARE_NO_COPY_CLASS(wxStaticTextBase) + wxDECLARE_NO_COPY_CLASS(wxStaticTextBase); }; +// see wx/generic/stattextg.h for the explanation +#ifndef wxNO_PORT_STATTEXT_INCLUDE + #if defined(__WXUNIVERSAL__) #include "wx/univ/stattext.h" #elif defined(__WXMSW__) #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(__WXGTK__) + #include "wx/gtk1/stattext.h" #elif defined(__WXMAC__) - #include "wx/mac/stattext.h" + #include "wx/osx/stattext.h" #elif defined(__WXCOCOA__) #include "wx/cocoa/stattext.h" #elif defined(__WXPM__) @@ -51,7 +106,8 @@ private: #include "wx/palmos/stattext.h" #endif +#endif // !wxNO_PORT_STATTEXT_INCLUDE + #endif // wxUSE_STATTEXT -#endif - // _WX_STATTEXT_H_BASE_ +#endif // _WX_STATTEXT_H_BASE_