kicad/include/tool/tool_menu.h

119 lines
3.7 KiB
C++

/*
* This program source code file is part of KiCad, a free EDA CAD application.
*
* Copyright (C) 2017-2020 KiCad Developers, see AUTHORS.txt for contributors.
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*
* You should have received a copy of the GNU General Public License
* along with this program; if not, you may find one here:
* http://www.gnu.org/licenses/old-licenses/gpl-2.0.html
* or you may search the http://www.gnu.org website for the version 2 license,
* or you may write to the Free Software Foundation, Inc.,
* 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA
*/
#ifndef TOOLS_TOOL_MENU__H_
#define TOOLS_TOOL_MENU__H_
#include <tool/conditional_menu.h>
#include <vector>
#include <memory>
class ACTION_MENU;
class TOOL_INTERACTIVE;
/**
* Manage a #CONDITIONAL_MENU and some number of CONTEXT_MENUs as sub-menus.
*
* Each "top-level" interactive tool can have one of these, and other tools can contribute
* #CONTEXT_MENUS to it. There are also helper functions for adding common sets of menu
* items, for example zoom and grid controls.
*/
class TOOL_MENU
{
public:
/**
* Construct a new TOOL_MENU for a specific tool.
*
* This menu will be empty - it's up to the caller to add the relevant items. This can be
* done directly, using the reference returned by TOOL_MENU::GetMenu(), or the helpers for
* common command sets can be used, or a combination of the two.
*/
TOOL_MENU( TOOL_INTERACTIVE& aTool );
/**
* Destruct any submenus created with TOOL_MENU::CreateSubMenu().
*/
~TOOL_MENU();
/**
* @return reference to the CONDITIONAL_MENU model, which can be used by tools to add
* their own commands to the menu.
*/
CONDITIONAL_MENU& GetMenu();
/**
* Store a submenu of this menu model. This can be shared with other menu models.
*
* It is the callers responsibility to add the submenu to m_menu (via GetMenu() ) in the
* right way, as well as to set the tool with SetTool(), since it's not a given that the
* menu's tool is the tool that directly owns this #TOOL_MENU.
*
* @param aSubMenu: a sub menu to add
*/
void AddSubMenu( std::shared_ptr<ACTION_MENU> aSubMenu );
/**
* @return the list of submenus from this menu
*/
std::vector<std::shared_ptr<ACTION_MENU> >& GetSubMenus()
{
return m_subMenus;
}
/**
* Helper function to set and immediately show a #CONDITIONAL_MENU in concert with the
* given #SELECTION
*
* You don't have to use this function, if the caller has a different way to show the
* menu, it can create one from the reference returned by TOOL_MENU::GetMenu(), but it
* will have to be managed externally to this class.
*/
void ShowContextMenu( SELECTION& aSelection );
/**
* Helper function to show a context menu without any selection for tools that can't
* make selections.
*/
void ShowContextMenu();
private:
/**
* The conditional menu displayed by the tool.
*/
CONDITIONAL_MENU m_menu;
/**
* The tool that owns this menu.
*/
TOOL_INTERACTIVE& m_tool;
/**
* Lifetime-managing container of submenus.
*/
std::vector<std::shared_ptr<ACTION_MENU> > m_subMenus;
};
#endif // TOOLS_TOOL_MENU__H_