src/msw/stattext.cpp

   1 /////////////////////////////////////////////////////////////////////////////
   2 // Name:        src/msw/stattext.cpp
   3 // Purpose:     wxStaticText
   4 // Author:      Julian Smart
   5 // Modified by:
   6 // Created:     04/01/98
   7 // RCS-ID:      $Id$
   8 // Copyright:   (c) Julian Smart
   9 // Licence:     wxWindows licence
  10 /////////////////////////////////////////////////////////////////////////////
  11
  12 // For compilers that support precompilation, includes "wx.h".
  13 #include "wx/wxprec.h"
  14
  15 #ifdef __BORLANDC__
  16 #pragma hdrstop
  17 #endif
  18
  19 #if wxUSE_STATTEXT
  20
  21 #include "wx/stattext.h"
  22
  23 #ifndef WX_PRECOMP
  24     #include "wx/event.h"
  25     #include "wx/app.h"
  26     #include "wx/brush.h"
  27     #include "wx/dcclient.h"
  28     #include "wx/settings.h"
  29 #endif
  30
  31 #include "wx/msw/private.h"
  32
  33 #if wxUSE_EXTENDED_RTTI
  34 WX_DEFINE_FLAGS( wxStaticTextStyle )
  35
  36 wxBEGIN_FLAGS( wxStaticTextStyle )
  37     // new style border flags, we put them first to
  38     // use them for streaming out
  39     wxFLAGS_MEMBER(wxBORDER_SIMPLE)
  40     wxFLAGS_MEMBER(wxBORDER_SUNKEN)
  41     wxFLAGS_MEMBER(wxBORDER_DOUBLE)
  42     wxFLAGS_MEMBER(wxBORDER_RAISED)
  43     wxFLAGS_MEMBER(wxBORDER_STATIC)
  44     wxFLAGS_MEMBER(wxBORDER_NONE)
  45
  46     // old style border flags
  47     wxFLAGS_MEMBER(wxSIMPLE_BORDER)
  48     wxFLAGS_MEMBER(wxSUNKEN_BORDER)
  49     wxFLAGS_MEMBER(wxDOUBLE_BORDER)
  50     wxFLAGS_MEMBER(wxRAISED_BORDER)
  51     wxFLAGS_MEMBER(wxSTATIC_BORDER)
  52     wxFLAGS_MEMBER(wxBORDER)
  53
  54     // standard window styles
  55     wxFLAGS_MEMBER(wxTAB_TRAVERSAL)
  56     wxFLAGS_MEMBER(wxCLIP_CHILDREN)
  57     wxFLAGS_MEMBER(wxTRANSPARENT_WINDOW)
  58     wxFLAGS_MEMBER(wxWANTS_CHARS)
  59     wxFLAGS_MEMBER(wxFULL_REPAINT_ON_RESIZE)
  60     wxFLAGS_MEMBER(wxALWAYS_SHOW_SB )
  61     wxFLAGS_MEMBER(wxVSCROLL)
  62     wxFLAGS_MEMBER(wxHSCROLL)
  63
  64     wxFLAGS_MEMBER(wxST_NO_AUTORESIZE)
  65     wxFLAGS_MEMBER(wxALIGN_LEFT)
  66     wxFLAGS_MEMBER(wxALIGN_RIGHT)
  67     wxFLAGS_MEMBER(wxALIGN_CENTRE)
  68
  69 wxEND_FLAGS( wxStaticTextStyle )
  70
  71 IMPLEMENT_DYNAMIC_CLASS_XTI(wxStaticText, wxControl,"wx/stattext.h")
  72
  73 wxBEGIN_PROPERTIES_TABLE(wxStaticText)
  74     wxPROPERTY( Label,wxString, SetLabel, GetLabel, wxString() , 0 /*flags*/ , wxT("Helpstring") , wxT("group"))
  75     wxPROPERTY_FLAGS( WindowStyle , wxStaticTextStyle , long , SetWindowStyleFlag , GetWindowStyleFlag , EMPTY_MACROVALUE, 0 /*flags*/ , wxT("Helpstring") , wxT("group")) // style
  76 wxEND_PROPERTIES_TABLE()
  77
  78 wxBEGIN_HANDLERS_TABLE(wxStaticText)
  79 wxEND_HANDLERS_TABLE()
  80
  81 wxCONSTRUCTOR_6( wxStaticText , wxWindow* , Parent , wxWindowID , Id , wxString , Label , wxPoint , Position , wxSize , Size , long , WindowStyle )
  82 #else
  83 IMPLEMENT_DYNAMIC_CLASS(wxStaticText, wxControl)
  84 #endif
  85
  86 bool wxStaticText::Create(wxWindow *parent,
  87                           wxWindowID id,
  88                           const wxString& label,
  89                           const wxPoint& pos,
  90                           const wxSize& size,
  91                           long style,
  92                           const wxString& name)
  93 {
  94     if ( !CreateControl(parent, id, pos, size, style, wxDefaultValidator, name) )
  95         return false;
  96
  97     if ( !MSWCreateControl(wxT("STATIC"), wxEmptyString, pos, size) )
  98         return false;
  99
 100     // we set the label here and not through MSWCreateControl() because we
 101     // need to do many operation on it for ellipsization&markup support
 102     SetLabel(label);
 103
 104     // as we didn't pass the correct label to MSWCreateControl(), it didn't set
 105     // the initial size correctly -- do it now
 106     InvalidateBestSize();
 107     SetInitialSize(size);
 108
 109     // NOTE: if the label contains ampersand characters which are interpreted as
 110     //       accelerators, they will be rendered (at least on WinXP) only if the
 111     //       static text is placed inside a window class which correctly handles
 112     //       focusing by TAB traversal (e.g. wxPanel).
 113
 114     return true;
 115 }
 116
 117 WXDWORD wxStaticText::MSWGetStyle(long style, WXDWORD *exstyle) const
 118 {
 119     WXDWORD msStyle = wxControl::MSWGetStyle(style, exstyle);
 120
 121     // translate the alignment flags to the Windows ones
 122     //
 123     // note that both wxALIGN_LEFT and SS_LEFT are equal to 0 so we shouldn't
 124     // test for them using & operator
 125     if ( style & wxALIGN_CENTRE )
 126         msStyle |= SS_CENTER;
 127     else if ( style & wxALIGN_RIGHT )
 128         msStyle |= SS_RIGHT;
 129     else
 130         msStyle |= SS_LEFT;
 131
 132 #ifdef SS_ENDELLIPSIS
 133     // this style is necessary to receive mouse events
 134     // Win NT and later have the SS_ENDELLIPSIS style which is useful to us:
 135     if (wxGetOsVersion() == wxOS_WINDOWS_NT)
 136     {
 137         // for now, add the SS_ENDELLIPSIS style if wxST_ELLIPSIZE_END is given;
 138         // we may need to remove it later in ::SetLabel() if the given label
 139         // has newlines
 140         if ( style & wxST_ELLIPSIZE_END )
 141             msStyle |= SS_ENDELLIPSIS;
 142     }
 143 #endif // SS_ENDELLIPSIS
 144
 145     msStyle |= SS_NOTIFY;
 146
 147     return msStyle;
 148 }
 149
 150 wxSize wxStaticText::DoGetBestClientSize() const
 151 {
 152     wxClientDC dc(const_cast<wxStaticText *>(this));
 153     wxFont font(GetFont());
 154     if (!font.Ok())
 155         font = wxSystemSettings::GetFont(wxSYS_DEFAULT_GUI_FONT);
 156
 157     dc.SetFont(font);
 158
 159     wxCoord widthTextMax, heightTextTotal;
 160     dc.GetMultiLineTextExtent(GetLabelText(), &widthTextMax, &heightTextTotal);
 161
 162 #ifdef __WXWINCE__
 163     if ( widthTextMax )
 164         widthTextMax += 2;
 165 #endif // __WXWINCE__
 166
 167     return wxSize(widthTextMax, heightTextTotal);
 168 }
 169
 170 void wxStaticText::DoSetSize(int x, int y, int w, int h, int sizeFlags)
 171 {
 172     // note: we first need to set the size and _then_ call UpdateLabel
 173     wxStaticTextBase::DoSetSize(x, y, w, h, sizeFlags);
 174
 175 #ifdef SS_ENDELLIPSIS
 176     // do we need to ellipsize the contents?
 177     long styleReal = ::GetWindowLong(GetHwnd(), GWL_STYLE);
 178     if ( !(styleReal & SS_ENDELLIPSIS) )
 179     {
 180         // we don't have SS_ENDELLIPSIS style:
 181         // we need to (eventually) do ellipsization ourselves
 182         UpdateLabel();
 183     }
 184     //else: we don't or the OS will do it for us
 185 #endif // SS_ENDELLIPSIS
 186
 187     // we need to refresh the window after changing its size as the standard
 188     // control doesn't always update itself properly
 189     Refresh();
 190 }
 191
 192 void wxStaticText::SetLabel(const wxString& label)
 193 {
 194 #ifdef SS_ENDELLIPSIS
 195     long styleReal = ::GetWindowLong(GetHwnd(), GWL_STYLE);
 196     if ( HasFlag(wxST_ELLIPSIZE_END) &&
 197           wxGetOsVersion() == wxOS_WINDOWS_NT )
 198     {
 199         // adding SS_ENDELLIPSIS or SS_ENDELLIPSIS "disables" the correct
 200         // newline handling in static texts: the newlines in the labels are
 201         // shown as square. Thus we don't use it even on newer OS when
 202         // the static label contains a newline.
 203         if ( label.Contains(wxT('\n')) )
 204             styleReal &= ~SS_ENDELLIPSIS;
 205         else
 206             styleReal |= SS_ENDELLIPSIS;
 207
 208         ::SetWindowLong(GetHwnd(), GWL_STYLE, styleReal);
 209     }
 210     else // style not supported natively
 211     {
 212         styleReal &= ~SS_ENDELLIPSIS;
 213         ::SetWindowLong(GetHwnd(), GWL_STYLE, styleReal);
 214     }
 215 #endif // SS_ENDELLIPSIS
 216
 217     // save the label in m_labelOrig with both the markup (if any) and
 218     // the mnemonics characters (if any)
 219     m_labelOrig = label;
 220
 221 #ifdef SS_ENDELLIPSIS
 222     if ( styleReal & SS_ENDELLIPSIS )
 223         DoSetLabel(GetLabelWithoutMarkup());
 224     else
 225 #endif // SS_ENDELLIPSIS
 226         DoSetLabel(GetEllipsizedLabelWithoutMarkup());
 227
 228     // adjust the size of the window to fit to the label unless autoresizing is
 229     // disabled
 230     if ( !HasFlag(wxST_NO_AUTORESIZE) &&
 231          !IsEllipsized() )  // if ellipsize is ON, then we don't want to get resized!
 232     {
 233         InvalidateBestSize();
 234         DoSetSize(wxDefaultCoord, wxDefaultCoord, wxDefaultCoord, wxDefaultCoord,
 235                   wxSIZE_AUTO_WIDTH | wxSIZE_AUTO_HEIGHT);
 236     }
 237 }
 238
 239 bool wxStaticText::SetFont(const wxFont& font)
 240 {
 241     bool ret = wxControl::SetFont(font);
 242
 243     // adjust the size of the window to fit to the label unless autoresizing is
 244     // disabled
 245     if ( !HasFlag(wxST_NO_AUTORESIZE) )
 246     {
 247         InvalidateBestSize();
 248         DoSetSize(wxDefaultCoord, wxDefaultCoord, wxDefaultCoord, wxDefaultCoord,
 249                   wxSIZE_AUTO_WIDTH | wxSIZE_AUTO_HEIGHT);
 250     }
 251
 252     return ret;
 253 }
 254
 255 // for wxST_ELLIPSIZE_* support:
 256
 257 wxString wxStaticText::DoGetLabel() const
 258 {
 259     return wxGetWindowText(GetHwnd());
 260 }
 261
 262 void wxStaticText::DoSetLabel(const wxString& str)
 263 {
 264     SetWindowText(GetHwnd(), str.c_str());
 265 }
 266
 267
 268 #endif // wxUSE_STATTEXT