]> git.saurik.com Git - wxWidgets.git/blob - src/msw/statbr95.cpp
final sweep over docs - replace & with \&
[wxWidgets.git] / src / msw / statbr95.cpp
1 ///////////////////////////////////////////////////////////////////////////////
2 // Name: msw/statbr95.cpp
3 // Purpose: native implementation of wxStatusBar
4 // Author: Vadim Zeitlin
5 // Modified by:
6 // Created: 04.04.98
7 // RCS-ID: $Id$
8 // Copyright: (c) 1998 Vadim Zeitlin <zeitlin@dptmaths.ens-cachan.fr>
9 // Licence: wxWindows licence
10 ///////////////////////////////////////////////////////////////////////////////
11
12 #if defined(__GNUG__) && !defined(NO_GCC_PRAGMA)
13 #pragma implementation "statbr95.h"
14 #endif
15
16 // for compilers that support precompilation, includes "wx.h".
17 #include "wx/wxprec.h"
18
19 #ifdef __BORLANDC__
20 #pragma hdrstop
21 #endif
22
23 #ifndef WX_PRECOMP
24 #include "wx/setup.h"
25 #include "wx/frame.h"
26 #include "wx/settings.h"
27 #include "wx/dcclient.h"
28 #endif
29
30 #if wxUSE_STATUSBAR && defined(__WIN95__) && wxUSE_NATIVE_STATUSBAR
31
32 #include "wx/intl.h"
33 #include "wx/log.h"
34 #include "wx/statusbr.h"
35
36 #include "wx/msw/private.h"
37 #include <windowsx.h>
38
39 #if defined(__WIN95__) && !(defined(__GNUWIN32_OLD__) && !defined(__CYGWIN10__))
40 #include <commctrl.h>
41 #endif
42
43 // ----------------------------------------------------------------------------
44 // macros
45 // ----------------------------------------------------------------------------
46
47 // windowsx.h and commctrl.h don't define those, so we do it here
48 #define StatusBar_SetParts(h, n, w) SendMessage(h, SB_SETPARTS, (WPARAM)n, (LPARAM)w)
49 #define StatusBar_SetText(h, n, t) SendMessage(h, SB_SETTEXT, (WPARAM)n, (LPARAM)(LPCTSTR)t)
50 #define StatusBar_GetTextLen(h, n) LOWORD(SendMessage(h, SB_GETTEXTLENGTH, (WPARAM)n, 0))
51 #define StatusBar_GetText(h, n, s) LOWORD(SendMessage(h, SB_GETTEXT, (WPARAM)n, (LPARAM)(LPTSTR)s))
52
53 // ============================================================================
54 // implementation
55 // ============================================================================
56
57 // ----------------------------------------------------------------------------
58 // wxStatusBar95 class
59 // ----------------------------------------------------------------------------
60
61 wxStatusBar95::wxStatusBar95()
62 {
63 SetParent(NULL);
64 m_hWnd = 0;
65 m_windowId = 0;
66 }
67
68 bool wxStatusBar95::Create(wxWindow *parent,
69 wxWindowID id,
70 long style,
71 const wxString& name)
72 {
73 wxCHECK_MSG( parent, false, wxT("status bar must have a parent") );
74
75 SetName(name);
76 SetWindowStyleFlag(style);
77 SetParent(parent);
78
79 parent->AddChild(this);
80
81 m_windowId = id == wxID_ANY ? NewControlId() : id;
82
83 DWORD wstyle = WS_CHILD | WS_VISIBLE;
84
85 if ( style & wxCLIP_SIBLINGS )
86 wstyle |= WS_CLIPSIBLINGS;
87
88 // setting SBARS_SIZEGRIP is perfectly useless: it's always on by default
89 // (at least in the version of comctl32.dll I'm using), and the only way to
90 // turn it off is to use CCS_TOP style - as we position the status bar
91 // manually anyhow (see DoMoveWindow), use CCS_TOP style if wxST_SIZEGRIP
92 // is not given
93 if ( !(style & wxST_SIZEGRIP) )
94 {
95 wstyle |= CCS_TOP;
96 }
97 else
98 {
99 #ifndef __WXWINCE__
100 // may be some versions of comctl32.dll do need it - anyhow, it won't
101 // do any harm
102 wstyle |= SBARS_SIZEGRIP;
103 #endif
104 }
105
106 m_hWnd = (WXHWND)CreateStatusWindow(wstyle,
107 wxEmptyString,
108 GetHwndOf(parent),
109 m_windowId);
110 if ( m_hWnd == 0 )
111 {
112 wxLogSysError(_("Failed to create a status bar."));
113
114 return false;
115 }
116
117 SetFieldsCount(1);
118 SubclassWin(m_hWnd);
119 InheritAttributes();
120
121 SetBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_MENUBAR));
122
123 // we must refresh the frame size when the statusbar is created, because
124 // its client area might change
125 wxFrame *frame = wxDynamicCast(GetParent(), wxFrame);
126 if ( frame )
127 {
128 frame->SendSizeEvent();
129 }
130
131 return true;
132 }
133
134 wxStatusBar95::~wxStatusBar95()
135 {
136 // we must refresh the frame size when the statusbar is deleted but the
137 // frame is not - otherwise statusbar leaves a hole in the place it used to
138 // occupy
139 wxFrame *frame = wxDynamicCast(GetParent(), wxFrame);
140 if ( frame && !frame->IsBeingDeleted() )
141 {
142 frame->SendSizeEvent();
143 }
144 }
145
146 void wxStatusBar95::SetFieldsCount(int nFields, const int *widths)
147 {
148 // this is a Windows limitation
149 wxASSERT_MSG( (nFields > 0) && (nFields < 255), _T("too many fields") );
150
151 wxStatusBarBase::SetFieldsCount(nFields, widths);
152
153 SetFieldsWidth();
154 }
155
156 void wxStatusBar95::SetStatusWidths(int n, const int widths[])
157 {
158 wxStatusBarBase::SetStatusWidths(n, widths);
159
160 SetFieldsWidth();
161 }
162
163 void wxStatusBar95::SetFieldsWidth()
164 {
165 if ( !m_nFields )
166 return;
167
168 int aBorders[3];
169 SendMessage(GetHwnd(), SB_GETBORDERS, 0, (LPARAM)aBorders);
170
171 int extraWidth = aBorders[2]; // space between fields
172
173 wxArrayInt widthsAbs =
174 CalculateAbsWidths(GetClientSize().x - extraWidth*(m_nFields - 1));
175
176 int *pWidths = new int[m_nFields];
177
178 int nCurPos = 0;
179 for ( int i = 0; i < m_nFields; i++ ) {
180 nCurPos += widthsAbs[i] + extraWidth;
181 pWidths[i] = nCurPos;
182 }
183
184 if ( !StatusBar_SetParts(GetHwnd(), m_nFields, pWidths) ) {
185 wxLogLastError(wxT("StatusBar_SetParts"));
186 }
187
188 delete [] pWidths;
189 }
190
191 void wxStatusBar95::SetStatusText(const wxString& strText, int nField)
192 {
193 wxCHECK_RET( (nField >= 0) && (nField < m_nFields),
194 _T("invalid statusbar field index") );
195
196 // Get field style, if any
197 int style;
198 if (m_statusStyles)
199 {
200 switch(m_statusStyles[nField])
201 {
202 case wxSB_RAISED:
203 style = SBT_POPOUT;
204 break;
205 case wxSB_FLAT:
206 style = SBT_NOBORDERS;
207 break;
208 case wxSB_NORMAL:
209 default:
210 style = 0;
211 break;
212 }
213 }
214 else
215 style = 0;
216
217 // Pass both field number and style. MSDN library doesn't mention
218 // that nField and style have to be 'ORed'
219 if ( !StatusBar_SetText(GetHwnd(), nField | style, strText) )
220 {
221 wxLogLastError(wxT("StatusBar_SetText"));
222 }
223 }
224
225 wxString wxStatusBar95::GetStatusText(int nField) const
226 {
227 wxCHECK_MSG( (nField >= 0) && (nField < m_nFields), wxEmptyString,
228 _T("invalid statusbar field index") );
229
230 wxString str;
231 int len = StatusBar_GetTextLen(GetHwnd(), nField);
232 if ( len > 0 )
233 {
234 StatusBar_GetText(GetHwnd(), nField, wxStringBuffer(str, len));
235 }
236
237 return str;
238 }
239
240 int wxStatusBar95::GetBorderX() const
241 {
242 int aBorders[3];
243 SendMessage(GetHwnd(), SB_GETBORDERS, 0, (LPARAM)aBorders);
244
245 return aBorders[0];
246 }
247
248 int wxStatusBar95::GetBorderY() const
249 {
250 int aBorders[3];
251 SendMessage(GetHwnd(), SB_GETBORDERS, 0, (LPARAM)aBorders);
252
253 return aBorders[1];
254 }
255
256 void wxStatusBar95::SetMinHeight(int height)
257 {
258 SendMessage(GetHwnd(), SB_SETMINHEIGHT, height + 2*GetBorderY(), 0);
259
260 // have to send a (dummy) WM_SIZE to redraw it now
261 SendMessage(GetHwnd(), WM_SIZE, 0, 0);
262 }
263
264 bool wxStatusBar95::GetFieldRect(int i, wxRect& rect) const
265 {
266 wxCHECK_MSG( (i >= 0) && (i < m_nFields), false,
267 _T("invalid statusbar field index") );
268
269 RECT r;
270 if ( !::SendMessage(GetHwnd(), SB_GETRECT, i, (LPARAM)&r) )
271 {
272 wxLogLastError(wxT("SendMessage(SB_GETRECT)"));
273 }
274
275 wxCopyRECTToRect(r, rect);
276
277 return true;
278 }
279
280 void wxStatusBar95::DoMoveWindow(int x, int y, int width, int height)
281 {
282 // the status bar wnd proc must be forwarded the WM_SIZE message whenever
283 // the stat bar position/size is changed because it normally positions the
284 // control itself along bottom or top side of the parent window - failing
285 // to do so will result in nasty visual effects
286 FORWARD_WM_SIZE(GetHwnd(), SIZE_RESTORED, x, y, SendMessage);
287
288 // but now, when the standard status bar wnd proc did all it wanted to do,
289 // move the status bar to its correct location - usually this call may be
290 // omitted because for normal status bars (positioned along the bottom
291 // edge) the position is already set correctly, but if the user wants to
292 // position them in some exotic location, this is really needed
293 wxWindowMSW::DoMoveWindow(x, y, width, height);
294
295 // adjust fields widths to the new size
296 SetFieldsWidth();
297
298 // we have to trigger wxSizeEvent if there are children window in status
299 // bar because GetFieldRect returned incorrect (not updated) values up to
300 // here, which almost certainly resulted in incorrectly redrawn statusbar
301 if ( m_children.GetCount() > 0 )
302 {
303 wxSizeEvent event(GetClientSize(), m_windowId);
304 event.SetEventObject(this);
305 GetEventHandler()->ProcessEvent(event);
306 }
307 }
308
309 void wxStatusBar95::SetStatusStyles(int n, const int styles[])
310 {
311 wxStatusBarBase::SetStatusStyles(n, styles);
312
313 if (n != m_nFields)
314 return;
315
316 for (int i = 0; i < n; i++)
317 {
318 int style;
319 switch(styles[i])
320 {
321 case wxSB_RAISED:
322 style = SBT_POPOUT;
323 break;
324 case wxSB_FLAT:
325 style = SBT_NOBORDERS;
326 break;
327 case wxSB_NORMAL:
328 default:
329 style = 0;
330 break;
331 }
332 // The SB_SETTEXT message is both used to set the field's text as well as
333 // the fields' styles. MSDN library doesn't mention
334 // that nField and style have to be 'ORed'
335 wxString text = GetStatusText(i);
336 if (!StatusBar_SetText(GetHwnd(), style | i, text))
337 {
338 wxLogLastError(wxT("StatusBar_SetText"));
339 }
340 }
341 }
342
343 #endif // __WIN95__ && wxUSE_NATIVE_STATUSBAR
344