Show the system window menu (Window::ShowSystemMenu) #66

Activity

1. lijy91

   added

   enhancementNew feature or requestNew feature or request

   on Sep 21, 2026
2. lijy91

   added a commit that references this issue on Oct 6, 2026

   Add native window system menus for custom title bars (#66)

   286a96e
3. lijy91 commented on Oct 6, 2026

   

   lijy91

   on Oct 6, 2026

   MemberAuthor

   More actions

   Implemented in 286a96e (bindings: libnativeapi/nativeapi@33afd13).

   bool ShowSystemMenu(Point) plus a capability; the point is in content-area logical coordinates.

   • Windows: GetSystemMenu / TrackPopupMenuEx, keeping host custom items and WM_SYSCOMMAND behavior.
   • Linux: X11 verified through the real GDK protocol, C ABI, scale 1/2 and widget destruction. Wayland needs a real pointer press serial owned by the app and refuses otherwise.
   • Flutter: the secondary-tap path (5 widget tests).

   Still open: real menu selections on Windows (maximize, restore, minimize, close, custom item) with tools/gui/core_window_system_menu_test.ps1.
4. lijy91

   added a commit that references this issue on Oct 7, 2026

   Say when to call ShowSystemMenu on Windows (#66)

   ...

   e21c922
5. lijy91 commented on Oct 7, 2026

   

   lijy91

   on Oct 7, 2026

   MemberAuthor

   More actions

   Real Windows verification done, with one bug found and fixed on the way.

   Core, real menu clicks (tools/gui/core_window_system_menu_test.ps1, Windows 11): 2/2 runs, 95 checks, 6 real owner-guarded selections — maximize, restore, minimize, restore from minimized, close and a host custom item — with the host's close state preserved and a destroyed window refusing the menu.

   Flutter end to end (tools/gui/flutter_window_title_bar_system_menu_test.ps1, flutter_window_title_bar_example) found a bug: DragToMoveArea opened the menu on the secondary press. On Windows the menu's modal loop then took the release, Flutter never saw it and ignored the next secondary click — the menu opened only once per window. Fixed in libnativeapi/nativeapi@a43ffb0: on Windows it now opens on the release, as a native title bar does; Linux keeps the press, which a Wayland compositor requires. ShowSystemMenu documents the timing (e21c922), with a widget test for the Windows release path.

   After the fix, on Windows 11 (Chinese UI; items are taken by their fixed order), 3/3 runs:

   • a restored window: the menu opens exactly at the pointer, Restore off and Move / Size / Minimize / Maximize / Close on; choosing Maximize maximizes;
   • the maximized window: the menu opens again at the pointer with Restore / Minimize / Close on and Move / Size / Maximize off ([windows] popUpWindowMenu can't display the state of menu items correctly leanflutter/window_manager#151); choosing Restore restores to the earlier width;
   • opening, dismissing and reopening the menu on the same window works.

   Closing.
6. lijy91

   closed this as completedon Oct 7, 2026