// Licence: wxWindows licence
///////////////////////////////////////////////////////////////////////////////
+// ============================================================================
+// declarations
+// ============================================================================
+
+// ----------------------------------------------------------------------------
+// headers
+// ----------------------------------------------------------------------------
+
// for compilers that support precompilation, includes "wx.h".
#include "wx/wxprec.h"
#include "wx/dcclient.h"
#include "wx/intl.h"
#include "wx/log.h"
+ #include "wx/control.h"
#endif
#include "wx/msw/private.h"
+#include "wx/tooltip.h"
#include <windowsx.h>
#if wxUSE_UXTHEME
#include "wx/msw/uxtheme.h"
#endif
+// ----------------------------------------------------------------------------
+// constants
+// ----------------------------------------------------------------------------
+
+namespace
+{
+
+// no idea for a default width, just choose something
+static const int DEFAULT_FIELD_WIDTH = 25;
+
+} // anonymous namespace
+
// ----------------------------------------------------------------------------
// macros
// ----------------------------------------------------------------------------
SetParent(NULL);
m_hWnd = 0;
m_windowId = 0;
+ m_pDC = NULL;
}
bool wxStatusBar::Create(wxWindow *parent,
long style,
const wxString& name)
{
- wxCHECK_MSG( parent, false, wxT("status bar must have a parent") );
+ wxCHECK_MSG( parent, false, "status bar must have a parent" );
SetName(name);
SetWindowStyleFlag(style);
if ( style & wxCLIP_SIBLINGS )
wstyle |= WS_CLIPSIBLINGS;
+ // wxSTB_SIZEGRIP is part of our default style but it doesn't make sense to
+ // show size grip if this is the status bar of a non-resizeable TLW so turn
+ // it off in such case
+ if ( parent->IsTopLevel() && !parent->HasFlag(wxRESIZE_BORDER) )
+ style &= ~wxSTB_SIZEGRIP;
+
// setting SBARS_SIZEGRIP is perfectly useless: it's always on by default
// (at least in the version of comctl32.dll I'm using), and the only way to
// turn it off is to use CCS_TOP style - as we position the status bar
- // manually anyhow (see DoMoveWindow), use CCS_TOP style if wxST_SIZEGRIP
+ // manually anyhow (see DoMoveWindow), use CCS_TOP style if wxSTB_SIZEGRIP
// is not given
- if ( !(style & wxST_SIZEGRIP) )
+ if ( !(style & wxSTB_SIZEGRIP) )
{
wstyle |= CCS_TOP;
}
m_hWnd = CreateWindow
(
STATUSCLASSNAME,
- _T(""),
+ wxT(""),
wstyle,
0, 0, 0, 0,
GetHwndOf(parent),
SetFieldsCount(1);
SubclassWin(m_hWnd);
+
+ // cache the DC instance used by DoUpdateStatusText:
+ // NOTE: create the DC before calling InheritAttributes() since
+ // it may result in a call to our SetFont()
+ m_pDC = new wxClientDC(this);
+
InheritAttributes();
SetBackgroundColour(wxSystemSettings::GetColour(wxSYS_COLOUR_MENUBAR));
// frame is not - otherwise statusbar leaves a hole in the place it used to
// occupy
PostSizeEventToParent();
+
+ // delete existing tooltips
+ for (size_t i=0; i<m_tooltips.size(); i++)
+ {
+ wxDELETE(m_tooltips[i]);
+ }
+
+ wxDELETE(m_pDC);
+}
+
+bool wxStatusBar::SetFont(const wxFont& font)
+{
+ if (!wxWindow::SetFont(font))
+ return false;
+
+ if (m_pDC) m_pDC->SetFont(font);
+ return true;
}
void wxStatusBar::SetFieldsCount(int nFields, const int *widths)
{
// this is a Windows limitation
- wxASSERT_MSG( (nFields > 0) && (nFields < 255), _T("too many fields") );
+ wxASSERT_MSG( (nFields > 0) && (nFields < 255), "too many fields" );
wxStatusBarBase::SetFieldsCount(nFields, widths);
- SetFieldsWidth();
+ MSWUpdateFieldsWidths();
+
+ // keep in synch also our m_tooltips array
+
+ // reset all current tooltips
+ for (size_t i=0; i<m_tooltips.size(); i++)
+ {
+ wxDELETE(m_tooltips[i]);
+ }
+
+ // shrink/expand the array:
+ m_tooltips.resize(m_panes.GetCount(), NULL);
}
void wxStatusBar::SetStatusWidths(int n, const int widths[])
{
wxStatusBarBase::SetStatusWidths(n, widths);
- SetFieldsWidth();
+ MSWUpdateFieldsWidths();
}
-void wxStatusBar::SetFieldsWidth()
+void wxStatusBar::MSWUpdateFieldsWidths()
{
if ( m_panes.IsEmpty() )
return;
- int aBorders[3];
- SendMessage(GetHwnd(), SB_GETBORDERS, 0, (LPARAM)aBorders);
+ const int count = m_panes.GetCount();
+
+ const int extraWidth = MSWGetBorderWidth() + MSWGetMetrics().textMargin;
+
+ // compute the effectively available amount of space:
+ int widthAvailable = GetClientSize().x; // start with the entire width
+ widthAvailable -= extraWidth*(count - 1); // extra space between fields
+ widthAvailable -= MSWGetMetrics().textMargin; // and for the last field
+
+ if ( HasFlag(wxSTB_SIZEGRIP) )
+ widthAvailable -= MSWGetMetrics().gripWidth;
- int extraWidth = aBorders[2]; // space between fields
+ // distribute the available space (client width) among the various fields:
- wxArrayInt widthsAbs =
- CalculateAbsWidths(GetClientSize().x - extraWidth*(m_panes.GetCount() - 1));
+ wxArrayInt widthsAbs = CalculateAbsWidths(widthAvailable);
- int *pWidths = new int[m_panes.GetCount()];
+
+ // update the field widths in the native control:
+
+ int *pWidths = new int[count];
int nCurPos = 0;
- for ( size_t i = 0; i < m_panes.GetCount(); i++ ) {
+ for ( int i = 0; i < count; i++ )
+ {
nCurPos += widthsAbs[i] + extraWidth;
pWidths[i] = nCurPos;
}
- if ( !StatusBar_SetParts(GetHwnd(), m_panes.GetCount(), pWidths) ) {
- wxLogLastError(wxT("StatusBar_SetParts"));
+ if ( !StatusBar_SetParts(GetHwnd(), count, pWidths) )
+ {
+ wxLogLastError("StatusBar_SetParts");
}
delete [] pWidths;
+
+
+ // FIXME: we may want to call DoUpdateStatusText() here since we may need to (de)ellipsize status texts
}
-void wxStatusBar::SetStatusText(const wxString& strText, int nField)
+void wxStatusBar::DoUpdateStatusText(int nField)
{
- wxCHECK_RET( (nField >= 0) && ((size_t)nField < m_panes.GetCount()),
- _T("invalid statusbar field index") );
-
- if ( strText == GetStatusText(nField) )
- {
- // don't call StatusBar_SetText() to avoid flicker
- return;
- }
+ if (!m_pDC)
+ return;
// Get field style, if any
int style;
- switch(m_panes[nField].nStyle)
+ switch(m_panes[nField].GetStyle())
{
case wxSB_RAISED:
style = SBT_POPOUT;
break;
}
- // Pass both field number and style. MSDN library doesn't mention
- // that nField and style have to be 'ORed'
- if ( !StatusBar_SetText(GetHwnd(), nField | style, strText.wx_str()) )
+ wxRect rc;
+ GetFieldRect(nField, rc);
+
+ const int maxWidth = rc.GetWidth() - MSWGetMetrics().textMargin;
+
+ wxString text = GetStatusText(nField);
+
+ // do we need to ellipsize this string?
+ wxEllipsizeMode ellmode = (wxEllipsizeMode)-1;
+ if (HasFlag(wxSTB_ELLIPSIZE_START)) ellmode = wxELLIPSIZE_START;
+ else if (HasFlag(wxSTB_ELLIPSIZE_MIDDLE)) ellmode = wxELLIPSIZE_MIDDLE;
+ else if (HasFlag(wxSTB_ELLIPSIZE_END)) ellmode = wxELLIPSIZE_END;
+
+ if (ellmode == (wxEllipsizeMode)-1)
{
- wxLogLastError(wxT("StatusBar_SetText"));
+ // if we have the wxSTB_SHOW_TIPS we must set the ellipsized flag even if
+ // we don't ellipsize the text but just truncate it
+ if (HasFlag(wxSTB_SHOW_TIPS))
+ SetEllipsizedFlag(nField, m_pDC->GetTextExtent(text).GetWidth() > maxWidth);
+ }
+ else
+ {
+ text = wxControl::Ellipsize(text,
+ *m_pDC,
+ ellmode,
+ maxWidth,
+ wxELLIPSIZE_FLAGS_EXPAND_TABS);
+
+ // update the ellipsization status for this pane; this is used later to
+ // decide whether a tooltip should be shown or not for this pane
+ // (if we have wxSTB_SHOW_TIPS)
+ SetEllipsizedFlag(nField, text != GetStatusText(nField));
}
-}
-
-wxString wxStatusBar::GetStatusText(int nField) const
-{
- wxCHECK_MSG( (nField >= 0) && ((size_t)nField < m_panes.GetCount()), wxEmptyString,
- _T("invalid statusbar field index") );
- wxString str;
- int len = StatusBar_GetTextLen(GetHwnd(), nField);
- if ( len > 0 )
+ // Set the status text in the native control passing both field number and style.
+ // NOTE: MSDN library doesn't mention that nField and style have to be 'ORed'
+ if ( !StatusBar_SetText(GetHwnd(), nField | style, text.wx_str()) )
{
- StatusBar_GetText(GetHwnd(), nField, wxStringBuffer(str, len));
+ wxLogLastError("StatusBar_SetText");
}
- return str;
+ if (HasFlag(wxSTB_SHOW_TIPS))
+ {
+ wxASSERT(m_tooltips.size() == m_panes.GetCount());
+
+ if (m_tooltips[nField])
+ {
+ if (GetField(nField).IsEllipsized())
+ {
+ // update the rect of this tooltip:
+ m_tooltips[nField]->SetRect(rc);
+
+ // update also the text:
+ m_tooltips[nField]->SetTip(GetStatusText(nField));
+ }
+ else
+ {
+ // delete the tooltip associated with this pane; it's not needed anymore
+ wxDELETE(m_tooltips[nField]);
+ }
+ }
+ else
+ {
+ // create a new tooltip for this pane if needed
+ if (GetField(nField).IsEllipsized())
+ m_tooltips[nField] = new wxToolTip(this, nField, GetStatusText(nField), rc);
+ //else: leave m_tooltips[nField]==NULL
+ }
+ }
}
-int wxStatusBar::GetBorderX() const
+wxStatusBar::MSWBorders wxStatusBar::MSWGetBorders() const
{
int aBorders[3];
SendMessage(GetHwnd(), SB_GETBORDERS, 0, (LPARAM)aBorders);
- return aBorders[0];
+ MSWBorders borders;
+ borders.horz = aBorders[0];
+ borders.vert = aBorders[1];
+ borders.between = aBorders[2];
+ return borders;
+}
+
+int wxStatusBar::GetBorderX() const
+{
+ return MSWGetBorders().horz;
}
int wxStatusBar::GetBorderY() const
{
- int aBorders[3];
- SendMessage(GetHwnd(), SB_GETBORDERS, 0, (LPARAM)aBorders);
+ return MSWGetBorders().vert;
+}
+
+int wxStatusBar::MSWGetBorderWidth() const
+{
+ return MSWGetBorders().between;
+}
+
+/* static */
+const wxStatusBar::MSWMetrics& wxStatusBar::MSWGetMetrics()
+{
+ static MSWMetrics s_metrics = { 0 };
+ if ( !s_metrics.textMargin )
+ {
+ // Grip size should be self explanatory (the only problem with it is
+ // that it's hard coded as we don't know how to find its size using
+ // API) but the margin might merit an explanation: Windows offsets the
+ // text drawn in status bar panes so we need to take this extra margin
+ // into account to make sure the text drawn by user fits inside the
+ // pane. Notice that it's not the value returned by SB_GETBORDERS
+ // which, at least on this Windows 2003 system, returns {0, 2, 2}
+ if ( wxUxThemeEngine::GetIfActive() )
+ {
+ s_metrics.gripWidth = 20;
+ s_metrics.textMargin = 8;
+ }
+ else // classic/unthemed look
+ {
+ s_metrics.gripWidth = 18;
+ s_metrics.textMargin = 4;
+ }
+ }
- return aBorders[1];
+ return s_metrics;
}
void wxStatusBar::SetMinHeight(int height)
{
SendMessage(GetHwnd(), SB_SETMINHEIGHT, height + 2*GetBorderY(), 0);
- // have to send a (dummy) WM_SIZE to redraw it now
+ // we have to send a (dummy) WM_SIZE to redraw it now
SendMessage(GetHwnd(), WM_SIZE, 0, 0);
}
bool wxStatusBar::GetFieldRect(int i, wxRect& rect) const
{
wxCHECK_MSG( (i >= 0) && ((size_t)i < m_panes.GetCount()), false,
- _T("invalid statusbar field index") );
+ "invalid statusbar field index" );
RECT r;
if ( !::SendMessage(GetHwnd(), SB_GETRECT, i, (LPARAM)&r) )
{
- wxLogLastError(wxT("SendMessage(SB_GETRECT)"));
+ wxLogLastError("SendMessage(SB_GETRECT)");
}
#if wxUSE_UXTHEME
- wxUxThemeHandle theme((wxStatusBar *)this, L"Status"); // const_cast
+ wxUxThemeHandle theme(const_cast<wxStatusBar*>(this), L"Status");
if ( theme )
{
// by default Windows has a 2 pixel border to the right of the left
wxCopyRECTToRect(r, rect);
+ // Windows seems to under-report the size of the last field rectangle,
+ // presumably in order to prevent the buggy applications from overflowing
+ // onto the size grip but we want to return the real size to wx users
+ if ( HasFlag(wxSTB_SIZEGRIP) && i == (int)m_panes.GetCount() - 1 )
+ {
+ rect.width += MSWGetMetrics().gripWidth - MSWGetBorderWidth();
+ }
+
return true;
}
-// no idea for a default width, just choose something
-#define DEFAULT_FIELD_WIDTH 25
-
wxSize wxStatusBar::DoGetBestSize() const
{
- int borders[3];
- SendMessage(GetHwnd(), SB_GETBORDERS, 0, (LPARAM)borders);
+ const MSWBorders borders = MSWGetBorders();
// calculate width
int width = 0;
for ( size_t i = 0; i < m_panes.GetCount(); ++i )
{
int widthField =
- m_bSameWidthForAllPanes ? DEFAULT_FIELD_WIDTH : m_panes[i].nWidth;
+ m_bSameWidthForAllPanes ? DEFAULT_FIELD_WIDTH : m_panes[i].GetWidth();
if ( widthField >= 0 )
{
width += widthField;
}
// add the space between fields
- width += borders[2];
+ width += borders.between;
}
if ( !width )
width = 2*DEFAULT_FIELD_WIDTH;
}
-
// calculate height
int height;
wxGetCharSize(GetHWND(), NULL, &height, GetFont());
height = EDIT_HEIGHT_FROM_CHAR_HEIGHT(height);
- height += borders[1];
+ height += borders.vert;
wxSize best(width, height);
CacheBestSize(best);
}
// adjust fields widths to the new size
- SetFieldsWidth();
+ MSWUpdateFieldsWidths();
// we have to trigger wxSizeEvent if there are children window in status
// bar because GetFieldRect returned incorrect (not updated) values up to
style = 0;
break;
}
+
// The SB_SETTEXT message is both used to set the field's text as well as
- // the fields' styles. MSDN library doesn't mention
- // that nField and style have to be 'ORed'
+ // the fields' styles.
+ // NOTE: MSDN library doesn't mention that nField and style have to be 'ORed'
wxString text = GetStatusText(i);
if (!StatusBar_SetText(GetHwnd(), style | i, text.wx_str()))
{
- wxLogLastError(wxT("StatusBar_SetText"));
+ wxLogLastError("StatusBar_SetText");
}
}
}
}
#endif
+ bool needsEllipsization = HasFlag(wxSTB_ELLIPSIZE_START) ||
+ HasFlag(wxSTB_ELLIPSIZE_MIDDLE) ||
+ HasFlag(wxSTB_ELLIPSIZE_END);
+ if ( nMsg == WM_SIZE && needsEllipsization )
+ {
+ for (int i=0; i<GetFieldsCount(); i++)
+ DoUpdateStatusText(i);
+ // re-set the field text, in case we need to ellipsize
+ // (or de-ellipsize) some parts of it
+ }
+
return wxStatusBarBase::MSWWindowProc(nMsg, wParam, lParam);
}
+#if wxUSE_TOOLTIPS
+bool wxStatusBar::MSWProcessMessage(WXMSG* pMsg)
+{
+ if ( HasFlag(wxSTB_SHOW_TIPS) )
+ {
+ // for a tooltip to be shown, we need to relay mouse events to it;
+ // this is typically done by wxWindowMSW::MSWProcessMessage but only
+ // if wxWindow::m_tooltip pointer is non-NULL.
+ // Since wxStatusBar has multiple tooltips for a single HWND, it keeps
+ // wxWindow::m_tooltip == NULL and then relays mouse events here:
+ MSG *msg = (MSG *)pMsg;
+ if ( msg->message == WM_MOUSEMOVE )
+ wxToolTip::RelayEvent(pMsg);
+ }
+
+ return wxWindow::MSWProcessMessage(pMsg);
+}
+
+bool wxStatusBar::MSWOnNotify(int WXUNUSED(idCtrl), WXLPARAM lParam, WXLPARAM* WXUNUSED(result))
+{
+ if ( HasFlag(wxSTB_SHOW_TIPS) )
+ {
+ // see comment in wxStatusBar::MSWProcessMessage for more info;
+ // basically we need to override wxWindow::MSWOnNotify because
+ // we have wxWindow::m_tooltip always NULL but we still use tooltips...
+
+ NMHDR* hdr = (NMHDR *)lParam;
+
+ wxString str;
+ if (hdr->idFrom < m_tooltips.size() && m_tooltips[hdr->idFrom])
+ str = m_tooltips[hdr->idFrom]->GetTip();
+
+ if ( HandleTooltipNotify(hdr->code, lParam, str))
+ {
+ // processed
+ return true;
+ }
+ }
+
+ return false;
+}
+#endif // wxUSE_TOOLTIPS
+
#endif // wxUSE_STATUSBAR && wxUSE_NATIVE_STATUSBAR