TaskPanel Design - sliptonic/FreeCAD GitHub Wiki
Task Panels
Task panels are the UI concept used modal actions requiring user input. Task Panels appear on the 'Tasks' tab of the comboview.
General Guidelines
- Tasks should always correspond to a transaction. Thus pressing the 'undo' button immediately after closing a task, should revert everything done in that task.
Main Task Panel Buttons
- Task Panels should have either two or three buttons at the top of the panel which control the state of the task.
- Task Panels should always provide at least two buttons to control the task:
- 'ok' button commits the current task configuration and dismisses the panel.
- 'cancel' dismisses the panel and reverts all changes to the state prior to opening the task.
*Use of 'Apply' button
- Panels may optionally include an Apply button as well. The apply button will apply the current configuration to the affected items and update the 3D view but not close the task panel.
- Tasks whose calculation requires substantial time to complete should use an 'apply' button
- if the task panel has an apply button, no changes to any items should affect the 3D window until the apply button is pressed.
- If the task panel does not have an apply button, the 3D view should be updated as each property value is changed.
- Task Panel buttons should reflect the current options based on the state of the task.
-If no changes have been made, 'ok' and 'Apply' (if used) should be disabled. Actual update to the 3D should this be on value change or when the field loses focus or left to developer ??