메뉴
How to create dropdown/flyout toolbar buttons in FreeCAD using command groups. Required reading before adding grouped commands to InitGui.py.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | DM FreeCAD Command Group (Dropdown Toolbar Buttons) |
| description | How to create dropdown/flyout toolbar buttons in FreeCAD using command groups. Required reading before adding grouped commands to InitGui.py. |
FreeCAD toolbars can show dropdown/flyout buttons that expand to reveal related commands. This is done by registering a "group command" that returns a list of sub-commands.
class DMPrimitiveGroup:
"""Dropdown group for multiple related creation commands."""
def GetCommands(self):
"""Return tuple of command IDs that appear in the dropdown."""
return (
'DM_CreateBox',
'DM_CreateSphere',
'DM_CreateCylinder',
)
def GetDefaultCommand(self):
"""Index into GetCommands() for the default (top-level) button."""
return 0
def GetResources(self):
return {
'MenuText': 'Create Primitive',
'ToolTip': 'Create an SDF primitive shape',
}
def IsActive(self):
return FreeCAD.activeDocument() is not None
FreeCADGui.addCommand('DM_PrimitiveGroup', DMPrimitiveGroup())
Add only the group command ID to the toolbar — NOT the individual sub-commands:
self.appendToolbar("DM - Constructive", [
'DM_WorkPlane',
'DM_PrimitiveGroup', # ← dropdown appears here
'DM_FillCurve',
])
Individual sub-commands must still be registered with FreeCADGui.addCommand() — the group
just bundles them visually.
For menus, list the individual commands (not the group) so each gets its own menu entry:
self.appendMenu("Direct Modeling", [
'DM_CreateBox',
'DM_CreateSphere',
'DM_CreateCylinder',
])
GetCommands() must return a tuple of strings (not a list)addCommand()GetDefaultCommand() returns the index (int), not the command IDActivated() — clicking a sub-command calls that sub-command's Activated()GetResources() Pixmap is used only as fallback — the default sub-command's icon is normally shownInitGui.py — toolbar registrationcommands/cmd_primitive.py — existing flat command patternArchitecture reference for the unified edit-mode transform gizmo (translation arrows + rotation rings, transform spaces, x-ray rendering). Required reading before implementing any task in todo.md whose ID begins with GIZMO-.
Reference for the two-color (orange/blue) boolean system where IsSubtractive classifies inputs into groups and boolean operations combine them into a parent-child tree. Required reading before implementing any task in todo_bool.md.
Standardized pattern for creating interactive SDF primitive tools in the Direct Modeling workbench.
Template and rules for creating new SDF primitive field classes in core/sdf/sdf/. Required reading before implementing any new SdfField subclass.
Reference for converting SVG path data (M L H V C S Q T A Z) and shape elements (rect, circle, ellipse, line, polyline, polygon) into cubic Bezier segments with no rasterization. Required reading before implementing svg_importer.py.
Convention for registering primitive-specific GLSL inside the primitive's own .py file. Required reading before editing any to_glsl/to_glsl_2d method.