]> git.saurik.com Git - wxWidgets.git/blame - include/wx/stattext.h
Fixed context menu in wxRichTextCtrl
[wxWidgets.git] / include / wx / stattext.h
CommitLineData
2ecf902b
WS
1/////////////////////////////////////////////////////////////////////////////
2// Name: stattext.h
3// Purpose: wxStaticText base header
99d80019 4// Author: Julian Smart
2ecf902b
WS
5// Modified by:
6// Created:
99d80019 7// Copyright: (c) Julian Smart
2ecf902b
WS
8// RCS-ID: $Id$
9// Licence: wxWindows licence
10/////////////////////////////////////////////////////////////////////////////
11
34138703
JS
12#ifndef _WX_STATTEXT_H_BASE_
13#define _WX_STATTEXT_H_BASE_
c801d85f 14
2ecf902b
WS
15#include "wx/defs.h"
16
1e6feb95
VZ
17#if wxUSE_STATTEXT
18
19#include "wx/control.h"
20
39bc0347
VZ
21/*
22 * wxStaticText flags
23 */
24#define wxST_NO_AUTORESIZE 0x0001
25#define wxST_MARKUP 0x0002
26
27#define wxST_ELLIPSIZE_START 0x0004
28#define wxST_ELLIPSIZE_MIDDLE 0x0008
29#define wxST_ELLIPSIZE_END 0x0010
30
31
63ec432b 32extern WXDLLEXPORT_DATA(const wxChar) wxStaticTextNameStr[];
1e6feb95
VZ
33
34class WXDLLEXPORT wxStaticTextBase : public wxControl
35{
36public:
fc7a2a60
VZ
37 wxStaticTextBase() { }
38
5d1b4919
VZ
39 // wrap the text of the control so that no line is longer than the given
40 // width (if possible: this function won't break words)
39bc0347 41 // This function will modify the value returned by GetLabel()!
5d1b4919
VZ
42 void Wrap(int width);
43
bd507486
RD
44 // overriden base virtuals
45 virtual bool AcceptsFocus() const { return false; }
7c7a653b 46 virtual bool HasTransparentBackground() { return true; }
fc7a2a60 47
39bc0347
VZ
48 bool IsEllipsized() const
49 {
50 return HasFlag(wxST_ELLIPSIZE_START) ||
51 HasFlag(wxST_ELLIPSIZE_MIDDLE) ||
52 HasFlag(wxST_ELLIPSIZE_END);
53 }
54
55 // get the string without mnemonic characters ('&') and without markup
56 // (if wxST_MARKUP is being used)
57 virtual wxString GetLabelText() const;
58
59 // public utilities (symmetric to those in wxControl about mnemonics):
60
19cf1ef3
FM
61 // get the string without mnemonic characters ('&') and without markup
62 static wxString GetLabelText(const wxString& label);
63
39bc0347
VZ
64 // removes the markup accepted by wxStaticText when wxST_MARKUP is used,
65 // and then returns the cleaned string
66 static wxString RemoveMarkup(const wxString& str);
67
68 // escapes the alls special symbols (<>"'&) present inside the given string
69 // using the corresponding entities (&lt; &gt; &quot; &apos; &amp;)
70 static wxString EscapeMarkup(const wxString& str);
71
72
73protected: // functions required for wxST_ELLIPSIZE_* support
74
75 // just calls RemoveMarkup & Ellipsize on the original label.
76 virtual wxString GetEllipsizedLabelWithoutMarkup() const;
77
78 // replaces parts of the string with ellipsis if needed
79 wxString Ellipsize(const wxString& label) const;
80
81 // to be called when updating the size of the static text:
82 // updates the label redoing ellipsization calculations
83 void UpdateLabel();
84
85 // These functions are platform-specific and must be overridden in ports
86 // which do not natively support ellipsization and they must be implemented
87 // in a way so that the m_label member of wxControl is not touched:
88
89 // returns the real label currently displayed inside the control.
90 virtual wxString DoGetLabel() const { return wxEmptyString; }
91
92 // sets the real label currently displayed inside the control,
93 // _without_ invalidating the size. The text passed is always markup-free.
94 virtual void DoSetLabel(const wxString& WXUNUSED(str)) { }
95
fc7a2a60
VZ
96private:
97 DECLARE_NO_COPY_CLASS(wxStaticTextBase)
1e6feb95
VZ
98};
99
100#if defined(__WXUNIVERSAL__)
101 #include "wx/univ/stattext.h"
102#elif defined(__WXMSW__)
103 #include "wx/msw/stattext.h"
2049ba38 104#elif defined(__WXMOTIF__)
1e6feb95 105 #include "wx/motif/stattext.h"
1be7a35c 106#elif defined(__WXGTK20__)
1e6feb95 107 #include "wx/gtk/stattext.h"
1be7a35c
MR
108#elif defined(__WXGTK__)
109 #include "wx/gtk1/stattext.h"
34138703 110#elif defined(__WXMAC__)
1e6feb95 111 #include "wx/mac/stattext.h"
e64df9bc
DE
112#elif defined(__WXCOCOA__)
113 #include "wx/cocoa/stattext.h"
1777b9bb 114#elif defined(__WXPM__)
1e6feb95 115 #include "wx/os2/stattext.h"
a152561c
WS
116#elif defined(__WXPALMOS__)
117 #include "wx/palmos/stattext.h"
c801d85f
KB
118#endif
119
1e6feb95
VZ
120#endif // wxUSE_STATTEXT
121
c801d85f 122#endif
34138703 123 // _WX_STATTEXT_H_BASE_