diff options
Diffstat (limited to 'wx+/std_button_order.h')
-rw-r--r-- | wx+/std_button_order.h | 140 |
1 files changed, 140 insertions, 0 deletions
diff --git a/wx+/std_button_order.h b/wx+/std_button_order.h new file mode 100644 index 00000000..71fc2334 --- /dev/null +++ b/wx+/std_button_order.h @@ -0,0 +1,140 @@ +// ************************************************************************** +// * This file is part of the FreeFileSync project. It is distributed under * +// * GNU General Public License: http://www.gnu.org/licenses/gpl.html * +// * Copyright (C) Zenju (zenju AT gmx DOT de) - All Rights Reserved * +// ************************************************************************** + +#ifndef STD_BUTTON_ORDER_H_18347032147831732143214 +#define STD_BUTTON_ORDER_H_18347032147831732143214 + +#include <wx/sizer.h> +#include <wx/button.h> + +namespace zen +{ +struct StdButtons +{ + StdButtons() : btnYes(nullptr), btnNo(nullptr), btnCancel(nullptr) {} + StdButtons& setAffirmative (wxButton* btn) { btnYes = btn; return *this; } + StdButtons& setNegative (wxButton* btn) { btnNo = btn; return *this; } + StdButtons& setCancel (wxButton* btn) { btnCancel = btn; return *this; } + + wxButton* btnYes; + wxButton* btnNo; + wxButton* btnCancel; +}; + +void setStandardButtonOrder(wxBoxSizer& sizer, const StdButtons& buttons = StdButtons()); +//sizer width will change! => call wxWindow::Fit and wxWindow::Layout + + + + + + + + + + + +//--------------- impelementation ------------------------------------------- +inline +void setStandardButtonOrder(wxBoxSizer& sizer, const StdButtons& buttons) +{ + assert(sizer.GetOrientation() == wxHORIZONTAL); + + StdButtons buttonsTmp = buttons; + + auto detach = [&](wxButton*& btn) + { + if (btn) + { + assert(btn->GetContainingSizer() == &sizer); + if (btn->IsShown()) + { + bool rv = sizer.Detach(btn); + assert(rv); + if (!rv) + btn = nullptr; + } + else + btn = nullptr; + } + }; + + detach(buttonsTmp.btnYes); + detach(buttonsTmp.btnNo); + detach(buttonsTmp.btnCancel); + +#if defined ZEN_WIN + //Windows User Experience Interaction Guidelines: http://msdn.microsoft.com/en-us/library/windows/desktop/aa511453.aspx#sizing + const int spaceH = 6; //OK + const int spaceRimH = 10; //OK + const int spaceRimV = 8; //compromise; consider additional top row from static line; exact values: top 8, bottom 9 +#elif defined ZEN_LINUX + //GNOME Human Interface Guidelines: https://developer.gnome.org/hig-book/3.2/hig-book.html#alert-spacing + const int spaceH = 6; //OK + const int spaceRimH = 12; //OK + const int spaceRimV = 12; //OK +#elif defined ZEN_MAC + //OS X Human Interface Guidelines: http://developer.apple.com/library/mac/#documentation/UserExperience/Conceptual/AppleHIGuidelines/Windows/Windows.html + const int spaceH = 14; //OK + const int spaceRimH = 20; //OK + const int spaceRimV = 11; //compromise; custom button height (of 30 pix) is considered, although the button is drawn smaller; otherwise 15 seems to have been optimal +#endif + + bool firstButtonSet = false; + auto attach = [&](wxButton* btn) + { + if (btn) + { + if (firstButtonSet) + sizer.Add(spaceH, 0); + else + firstButtonSet = true; + sizer.Add(btn, 0, wxTOP | wxBOTTOM | wxALIGN_CENTER_VERTICAL, spaceRimV); + assert(btn->GetSize().GetHeight() == 30); //see comment for OS X above + } + }; + + //set border on left considering existing items + if (sizer.GetChildren().GetCount() > 0) //for yet another retarded reason wxWidgets will have wxSizer::GetItem(0) cause an assert rather than just return nullptr as documented + if (wxSizerItem* item = sizer.GetItem(static_cast<size_t>(0))) + { + assert(item->GetBorder() <= spaceRimV); //pragmatic check: other controls in the sizer should not have a larger border + int flag = item->GetFlag(); + if (flag & wxLEFT) + { + flag &= ~wxLEFT; + item->SetFlag(flag); + } + sizer.Insert(static_cast<size_t>(0), spaceRimH, 0); + } + + sizer.Add(spaceRimH, 0); +#if defined ZEN_WIN + attach(buttonsTmp.btnYes); + attach(buttonsTmp.btnNo); + attach(buttonsTmp.btnCancel); + +#elif defined ZEN_LINUX + attach(buttonsTmp.btnNo); + attach(buttonsTmp.btnCancel); + attach(buttonsTmp.btnYes); + +#elif defined ZEN_MAC + if (buttonsTmp.btnNo) + { + attach(buttonsTmp.btnNo); + sizer.Add(42 - spaceH, 0); //OS X Human Interface Guidelines: "position it at least 24 pixels away from the “safe” buttons" -> however 42 is used in practice! + } + attach(buttonsTmp.btnCancel); + attach(buttonsTmp.btnYes); +#endif + sizer.Add(spaceRimH, 0); + + assert(buttonsTmp.btnCancel || buttonsTmp.btnYes); //OS X: there should be at least one button following the gap after the "dangerous" no-button +} +} + +#endif //STD_BUTTON_ORDER_H_18347032147831732143214 |