MenuItem
enum class Type { Normal, Separator, Submenu };
std::wstring text; ZSignal<> Clicked; std::shared_ptr<Menu> submenu;
Type type = Normal; bool enabled = true; int id = 0;
bool checkable = false, checked = false, radio = false, isDefault = false, danger = false;
std::wstring shortcut; std::optional<Color> bgColor, textColor; std::optional<FontSpec> font;
std::shared_ptr<Label> icon;
Menu
void AddItem(const std::wstring& text, std::function<void()> cb = nullptr, int id = 0);
void AddCheckItem(const std::wstring& text, bool checked);
void AddCheckItemCb(const std::wstring& text, bool checked, std::function<void(bool)> onToggle);
void AddCheckItemRadio(const std::wstring& text, bool checked, std::function<void(bool)> onToggle);
void AddSeparator(); void AddSubmenu(const std::wstring& text, std::shared_ptr<Menu> submenu, int id=0);
std::vector<std::shared_ptr<MenuItem>> items;
std::function<void(Menu&)> onOpening; ZSignal<int> ItemSelected;
std::function<void()> onClosed; // fired after the popup closes
void ShowAt(int screenX, int screenY); void ShowAtCursor(); // standalone popup (tray / right-click)
Pitfall
- item callbacks are deferred via
PostToUIThread(they often open modal dialogs; closing the menu on the current WndProc stack would cause UAF).
MenuWindowBase / MenuWindow
class MenuWindowBase : public Window {
bool CreatePopup(int widthDip, int heightDip, int screenX, int screenY);
void ShowAtPoint(int x, int y); void Hide(); void CloseAll();
void SetStandalone(bool); bool IsPointInPopupTree(POINT ptScreen);
virtual bool OnMenuKeyDown(int vk);
};
class MenuWindow : public MenuWindowBase {
MenuWindow(std::shared_ptr<Menu> menu, HWND ownerHwnd, int x, int y);
};
- Popups use
WS_EX_NOACTIVATE|TOOLWINDOW|TOPMOST, no DWM frame, returnMA_NOACTIVATEso they never steal focus.
Pitfall
CloseAll()destroys HWNDs only; the objectshared_ptr/unique_ptrdestructs outside the message handler.
MenuBar / StatusBar (v1.19.2)
class MenuBar : public UIElement {
int AddMenu(const std::wstring& title, std::shared_ptr<Menu> menu = nullptr); // auto-created if omitted
std::shared_ptr<Menu> GetMenu(int i) const; int MenuCount() const; void CloseMenu();
void SetFont(const FontSpec&); void SetTextColor(Color); void SetHoverColor(Color); void SetOpenColor(Color);
};
class StatusBar : public UIElement {
int AddPanel(const std::wstring& text, bool rightAlign = false);
int AddPanel(Icon, const std::wstring& text, bool rightAlign = false);
void SetPanelText(int i, const std::wstring&); void SetPanelIcon(int i, Icon); int PanelCount() const;
void SetFont(const FontSpec&); void SetColors(Color bg, Color border, Color text);
};
MenuBaropens the entry'sMenuon click (reusing the menu popup); hovering only highlights, it does not auto-expand; the open entry stays "pressed" until the menu closes.- Attach to a window with
Window::SetMenuBar/SetStatusBar(see "Custom title bar").
MessageBox / FastButton
enum class FastButton : unsigned { None=0, OK=1<<0, Cancel=1<<1, Apply=1<<2, Close=1<<3, Yes=1<<4, No=1<<5, Help=1<<6 };
bool HasFlag(FastButton set, FastButton flag);
class MessageBox : public Window {
enum class Icon { None, Info, Warning, Error, Question };
enum class Lang { English, Chinese };
MessageBox(Window* parent, const std::wstring& title, const std::wstring& content,
Icon icon = Icon::None, FastButton buttons = FastButton::OK, bool blocking = true);
FastButton GetResult() const; ZSignal<FastButton> ButtonClicked; void EndDialog(FastButton);
void SetUserContent(std::shared_ptr<UIElement>);
};
- Enter = leftmost; ESC = Cancel/Close (else leftmost).
Pitfall
ZufyUIWindowTool.h#undefs the Win32MessageBoxmacro — callMessageBoxW/Afor Win32.blocking=trueruns the modal loop inside the constructor; afterSetUserContentthere are no preset buttons, so you mustEndDialog.