include/wx/statusbr.h

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        wx/statusbr.h
   3 // Purpose:     wxStatusBar class interface
   4 // Author:      Vadim Zeitlin
   5 // Modified by:
   6 // Created:     05.02.00
   7 // Copyright:   (c) Vadim Zeitlin
   8 // Licence:     wxWindows licence
   9 /////////////////////////////////////////////////////////////////////////////
  10
  11 #ifndef _WX_STATUSBR_H_BASE_
  12 #define _WX_STATUSBR_H_BASE_
  13
  14 #include "wx/defs.h"
  15
  16 #if wxUSE_STATUSBAR
  17
  18 #include "wx/control.h"
  19 #include "wx/list.h"
  20 #include "wx/dynarray.h"
  21
  22 extern WXDLLIMPEXP_DATA_CORE(const char) wxStatusBarNameStr[];
  23
  24 // ----------------------------------------------------------------------------
  25 // wxStatusBar constants
  26 // ----------------------------------------------------------------------------
  27
  28 // wxStatusBar styles
  29 #define wxSTB_SIZEGRIP         0x0010
  30 #define wxSTB_SHOW_TIPS        0x0020
  31
  32 #define wxSTB_ELLIPSIZE_START   0x0040
  33 #define wxSTB_ELLIPSIZE_MIDDLE  0x0080
  34 #define wxSTB_ELLIPSIZE_END     0x0100
  35
  36 #define wxSTB_DEFAULT_STYLE    (wxSTB_SIZEGRIP|wxSTB_ELLIPSIZE_END|wxSTB_SHOW_TIPS|wxFULL_REPAINT_ON_RESIZE)
  37
  38
  39 // old compat style name:
  40 #define wxST_SIZEGRIP    wxSTB_SIZEGRIP
  41
  42
  43 // style flags for wxStatusBar fields
  44 #define wxSB_NORMAL    0x0000
  45 #define wxSB_FLAT      0x0001
  46 #define wxSB_RAISED    0x0002
  47 #define wxSB_SUNKEN    0x0003
  48
  49 // ----------------------------------------------------------------------------
  50 // wxStatusBarPane: an helper for wxStatusBar
  51 // ----------------------------------------------------------------------------
  52
  53 class WXDLLIMPEXP_CORE wxStatusBarPane
  54 {
  55 public:
  56     wxStatusBarPane(int style = wxSB_NORMAL, int width = 0)
  57         : m_nStyle(style), m_nWidth(width)
  58         { m_bEllipsized = false; }
  59
  60     int GetWidth() const { return m_nWidth; }
  61     int GetStyle() const { return m_nStyle; }
  62     wxString GetText() const { return m_text; }
  63
  64
  65     // implementation-only from now on
  66     // -------------------------------
  67
  68     bool IsEllipsized() const
  69         { return m_bEllipsized; }
  70     void SetIsEllipsized(bool isEllipsized) { m_bEllipsized = isEllipsized; }
  71
  72     void SetWidth(int width) { m_nWidth = width; }
  73     void SetStyle(int style) { m_nStyle = style; }
  74
  75     // set text, return true if it changed or false if it was already set to
  76     // this value
  77     bool SetText(const wxString& text);
  78
  79     // save the existing text on top of our stack and make the new text
  80     // current; return true if the text really changed
  81     bool PushText(const wxString& text);
  82
  83     // restore the message saved by the last call to Push() (unless it was
  84     // changed by an intervening call to SetText()) and return true if we
  85     // really restored anything
  86     bool PopText();
  87
  88 private:
  89     int m_nStyle;
  90     int m_nWidth;     // may be negative, indicating a variable-width field
  91     wxString m_text;
  92
  93     // the array used to keep the previous values of this pane after a
  94     // PushStatusText() call, its top element is the value to restore after the
  95     // next PopStatusText() call while the currently shown value is always in
  96     // m_text
  97     wxArrayString m_arrStack;
  98
  99     // is the currently shown value shown with ellipsis in the status bar?
 100     bool m_bEllipsized;
 101 };
 102
 103 WX_DECLARE_EXPORTED_OBJARRAY(wxStatusBarPane, wxStatusBarPaneArray);
 104
 105 // ----------------------------------------------------------------------------
 106 // wxStatusBar: a window near the bottom of the frame used for status info
 107 // ----------------------------------------------------------------------------
 108
 109 class WXDLLIMPEXP_CORE wxStatusBarBase : public wxControl
 110 {
 111 public:
 112     wxStatusBarBase();
 113
 114     virtual ~wxStatusBarBase();
 115
 116     // field count
 117     // -----------
 118
 119     // set the number of fields and call SetStatusWidths(widths) if widths are
 120     // given
 121     virtual void SetFieldsCount(int number = 1, const int *widths = NULL);
 122     int GetFieldsCount() const { return (int)m_panes.GetCount(); }
 123
 124     // field text
 125     // ----------
 126
 127     // just change or get the currently shown text
 128     void SetStatusText(const wxString& text, int number = 0);
 129     wxString GetStatusText(int number = 0) const;
 130
 131     // change the currently shown text to the new one and save the current
 132     // value to be restored by the next call to PopStatusText()
 133     void PushStatusText(const wxString& text, int number = 0);
 134     void PopStatusText(int number = 0);
 135
 136     // fields widths
 137     // -------------
 138
 139     // set status field widths as absolute numbers: positive widths mean that
 140     // the field has the specified absolute width, negative widths are
 141     // interpreted as the sizer options, i.e. the extra space (total space
 142     // minus the sum of fixed width fields) is divided between the fields with
 143     // negative width according to the abs value of the width (field with width
 144     // -2 grows twice as much as one with width -1 &c)
 145     virtual void SetStatusWidths(int n, const int widths[]);
 146
 147     int GetStatusWidth(int n) const
 148         { return m_panes[n].GetWidth(); }
 149
 150     // field styles
 151     // ------------
 152
 153     // Set the field border style to one of wxSB_XXX values.
 154     virtual void SetStatusStyles(int n, const int styles[]);
 155
 156     int GetStatusStyle(int n) const
 157         { return m_panes[n].GetStyle(); }
 158
 159     // geometry
 160     // --------
 161
 162     // Get the position and size of the field's internal bounding rectangle
 163     virtual bool GetFieldRect(int i, wxRect& rect) const = 0;
 164
 165     // sets the minimal vertical size of the status bar
 166     virtual void SetMinHeight(int height) = 0;
 167
 168     // get the dimensions of the horizontal and vertical borders
 169     virtual int GetBorderX() const = 0;
 170     virtual int GetBorderY() const = 0;
 171
 172     wxSize GetBorders() const
 173         { return wxSize(GetBorderX(), GetBorderY()); }
 174
 175     // miscellaneous
 176     // -------------
 177
 178     const wxStatusBarPane& GetField(int n) const
 179         { return m_panes[n]; }
 180
 181     // wxWindow overrides:
 182
 183     // don't want status bars to accept the focus at all
 184     virtual bool AcceptsFocus() const { return false; }
 185
 186     // the client size of a toplevel window doesn't include the status bar
 187     virtual bool CanBeOutsideClientArea() const { return true; }
 188
 189 protected:
 190     // called after the status bar pane text changed and should update its
 191     // display
 192     virtual void DoUpdateStatusText(int number) = 0;
 193
 194
 195     // wxWindow overrides:
 196
 197 #if wxUSE_TOOLTIPS
 198    virtual void DoSetToolTip( wxToolTip *tip )
 199         {
 200             wxASSERT_MSG(!HasFlag(wxSTB_SHOW_TIPS),
 201                          "Do not set tooltip(s) manually when using wxSTB_SHOW_TIPS!");
 202             wxWindow::DoSetToolTip(tip);
 203         }
 204 #endif // wxUSE_TOOLTIPS
 205     virtual wxBorder GetDefaultBorder() const { return wxBORDER_NONE; }
 206
 207
 208     // internal helpers & data:
 209
 210     // calculate the real field widths for the given total available size
 211     wxArrayInt CalculateAbsWidths(wxCoord widthTotal) const;
 212
 213     // should be called to remember if the pane text is currently being show
 214     // ellipsized or not
 215     void SetEllipsizedFlag(int n, bool isEllipsized);
 216
 217
 218     // the array with the pane infos:
 219     wxStatusBarPaneArray m_panes;
 220
 221     // if true overrides the width info of the wxStatusBarPanes
 222     bool m_bSameWidthForAllPanes;
 223
 224     wxDECLARE_NO_COPY_CLASS(wxStatusBarBase);
 225 };
 226
 227 // ----------------------------------------------------------------------------
 228 // include the actual wxStatusBar class declaration
 229 // ----------------------------------------------------------------------------
 230
 231 #if defined(__WXUNIVERSAL__)
 232     #define wxStatusBarUniv wxStatusBar
 233     #include "wx/univ/statusbr.h"
 234 #elif defined(__WXMSW__) && wxUSE_NATIVE_STATUSBAR
 235     #include "wx/msw/statusbar.h"
 236 #elif defined(__WXMAC__)
 237     #define wxStatusBarMac wxStatusBar
 238     #include "wx/generic/statusbr.h"
 239     #include "wx/osx/statusbr.h"
 240 #else
 241     #define wxStatusBarGeneric wxStatusBar
 242     #include "wx/generic/statusbr.h"
 243 #endif
 244
 245 #endif // wxUSE_STATUSBAR
 246
 247 #endif
 248     // _WX_STATUSBR_H_BASE_