create_menu_proxy

This signal is emitted when the toolbar needs information from tool_item about whether the item should appear in the toolbar overflow menu.

In response the tool item should either

• call set_proxy_menu_item with a null pointer and return true to indicate that the item should not appear in the overflow menu
• call set_proxy_menu_item with a new menu item and return true, or
• return false to indicate that the signal was not handled by the item. This means that the item will not appear in the overflow menu unless a later handler installs a menu item.

The toolbar may cache the result of this signal. When the tool item changes how it will respond to this signal it must call rebuild_menu to invalidate the cache and ensure that the toolbar rebuilds its overflow menu.

Returns:

true if the signal was handled, false if not