1 /////////////////////////////////////////////////////////////////////////////
2 // Name: src/msw/button.cpp
4 // Author: Julian Smart
8 // Copyright: (c) Julian Smart
9 // Licence: wxWindows licence
10 /////////////////////////////////////////////////////////////////////////////
12 // ============================================================================
14 // ============================================================================
16 // ----------------------------------------------------------------------------
18 // ----------------------------------------------------------------------------
20 // For compilers that support precompilation, includes "wx.h".
21 #include "wx/wxprec.h"
29 #include "wx/button.h"
35 #include "wx/bmpbuttn.h"
36 #include "wx/settings.h"
37 #include "wx/dcscreen.h"
38 #include "wx/dcclient.h"
39 #include "wx/toplevel.h"
42 #include "wx/imaglist.h"
43 #include "wx/stockitem.h"
44 #include "wx/msw/private.h"
45 #include "wx/msw/private/button.h"
46 #include "wx/msw/private/dc.h"
47 #include "wx/private/window.h"
49 using namespace wxMSWImpl
;
52 #include "wx/msw/uxtheme.h"
54 // no need to include tmschema.h
56 #define BP_PUSHBUTTON 1
61 #define PBS_DISABLED 4
62 #define PBS_DEFAULTED 5
64 #define TMT_CONTENTMARGINS 3602
67 // provide the necessary declarations ourselves if they're missing from
69 #ifndef BCM_SETIMAGELIST
70 #define BCM_SETIMAGELIST 0x1602
71 #define BCM_SETTEXTMARGIN 0x1604
75 BUTTON_IMAGELIST_ALIGN_LEFT
,
76 BUTTON_IMAGELIST_ALIGN_RIGHT
,
77 BUTTON_IMAGELIST_ALIGN_TOP
,
78 BUTTON_IMAGELIST_ALIGN_BOTTOM
81 struct BUTTON_IMAGELIST
88 #endif // wxUSE_UXTHEME
90 #ifndef WM_THEMECHANGED
91 #define WM_THEMECHANGED 0x031A
95 #define ODS_NOACCEL 0x0100
98 #ifndef ODS_NOFOCUSRECT
99 #define ODS_NOFOCUSRECT 0x0200
102 #ifndef DT_HIDEPREFIX
103 #define DT_HIDEPREFIX 0x00100000
106 // set the value for BCM_SETSHIELD (for the UAC shield) if it's not defined in
108 #ifndef BCM_SETSHIELD
109 #define BCM_SETSHIELD 0x160c
112 // ----------------------------------------------------------------------------
114 // ----------------------------------------------------------------------------
116 // we use different data classes for owner drawn buttons and for themed XP ones
118 class wxButtonImageData
121 wxButtonImageData() { }
122 virtual ~wxButtonImageData() { }
124 virtual wxBitmap
GetBitmap(wxButton::State which
) const = 0;
125 virtual void SetBitmap(const wxBitmap
& bitmap
, wxButton::State which
) = 0;
127 virtual wxSize
GetBitmapMargins() const = 0;
128 virtual void SetBitmapMargins(wxCoord x
, wxCoord y
) = 0;
130 virtual wxDirection
GetBitmapPosition() const = 0;
131 virtual void SetBitmapPosition(wxDirection dir
) = 0;
134 wxDECLARE_NO_COPY_CLASS(wxButtonImageData
);
140 // the gap between button edge and the interior area used by Windows for the
142 const int OD_BUTTON_MARGIN
= 4;
144 class wxODButtonImageData
: public wxButtonImageData
147 wxODButtonImageData(wxButton
*btn
, const wxBitmap
& bitmap
)
149 SetBitmap(bitmap
, wxButton::State_Normal
);
153 // we use margins when we have both bitmap and text, but when we have
154 // only the bitmap it should take up the entire button area
155 if ( btn
->ShowsLabel() )
157 m_margin
.x
= btn
->GetCharWidth();
158 m_margin
.y
= btn
->GetCharHeight() / 2;
162 virtual wxBitmap
GetBitmap(wxButton::State which
) const
164 return m_bitmaps
[which
];
167 virtual void SetBitmap(const wxBitmap
& bitmap
, wxButton::State which
)
169 m_bitmaps
[which
] = bitmap
;
172 virtual wxSize
GetBitmapMargins() const
177 virtual void SetBitmapMargins(wxCoord x
, wxCoord y
)
179 m_margin
= wxSize(x
, y
);
182 virtual wxDirection
GetBitmapPosition() const
187 virtual void SetBitmapPosition(wxDirection dir
)
193 // just store the values passed to us to be able to retrieve them later
194 // from the drawing code
195 wxBitmap m_bitmaps
[wxButton::State_Max
];
199 wxDECLARE_NO_COPY_CLASS(wxODButtonImageData
);
204 // somehow the margin is one pixel greater than the value returned by
205 // GetThemeMargins() call
206 const int XP_BUTTON_EXTRA_MARGIN
= 1;
208 class wxXPButtonImageData
: public wxButtonImageData
211 // we must be constructed with the size of our images as we need to create
213 wxXPButtonImageData(wxButton
*btn
, const wxBitmap
& bitmap
)
214 : m_iml(bitmap
.GetWidth(), bitmap
.GetHeight(), true /* use mask */,
215 wxButton::State_Max
),
216 m_hwndBtn(GetHwndOf(btn
))
218 // initialize all bitmaps to normal state
219 for ( int n
= 0; n
< wxButton::State_Max
; n
++ )
224 m_data
.himl
= GetHimagelistOf(&m_iml
);
226 // use default margins
228 m_data
.margin
.right
= btn
->GetCharWidth();
230 m_data
.margin
.bottom
= btn
->GetCharHeight() / 2;
232 // and default alignment
233 m_data
.uAlign
= BUTTON_IMAGELIST_ALIGN_LEFT
;
238 virtual wxBitmap
GetBitmap(wxButton::State which
) const
240 return m_iml
.GetBitmap(which
);
243 virtual void SetBitmap(const wxBitmap
& bitmap
, wxButton::State which
)
245 m_iml
.Replace(which
, bitmap
);
250 virtual wxSize
GetBitmapMargins() const
252 return wxSize(m_data
.margin
.left
, m_data
.margin
.top
);
255 virtual void SetBitmapMargins(wxCoord x
, wxCoord y
)
257 RECT
& margin
= m_data
.margin
;
263 if ( !::SendMessage(m_hwndBtn
, BCM_SETTEXTMARGIN
, 0, (LPARAM
)&margin
) )
265 wxLogDebug("SendMessage(BCM_SETTEXTMARGIN) failed");
269 virtual wxDirection
GetBitmapPosition() const
271 switch ( m_data
.uAlign
)
274 wxFAIL_MSG( "invalid image alignment" );
277 case BUTTON_IMAGELIST_ALIGN_LEFT
:
280 case BUTTON_IMAGELIST_ALIGN_RIGHT
:
283 case BUTTON_IMAGELIST_ALIGN_TOP
:
286 case BUTTON_IMAGELIST_ALIGN_BOTTOM
:
291 virtual void SetBitmapPosition(wxDirection dir
)
297 wxFAIL_MSG( "invalid direction" );
301 alignNew
= BUTTON_IMAGELIST_ALIGN_LEFT
;
305 alignNew
= BUTTON_IMAGELIST_ALIGN_RIGHT
;
309 alignNew
= BUTTON_IMAGELIST_ALIGN_TOP
;
313 alignNew
= BUTTON_IMAGELIST_ALIGN_BOTTOM
;
317 if ( alignNew
!= m_data
.uAlign
)
319 m_data
.uAlign
= alignNew
;
325 void UpdateImageInfo()
327 if ( !::SendMessage(m_hwndBtn
, BCM_SETIMAGELIST
, 0, (LPARAM
)&m_data
) )
329 wxLogDebug("SendMessage(BCM_SETIMAGELIST) failed");
333 // we store image list separately to be able to use convenient wxImageList
334 // methods instead of working with raw HIMAGELIST
337 // store the rest of the data in BCM_SETIMAGELIST-friendly form
338 BUTTON_IMAGELIST m_data
;
340 // the button we're associated with
341 const HWND m_hwndBtn
;
344 wxDECLARE_NO_COPY_CLASS(wxXPButtonImageData
);
347 #endif // wxUSE_UXTHEME
349 } // anonymous namespace
351 // ----------------------------------------------------------------------------
353 // ----------------------------------------------------------------------------
355 #if wxUSE_EXTENDED_RTTI
357 WX_DEFINE_FLAGS( wxButtonStyle
)
359 wxBEGIN_FLAGS( wxButtonStyle
)
360 // new style border flags, we put them first to
361 // use them for streaming out
362 wxFLAGS_MEMBER(wxBORDER_SIMPLE
)
363 wxFLAGS_MEMBER(wxBORDER_SUNKEN
)
364 wxFLAGS_MEMBER(wxBORDER_DOUBLE
)
365 wxFLAGS_MEMBER(wxBORDER_RAISED
)
366 wxFLAGS_MEMBER(wxBORDER_STATIC
)
367 wxFLAGS_MEMBER(wxBORDER_NONE
)
369 // old style border flags
370 wxFLAGS_MEMBER(wxSIMPLE_BORDER
)
371 wxFLAGS_MEMBER(wxSUNKEN_BORDER
)
372 wxFLAGS_MEMBER(wxDOUBLE_BORDER
)
373 wxFLAGS_MEMBER(wxRAISED_BORDER
)
374 wxFLAGS_MEMBER(wxSTATIC_BORDER
)
375 wxFLAGS_MEMBER(wxBORDER
)
377 // standard window styles
378 wxFLAGS_MEMBER(wxTAB_TRAVERSAL
)
379 wxFLAGS_MEMBER(wxCLIP_CHILDREN
)
380 wxFLAGS_MEMBER(wxTRANSPARENT_WINDOW
)
381 wxFLAGS_MEMBER(wxWANTS_CHARS
)
382 wxFLAGS_MEMBER(wxFULL_REPAINT_ON_RESIZE
)
383 wxFLAGS_MEMBER(wxALWAYS_SHOW_SB
)
384 wxFLAGS_MEMBER(wxVSCROLL
)
385 wxFLAGS_MEMBER(wxHSCROLL
)
387 wxFLAGS_MEMBER(wxBU_LEFT
)
388 wxFLAGS_MEMBER(wxBU_RIGHT
)
389 wxFLAGS_MEMBER(wxBU_TOP
)
390 wxFLAGS_MEMBER(wxBU_BOTTOM
)
391 wxFLAGS_MEMBER(wxBU_EXACTFIT
)
392 wxEND_FLAGS( wxButtonStyle
)
394 IMPLEMENT_DYNAMIC_CLASS_XTI(wxButton
, wxControl
,"wx/button.h")
396 wxBEGIN_PROPERTIES_TABLE(wxButton
)
397 wxEVENT_PROPERTY( Click
, wxEVT_COMMAND_BUTTON_CLICKED
, wxCommandEvent
)
399 wxPROPERTY( Font
, wxFont
, SetFont
, GetFont
, EMPTY_MACROVALUE
, 0 /*flags*/ , wxT("Helpstring") , wxT("group"))
400 wxPROPERTY( Label
, wxString
, SetLabel
, GetLabel
, wxString(), 0 /*flags*/ , wxT("Helpstring") , wxT("group") )
402 wxPROPERTY_FLAGS( WindowStyle
, wxButtonStyle
, long , SetWindowStyleFlag
, GetWindowStyleFlag
, EMPTY_MACROVALUE
, 0 /*flags*/ , wxT("Helpstring") , wxT("group")) // style
404 wxEND_PROPERTIES_TABLE()
406 wxBEGIN_HANDLERS_TABLE(wxButton
)
407 wxEND_HANDLERS_TABLE()
409 wxCONSTRUCTOR_6( wxButton
, wxWindow
* , Parent
, wxWindowID
, Id
, wxString
, Label
, wxPoint
, Position
, wxSize
, Size
, long , WindowStyle
)
413 IMPLEMENT_DYNAMIC_CLASS(wxButton
, wxControl
)
416 // ============================================================================
418 // ============================================================================
420 // ----------------------------------------------------------------------------
421 // helper functions from wx/msw/private/button.h
422 // ----------------------------------------------------------------------------
424 void wxMSWButton::UpdateMultilineStyle(HWND hwnd
, const wxString
& label
)
426 // update BS_MULTILINE style depending on the new label (resetting it
427 // doesn't seem to do anything very useful but it shouldn't hurt and we do
428 // have to set it whenever the label becomes multi line as otherwise it
429 // wouldn't be shown correctly as we don't use BS_MULTILINE when creating
430 // the control unless it already has new lines in its label)
431 long styleOld
= ::GetWindowLong(hwnd
, GWL_STYLE
),
433 if ( label
.find(wxT('\n')) != wxString::npos
)
434 styleNew
= styleOld
| BS_MULTILINE
;
436 styleNew
= styleOld
& ~BS_MULTILINE
;
438 if ( styleNew
!= styleOld
)
439 ::SetWindowLong(hwnd
, GWL_STYLE
, styleNew
);
442 wxSize
wxMSWButton::GetFittingSize(wxWindow
*win
,
443 const wxSize
& sizeLabel
,
446 // FIXME: this is pure guesswork, need to retrieve the real button margins
447 wxSize sizeBtn
= sizeLabel
;
449 sizeBtn
.x
+= 3*win
->GetCharWidth();
450 sizeBtn
.y
= 11*EDIT_HEIGHT_FROM_CHAR_HEIGHT(sizeLabel
.y
)/10;
452 // account for the shield UAC icon if we have it
453 if ( flags
& Size_AuthNeeded
)
454 sizeBtn
.x
+= wxSystemSettings::GetMetric(wxSYS_SMALLICON_X
);
459 wxSize
wxMSWButton::ComputeBestSize(wxControl
*btn
, int flags
)
464 dc
.GetMultiLineTextExtent(btn
->GetLabelText(), &sizeBtn
.x
, &sizeBtn
.y
);
466 sizeBtn
= GetFittingSize(btn
, sizeBtn
, flags
);
468 // all buttons have at least the standard size unless the user explicitly
469 // wants them to be of smaller size and used wxBU_EXACTFIT style when
470 // creating the button
471 if ( !btn
->HasFlag(wxBU_EXACTFIT
) )
473 // The size of a standard button in the dialog units is 50x14, use it.
474 // Note that we intentionally don't use GetDefaultSize() here, because
475 // it's inexact -- dialog units depend on this dialog's font.
476 wxSize sizeDef
= btn
->ConvertDialogToPixels(wxSize(50, 14));
477 if ( sizeBtn
.x
< sizeDef
.x
)
478 sizeBtn
.x
= sizeDef
.x
;
479 if ( sizeBtn
.y
< sizeDef
.y
)
480 sizeBtn
.y
= sizeDef
.y
;
483 btn
->CacheBestSize(sizeBtn
);
488 // ----------------------------------------------------------------------------
489 // creation/destruction
490 // ----------------------------------------------------------------------------
492 bool wxButton::Create(wxWindow
*parent
,
498 const wxValidator
& validator
,
499 const wxString
& name
)
501 m_authNeeded
= false;
504 if (label
.empty() && wxIsStockID(id
))
506 // On Windows, some buttons aren't supposed to have mnemonics
507 label
= wxGetStockLabel
510 id
== wxID_OK
|| id
== wxID_CANCEL
|| id
== wxID_CLOSE
512 : wxSTOCK_WITH_MNEMONIC
516 if ( !CreateControl(parent
, id
, pos
, size
, style
, validator
, name
) )
520 WXDWORD msStyle
= MSWGetStyle(style
, &exstyle
);
522 // if the label contains several lines we must explicitly tell the button
523 // about it or it wouldn't draw it correctly ("\n"s would just appear as
526 // NB: we do it here and not in MSWGetStyle() because we need the label
527 // value and the label is not set yet when MSWGetStyle() is called
528 msStyle
|= wxMSWButton::GetMultilineStyle(label
);
530 return MSWCreateControl(wxT("BUTTON"), msStyle
, pos
, size
, label
, exstyle
);
533 wxButton::~wxButton()
535 wxTopLevelWindow
*tlw
= wxDynamicCast(wxGetTopLevelParent(this), wxTopLevelWindow
);
536 if ( tlw
&& tlw
->GetTmpDefaultItem() == this )
544 // ----------------------------------------------------------------------------
546 // ----------------------------------------------------------------------------
548 WXDWORD
wxButton::MSWGetStyle(long style
, WXDWORD
*exstyle
) const
550 // buttons never have an external border, they draw their own one
551 WXDWORD msStyle
= wxControl::MSWGetStyle
553 (style
& ~wxBORDER_MASK
) | wxBORDER_NONE
, exstyle
556 // we must use WS_CLIPSIBLINGS with the buttons or they would draw over
557 // each other in any resizeable dialog which has more than one button in
559 msStyle
|= WS_CLIPSIBLINGS
;
561 // don't use "else if" here: weird as it is, but you may combine wxBU_LEFT
562 // and wxBU_RIGHT to get BS_CENTER!
563 if ( style
& wxBU_LEFT
)
565 if ( style
& wxBU_RIGHT
)
567 if ( style
& wxBU_TOP
)
569 if ( style
& wxBU_BOTTOM
)
570 msStyle
|= BS_BOTTOM
;
573 if ( style
& wxNO_BORDER
)
575 #endif // __WXWINCE__
580 void wxButton::SetLabel(const wxString
& label
)
582 wxMSWButton::UpdateMultilineStyle(GetHwnd(), label
);
584 wxButtonBase::SetLabel(label
);
587 // ----------------------------------------------------------------------------
588 // size management including autosizing
589 // ----------------------------------------------------------------------------
591 wxSize
wxButton::DoGetBestSize() const
595 // account for the text part if we have it or if we don't have any image at
596 // all (buttons initially created with empty label should still have a non
598 if ( ShowsLabel() || !m_imageData
)
601 if ( GetAuthNeeded() )
602 flags
|= wxMSWButton::Size_AuthNeeded
;
604 size
= wxMSWButton::ComputeBestSize(const_cast<wxButton
*>(this), flags
);
609 // account for the bitmap size
610 const wxSize sizeBmp
= m_imageData
->GetBitmap(State_Normal
).GetSize();
611 const wxDirection dirBmp
= m_imageData
->GetBitmapPosition();
612 if ( dirBmp
== wxLEFT
|| dirBmp
== wxRIGHT
)
615 if ( sizeBmp
.y
> size
.y
)
618 else // bitmap on top/below the text
621 if ( sizeBmp
.x
> size
.x
)
625 // account for the user-specified margins
626 size
+= 2*m_imageData
->GetBitmapMargins();
628 // and also for the margins we always add internally (unless we have no
629 // border at all in which case the button has exactly the same size as
630 // bitmap and so no margins should be used)
631 if ( !HasFlag(wxBORDER_NONE
) )
636 if ( wxUxThemeEngine::GetIfActive() )
638 wxUxThemeHandle
theme(const_cast<wxButton
*>(this), L
"BUTTON");
641 wxUxThemeEngine::Get()->GetThemeMargins(theme
, NULL
,
648 // XP doesn't draw themed buttons correctly when the client
649 // area is smaller than 8x8 - enforce this minimum size for
651 size
.IncTo(wxSize(8, 8));
653 marginH
= margins
.cxLeftWidth
+ margins
.cxRightWidth
654 + 2*XP_BUTTON_EXTRA_MARGIN
;
655 marginV
= margins
.cyTopHeight
+ margins
.cyBottomHeight
656 + 2*XP_BUTTON_EXTRA_MARGIN
;
659 #endif // wxUSE_UXTHEME
662 marginV
= OD_BUTTON_MARGIN
;
665 size
.IncBy(marginH
, marginV
);
675 wxSize
wxButtonBase::GetDefaultSize()
677 static wxSize s_sizeBtn
;
679 if ( s_sizeBtn
.x
== 0 )
682 dc
.SetFont(wxSystemSettings::GetFont(wxSYS_DEFAULT_GUI_FONT
));
684 // The size of a standard button in the dialog units is 50x14,
685 // translate this to pixels.
687 // Windows' computes dialog units using average character width over
688 // upper- and lower-case ASCII alphabet and not using the average
689 // character width metadata stored in the font; see
690 // http://support.microsoft.com/default.aspx/kb/145994 for detailed
693 // NB: wxMulDivInt32() is used, because it correctly rounds the result
695 const wxSize base
= wxPrivate::GetAverageASCIILetterSize(dc
);
696 s_sizeBtn
.x
= wxMulDivInt32(50, base
.x
, 4);
697 s_sizeBtn
.y
= wxMulDivInt32(14, base
.y
, 8);
703 // ----------------------------------------------------------------------------
704 // default button handling
705 // ----------------------------------------------------------------------------
708 The comment below and all this code is probably due to not using WM_NEXTDLGCTL
709 message when changing focus (but just SetFocus() which is not enough), see
710 http://blogs.msdn.com/oldnewthing/archive/2004/08/02/205624.aspx for the
713 TODO: Do use WM_NEXTDLGCTL and get rid of all this code.
716 "Everything you ever wanted to know about the default buttons" or "Why do we
717 have to do all this?"
719 In MSW the default button should be activated when the user presses Enter
720 and the current control doesn't process Enter itself somehow. This is
721 handled by ::DefWindowProc() (or maybe ::DefDialogProc()) using DM_SETDEFID
722 Another aspect of "defaultness" is that the default button has different
723 appearance: this is due to BS_DEFPUSHBUTTON style which is completely
724 separate from DM_SETDEFID stuff (!). Also note that BS_DEFPUSHBUTTON should
725 be unset if our parent window is not active so it should be unset whenever
726 we lose activation and set back when we regain it.
728 Final complication is that when a button is active, it should be the default
729 one, i.e. pressing Enter on a button always activates it and not another
732 We handle this by maintaining a permanent and a temporary default items in
733 wxControlContainer (both may be NULL). When a button becomes the current
734 control (i.e. gets focus) it sets itself as the temporary default which
735 ensures that it has the right appearance and that Enter will be redirected
736 to it. When the button loses focus, it unsets the temporary default and so
737 the default item will be the permanent default -- that is the default button
738 if any had been set or none otherwise, which is just what we want.
740 NB: all this is quite complicated by now and the worst is that normally
741 it shouldn't be necessary at all as for the normal Windows programs
742 DefWindowProc() and IsDialogMessage() take care of all this
743 automatically -- however in wxWidgets programs this doesn't work for
744 nested hierarchies (i.e. a notebook inside a notebook) for unknown
745 reason and so we have to reproduce all this code ourselves. It would be
746 very nice if we could avoid doing it.
749 // set this button as the (permanently) default one in its panel
750 wxWindow
*wxButton::SetDefault()
752 // set this one as the default button both for wxWidgets ...
753 wxWindow
*winOldDefault
= wxButtonBase::SetDefault();
756 SetDefaultStyle(wxDynamicCast(winOldDefault
, wxButton
), false);
757 SetDefaultStyle(this, true);
759 return winOldDefault
;
762 // return the top level parent window if it's not being deleted yet, otherwise
764 static wxTopLevelWindow
*GetTLWParentIfNotBeingDeleted(wxWindow
*win
)
768 // IsTopLevel() will return false for a wxTLW being deleted, so we also
769 // need the parent test for this case
770 wxWindow
* const parent
= win
->GetParent();
771 if ( !parent
|| win
->IsTopLevel() )
773 if ( win
->IsBeingDeleted() )
782 wxASSERT_MSG( win
, wxT("button without top level parent?") );
784 wxTopLevelWindow
* const tlw
= wxDynamicCast(win
, wxTopLevelWindow
);
785 wxASSERT_MSG( tlw
, wxT("logic error in GetTLWParentIfNotBeingDeleted()") );
790 // set this button as being currently default
791 void wxButton::SetTmpDefault()
793 wxTopLevelWindow
* const tlw
= GetTLWParentIfNotBeingDeleted(GetParent());
797 wxWindow
*winOldDefault
= tlw
->GetDefaultItem();
798 tlw
->SetTmpDefaultItem(this);
800 SetDefaultStyle(wxDynamicCast(winOldDefault
, wxButton
), false);
801 SetDefaultStyle(this, true);
804 // unset this button as currently default, it may still stay permanent default
805 void wxButton::UnsetTmpDefault()
807 wxTopLevelWindow
* const tlw
= GetTLWParentIfNotBeingDeleted(GetParent());
811 tlw
->SetTmpDefaultItem(NULL
);
813 wxWindow
*winOldDefault
= tlw
->GetDefaultItem();
815 SetDefaultStyle(this, false);
816 SetDefaultStyle(wxDynamicCast(winOldDefault
, wxButton
), true);
821 wxButton::SetDefaultStyle(wxButton
*btn
, bool on
)
823 // we may be called with NULL pointer -- simpler to do the check here than
824 // in the caller which does wxDynamicCast()
828 // first, let DefDlgProc() know about the new default button
831 // we shouldn't set BS_DEFPUSHBUTTON for any button if we don't have
832 // focus at all any more
833 if ( !wxTheApp
->IsActive() )
836 wxWindow
* const tlw
= wxGetTopLevelParent(btn
);
837 wxCHECK_RET( tlw
, wxT("button without top level window?") );
839 ::SendMessage(GetHwndOf(tlw
), DM_SETDEFID
, btn
->GetId(), 0L);
841 // sending DM_SETDEFID also changes the button style to
842 // BS_DEFPUSHBUTTON so there is nothing more to do
845 // then also change the style as needed
846 long style
= ::GetWindowLong(GetHwndOf(btn
), GWL_STYLE
);
847 if ( !(style
& BS_DEFPUSHBUTTON
) == on
)
849 // don't do it with the owner drawn buttons because it will
850 // reset BS_OWNERDRAW style bit too (as BS_OWNERDRAW &
851 // BS_DEFPUSHBUTTON != 0)!
852 if ( (style
& BS_OWNERDRAW
) != BS_OWNERDRAW
)
854 ::SendMessage(GetHwndOf(btn
), BM_SETSTYLE
,
855 on
? style
| BS_DEFPUSHBUTTON
856 : style
& ~BS_DEFPUSHBUTTON
,
861 // redraw the button - it will notice itself that it's
862 // [not] the default one [any longer]
866 //else: already has correct style
869 // ----------------------------------------------------------------------------
871 // ----------------------------------------------------------------------------
873 bool wxButton::SendClickEvent()
875 wxCommandEvent
event(wxEVT_COMMAND_BUTTON_CLICKED
, GetId());
876 event
.SetEventObject(this);
878 return ProcessCommand(event
);
881 void wxButton::Command(wxCommandEvent
& event
)
883 ProcessCommand(event
);
886 // ----------------------------------------------------------------------------
887 // event/message handlers
888 // ----------------------------------------------------------------------------
890 bool wxButton::MSWCommand(WXUINT param
, WXWORD
WXUNUSED(id
))
892 bool processed
= false;
895 // NOTE: Apparently older versions (NT 4?) of the common controls send
896 // BN_DOUBLECLICKED but not a second BN_CLICKED for owner-drawn
897 // buttons, so in order to send two EVT_BUTTON events we should
898 // catch both types. Currently (Feb 2003) up-to-date versions of
899 // win98, win2k and winXP all send two BN_CLICKED messages for
900 // all button types, so we don't catch BN_DOUBLECLICKED anymore
901 // in order to not get 3 EVT_BUTTON events. If this is a problem
902 // then we need to figure out which version of the comctl32 changed
903 // this behaviour and test for it.
905 case 1: // message came from an accelerator
906 case BN_CLICKED
: // normal buttons send this
907 processed
= SendClickEvent();
914 WXLRESULT
wxButton::MSWWindowProc(WXUINT nMsg
, WXWPARAM wParam
, WXLPARAM lParam
)
916 // when we receive focus, we want to temporarily become the default button in
917 // our parent panel so that pressing "Enter" would activate us -- and when
918 // losing it we should restore the previous default button as well
919 if ( nMsg
== WM_SETFOCUS
)
923 // let the default processing take place too
925 else if ( nMsg
== WM_KILLFOCUS
)
929 else if ( nMsg
== WM_LBUTTONDBLCLK
)
931 // emulate a click event to force an owner-drawn button to change its
932 // appearance - without this, it won't do it
933 (void)wxControl::MSWWindowProc(WM_LBUTTONDOWN
, wParam
, lParam
);
935 // and continue with processing the message normally as well
938 else if ( nMsg
== WM_THEMECHANGED
)
940 // need to recalculate the best size here
941 // as the theme size might have changed
942 InvalidateBestSize();
944 #endif // wxUSE_UXTHEME
945 // must use m_mouseInWindow here instead of IsMouseInWindow()
946 // since we need to know the first time the mouse enters the window
947 // and IsMouseInWindow() would return true in this case
948 else if ( (nMsg
== WM_MOUSEMOVE
&& !m_mouseInWindow
) ||
949 nMsg
== WM_MOUSELEAVE
)
955 wxUxThemeEngine::GetIfActive() ||
956 #endif // wxUSE_UXTHEME
957 (m_imageData
&& m_imageData
->GetBitmap(State_Current
).IsOk())
965 // let the base class do all real processing
966 return wxControl::MSWWindowProc(nMsg
, wParam
, lParam
);
969 // ----------------------------------------------------------------------------
970 // authentication needed handling
971 // ----------------------------------------------------------------------------
973 bool wxButton::DoGetAuthNeeded() const
978 void wxButton::DoSetAuthNeeded(bool show
)
980 // show/hide UAC symbol on Windows Vista and later
981 if ( wxGetWinVersion() >= wxWinVersion_6
)
984 ::SendMessage(GetHwnd(), BCM_SETSHIELD
, 0, show
);
985 InvalidateBestSize();
989 // ----------------------------------------------------------------------------
991 // ----------------------------------------------------------------------------
993 wxBitmap
wxButton::DoGetBitmap(State which
) const
995 return m_imageData
? m_imageData
->GetBitmap(which
) : wxBitmap();
998 void wxButton::DoSetBitmap(const wxBitmap
& bitmap
, State which
)
1000 // allocate the image data when the first bitmap is set
1004 // using image list doesn't work correctly if we don't have any label
1005 // (even if we use BUTTON_IMAGELIST_ALIGN_CENTER alignment and
1006 // BS_BITMAP style), at least under Windows 2003 so use owner drawn
1007 // strategy for bitmap-only buttons
1008 if ( ShowsLabel() && wxUxThemeEngine::GetIfActive() )
1010 m_imageData
= new wxXPButtonImageData(this, bitmap
);
1013 #endif // wxUSE_UXTHEME
1015 m_imageData
= new wxODButtonImageData(this, bitmap
);
1021 m_imageData
->SetBitmap(bitmap
, which
);
1024 // it should be enough to only invalidate the best size when the normal
1025 // bitmap changes as all bitmaps assigned to the button should be of the
1027 if ( which
== State_Normal
)
1028 InvalidateBestSize();
1033 wxSize
wxButton::DoGetBitmapMargins() const
1035 return m_imageData
? m_imageData
->GetBitmapMargins() : wxSize(0, 0);
1038 void wxButton::DoSetBitmapMargins(wxCoord x
, wxCoord y
)
1040 wxCHECK_RET( m_imageData
, "SetBitmap() must be called first" );
1042 m_imageData
->SetBitmapMargins(x
, y
);
1043 InvalidateBestSize();
1046 void wxButton::DoSetBitmapPosition(wxDirection dir
)
1048 wxCHECK_RET( m_imageData
, "SetBitmap() must be called first" );
1050 m_imageData
->SetBitmapPosition(dir
);
1051 InvalidateBestSize();
1054 // ----------------------------------------------------------------------------
1055 // owner-drawn buttons support
1056 // ----------------------------------------------------------------------------
1062 // return the button state using both the ODS_XXX flags specified in state
1063 // parameter and the current button state
1064 wxButton::State
GetButtonState(wxButton
*btn
, UINT state
)
1066 if ( state
& ODS_DISABLED
)
1067 return wxButton::State_Disabled
;
1069 if ( state
& ODS_SELECTED
)
1070 return wxButton::State_Pressed
;
1072 if ( btn
->HasCapture() || btn
->IsMouseInWindow() )
1073 return wxButton::State_Current
;
1075 if ( state
& ODS_FOCUS
)
1076 return wxButton::State_Focused
;
1078 return wxButton::State_Normal
;
1081 void DrawButtonText(HDC hdc
,
1083 const wxString
& text
,
1087 wxTextColoursChanger
changeFg(hdc
, col
, CLR_INVALID
);
1088 wxBkModeChanger
changeBkMode(hdc
, wxBRUSHSTYLE_TRANSPARENT
);
1090 // center text horizontally in any case
1093 if ( text
.find(wxT('\n')) != wxString::npos
)
1095 // draw multiline label
1097 // first we need to compute its bounding rect
1099 ::CopyRect(&rc
, pRect
);
1100 ::DrawText(hdc
, text
.wx_str(), text
.length(), &rc
,
1101 DT_CENTER
| DT_CALCRECT
);
1103 // now center this rect inside the entire button area
1104 const LONG w
= rc
.right
- rc
.left
;
1105 const LONG h
= rc
.bottom
- rc
.top
;
1106 rc
.left
= (pRect
->right
- pRect
->left
)/2 - w
/2;
1107 rc
.right
= rc
.left
+w
;
1108 rc
.top
= (pRect
->bottom
- pRect
->top
)/2 - h
/2;
1109 rc
.bottom
= rc
.top
+h
;
1111 ::DrawText(hdc
, text
.wx_str(), text
.length(), &rc
, flags
);
1113 else // single line label
1115 // centre text vertically too (notice that we must have DT_SINGLELINE
1116 // for DT_VCENTER to work)
1117 ::DrawText(hdc
, text
.wx_str(), text
.length(), pRect
,
1118 flags
| DT_SINGLELINE
| DT_VCENTER
);
1122 void DrawRect(HDC hdc
, const RECT
& r
)
1124 wxDrawLine(hdc
, r
.left
, r
.top
, r
.right
, r
.top
);
1125 wxDrawLine(hdc
, r
.right
, r
.top
, r
.right
, r
.bottom
);
1126 wxDrawLine(hdc
, r
.right
, r
.bottom
, r
.left
, r
.bottom
);
1127 wxDrawLine(hdc
, r
.left
, r
.bottom
, r
.left
, r
.top
);
1131 The button frame looks like this normally:
1134 WHHHHHHHHHHHHHHHHGB W = white (HILIGHT)
1135 WH GB H = light grey (LIGHT)
1136 WH GB G = dark grey (SHADOW)
1137 WH GB B = black (DKSHADOW)
1142 When the button is selected, the button becomes like this (the total button
1143 size doesn't change):
1154 When the button is pushed (while selected) it is like:
1165 void DrawButtonFrame(HDC hdc
, RECT
& rectBtn
,
1166 bool selected
, bool pushed
)
1169 CopyRect(&r
, &rectBtn
);
1171 AutoHPEN
hpenBlack(GetSysColor(COLOR_3DDKSHADOW
)),
1172 hpenGrey(GetSysColor(COLOR_3DSHADOW
)),
1173 hpenLightGr(GetSysColor(COLOR_3DLIGHT
)),
1174 hpenWhite(GetSysColor(COLOR_3DHILIGHT
));
1176 SelectInHDC
selectPen(hdc
, hpenBlack
);
1185 (void)SelectObject(hdc
, hpenGrey
);
1186 ::InflateRect(&r
, -1, -1);
1196 ::InflateRect(&r
, -1, -1);
1199 wxDrawLine(hdc
, r
.left
, r
.bottom
, r
.right
, r
.bottom
);
1200 wxDrawLine(hdc
, r
.right
, r
.bottom
, r
.right
, r
.top
- 1);
1202 (void)SelectObject(hdc
, hpenWhite
);
1203 wxDrawLine(hdc
, r
.left
, r
.bottom
- 1, r
.left
, r
.top
);
1204 wxDrawLine(hdc
, r
.left
, r
.top
, r
.right
, r
.top
);
1206 (void)SelectObject(hdc
, hpenLightGr
);
1207 wxDrawLine(hdc
, r
.left
+ 1, r
.bottom
- 2, r
.left
+ 1, r
.top
+ 1);
1208 wxDrawLine(hdc
, r
.left
+ 1, r
.top
+ 1, r
.right
- 1, r
.top
+ 1);
1210 (void)SelectObject(hdc
, hpenGrey
);
1211 wxDrawLine(hdc
, r
.left
+ 1, r
.bottom
- 1, r
.right
- 1, r
.bottom
- 1);
1212 wxDrawLine(hdc
, r
.right
- 1, r
.bottom
- 1, r
.right
- 1, r
.top
);
1215 InflateRect(&rectBtn
, -OD_BUTTON_MARGIN
, -OD_BUTTON_MARGIN
);
1219 void DrawXPBackground(wxButton
*button
, HDC hdc
, RECT
& rectBtn
, UINT state
)
1221 wxUxThemeHandle
theme(button
, L
"BUTTON");
1223 // this array is indexed by wxButton::State values and so must be kept in
1225 static const int uxStates
[] =
1227 PBS_NORMAL
, PBS_HOT
, PBS_PRESSED
, PBS_DISABLED
, PBS_DEFAULTED
1230 int iState
= uxStates
[GetButtonState(button
, state
)];
1232 wxUxThemeEngine
* const engine
= wxUxThemeEngine::Get();
1234 // draw parent background if needed
1235 if ( engine
->IsThemeBackgroundPartiallyTransparent
1242 engine
->DrawThemeParentBackground(GetHwndOf(button
), hdc
, &rectBtn
);
1246 engine
->DrawThemeBackground(theme
, hdc
, BP_PUSHBUTTON
, iState
,
1249 // calculate content area margins
1251 engine
->GetThemeMargins(theme
, hdc
, BP_PUSHBUTTON
, iState
,
1252 TMT_CONTENTMARGINS
, &rectBtn
, &margins
);
1253 ::InflateRect(&rectBtn
, -margins
.cxLeftWidth
, -margins
.cyTopHeight
);
1254 ::InflateRect(&rectBtn
, -XP_BUTTON_EXTRA_MARGIN
, -XP_BUTTON_EXTRA_MARGIN
);
1256 if ( button
->UseBgCol() )
1258 COLORREF colBg
= wxColourToRGB(button
->GetBackgroundColour());
1259 AutoHBRUSH
hbrushBackground(colBg
);
1261 // don't overwrite the focus rect
1263 ::CopyRect(&rectClient
, &rectBtn
);
1264 ::InflateRect(&rectClient
, -1, -1);
1265 FillRect(hdc
, &rectClient
, hbrushBackground
);
1268 #endif // wxUSE_UXTHEME
1270 } // anonymous namespace
1272 // ----------------------------------------------------------------------------
1273 // owner drawn buttons support
1274 // ----------------------------------------------------------------------------
1276 void wxButton::MakeOwnerDrawn()
1278 long style
= GetWindowLong(GetHwnd(), GWL_STYLE
);
1279 if ( (style
& BS_OWNERDRAW
) != BS_OWNERDRAW
)
1282 style
|= BS_OWNERDRAW
;
1283 SetWindowLong(GetHwnd(), GWL_STYLE
, style
);
1287 bool wxButton::SetBackgroundColour(const wxColour
&colour
)
1289 if ( !wxControl::SetBackgroundColour(colour
) )
1302 bool wxButton::SetForegroundColour(const wxColour
&colour
)
1304 if ( !wxControl::SetForegroundColour(colour
) )
1317 bool wxButton::MSWOnDraw(WXDRAWITEMSTRUCT
*wxdis
)
1319 LPDRAWITEMSTRUCT lpDIS
= (LPDRAWITEMSTRUCT
)wxdis
;
1320 HDC hdc
= lpDIS
->hDC
;
1322 UINT state
= lpDIS
->itemState
;
1323 bool pushed
= (SendMessage(GetHwnd(), BM_GETSTATE
, 0, 0) & BST_PUSHED
) != 0;
1326 CopyRect(&rectBtn
, &lpDIS
->rcItem
);
1328 // draw the button background
1329 if ( !HasFlag(wxBORDER_NONE
) )
1332 if ( wxUxThemeEngine::GetIfActive() )
1334 DrawXPBackground(this, hdc
, rectBtn
, state
);
1337 #endif // wxUSE_UXTHEME
1339 COLORREF colBg
= wxColourToRGB(GetBackgroundColour());
1341 // first, draw the background
1342 AutoHBRUSH
hbrushBackground(colBg
);
1343 FillRect(hdc
, &rectBtn
, hbrushBackground
);
1345 // draw the border for the current state
1346 bool selected
= (state
& ODS_SELECTED
) != 0;
1350 tlw
= wxDynamicCast(wxGetTopLevelParent(this), wxTopLevelWindow
);
1353 selected
= tlw
->GetDefaultItem() == this;
1357 DrawButtonFrame(hdc
, rectBtn
, selected
, pushed
);
1360 // draw the focus rectangle if we need it
1361 if ( (state
& ODS_FOCUS
) && !(state
& ODS_NOFOCUSRECT
) )
1363 DrawFocusRect(hdc
, &rectBtn
);
1366 if ( !wxUxThemeEngine::GetIfActive() )
1367 #endif // wxUSE_UXTHEME
1371 // the label is shifted by 1 pixel to create "pushed" effect
1372 OffsetRect(&rectBtn
, 1, 1);
1379 // draw the image, if any
1382 wxBitmap bmp
= m_imageData
->GetBitmap(GetButtonState(this, state
));
1384 bmp
= m_imageData
->GetBitmap(State_Normal
);
1386 const wxSize sizeBmp
= bmp
.GetSize();
1387 const wxSize margin
= m_imageData
->GetBitmapMargins();
1388 const wxSize
sizeBmpWithMargins(sizeBmp
+ 2*margin
);
1389 wxRect
rectButton(wxRectFromRECT(rectBtn
));
1391 // for simplicity, we start with centred rectangle and then move it to
1392 // the appropriate edge
1393 wxRect rectBitmap
= wxRect(sizeBmp
).CentreIn(rectButton
);
1394 switch ( m_imageData
->GetBitmapPosition() )
1397 wxFAIL_MSG( "invalid direction" );
1401 rectBitmap
.x
= rectButton
.x
+ margin
.x
;
1402 rectButton
.x
+= sizeBmpWithMargins
.x
;
1403 rectButton
.width
-= sizeBmpWithMargins
.x
;
1407 rectBitmap
.x
= rectButton
.GetRight() - sizeBmp
.x
- margin
.x
;
1408 rectButton
.width
-= sizeBmpWithMargins
.x
;
1412 rectBitmap
.y
= rectButton
.y
+ margin
.y
;
1413 rectButton
.y
+= sizeBmpWithMargins
.y
;
1414 rectButton
.height
-= sizeBmpWithMargins
.y
;
1418 rectBitmap
.y
= rectButton
.GetBottom() - sizeBmp
.y
- margin
.y
;
1419 rectButton
.height
-= sizeBmpWithMargins
.y
;
1423 wxDCTemp
dst((WXHDC
)hdc
);
1424 dst
.DrawBitmap(bmp
, rectBitmap
.GetPosition(), true);
1426 wxCopyRectToRECT(rectButton
, rectBtn
);
1430 // finally draw the label
1433 COLORREF colFg
= state
& ODS_DISABLED
1434 ? ::GetSysColor(COLOR_GRAYTEXT
)
1435 : wxColourToRGB(GetForegroundColour());
1437 // notice that DT_HIDEPREFIX doesn't work on old (pre-Windows 2000)
1438 // systems but by happy coincidence ODS_NOACCEL is not used under them
1439 // neither so DT_HIDEPREFIX should never be used there
1440 DrawButtonText(hdc
, &rectBtn
, GetLabel(), colFg
,
1441 state
& ODS_NOACCEL
? DT_HIDEPREFIX
: 0);
1447 #endif // wxUSE_BUTTON