Add Button to FEM Toolbar Tutorial: Difference between revisions

From FreeCAD Documentation
Line 78: Line 78:


<translate>
<translate>
To add the '''flow''' equation command to the '''solve''' menu of the FEM workbench, search for the following code snippet in {{incode|Workbench.cpp}}.
To add the command to the '''solve''' menu of the FEM workbench, search for the following code snippet in {{incode|Workbench.cpp}}.
</translate>
</translate>
<pre>
<pre>

Revision as of 00:34, 4 August 2021

Other languages:
Tutorial
Topic
FEM
Level
advanced
Time to complete
Authors
JohnWang
FreeCAD version
0.19
Example files
See also
None

Notes: Work In Progress

FEM workbench has toolbars and menus. This tutorial shows how to add a test button onto the toolbars. It also shows how to add a menuitem into the menu.

The task can be split into four parts:

  • Create a new icon file.
  • Register the new icon file. Make change at src/Mod/Fem//Gui/Resources/Fem.qrc
  • Create a new command class. Make change at src/Mod/Fem/femcommands/commands.py
  • Add the new command onto the workbench. Make change at src/Mod/Fem/Gui/Workbench.cpp

Create a new icon file

For a button, We need a icon file. You can use any of your favorite tools to create it, but it must be in SVG format. Here we use FEM_testButton.svg as an example. It has to be put into: src/Mod/Fem/Gui/Resources/icons/.

Register the new icon file

The new icon SVG file has to be registered for the GUI-button in src/Mod/Fem/Gui/Resources/Fem.qrc:

    {{incode|<file>icons/FEM_testButton.svg</file>}} 

Create a new command class

A new command class has to be added to the src/Mod/Fem/femcommands/commands.py module.

Just copy an existing command and adjust the icon, menu text and tool-tip in __init__(self).

class _testButton(CommandManager):
    "The FEM_testButton command definition"

    def __init__(self):
        super(_testButton, self).__init__()
        self.menuetext = "test Button"
        self.tooltip = "This is a test button"
        self.is_active = "always"
        #self.do_activated = "add_obj_on_gui_selobj_noset_edit"

Don't forget to register the command at the bottom of the module file by using the addCommand(...) method.

FreeCADGui.addCommand(
    "FEM_testButton",
    _testButton()
)

Please see the discussion in the forum at https://forum.freecadweb.org/viewtopic.php?f=18&t=46693&start=10#p402004 if icons are involved.


Add the new command onto the workbench

The FEM workbench has several toolbars and menus. We will add the new command on to both the solve toolbar and the solve menu.

Search for the following code snippet in /Gui/Workbench.cpp and add the new command.

 
     Gui::ToolBarItem* solve = new Gui::ToolBarItem(root);
     solve->setCommand("Solve");
     *solve << "FEM_SolverCalculixCxxtools"
           << "FEM_SolverCalculiX"
           << "FEM_SolverElmer"
+          << "FEM_testButton"
           << "Separator"

To add the command to the solve menu of the FEM workbench, search for the following code snippet in Workbench.cpp.

 
    Gui::MenuItem* solve = new Gui::MenuItem;
    root->insertItem(item, solve);
    solve->setCommand("&Solve");
    *solve << "FEM_SolverCalculixCxxtools"
           << "FEM_SolverCalculiX"
           << "FEM_SolverElmer"
           << "FEM_SolverZ88"
+          << "FEM_testButton"
           << "Separator"

You have just added an test button onto FEM workbench toolbar and menu. Now, you can compile your own FreeCAD and test your new button.