Gui Command

From FreeCAD Documentation
Revision as of 08:35, 9 November 2018 by Luc (talk | contribs)

GuiCommand este una dintre cele mai importante funcții ale FreeCAD în principalul punct de interacțiune al utilizatorului. De fiecare dată când utilizatorul selectează un element de meniu sau apasă butonul unei bare de instrumente pe care îl activează a GuiCommand. Unele dintre atributele unui GuiCommand sunt:

  • Definește un nume
  • Conține o pictogramă
  • Definește domeniul de aplicare pentru o anulare / refacere
  • Are o pagină de ajutor
  • Deschide și controlează dialogurile
  • Înregistrare macro
  • si asa mai departe...

Nominalizare

The GuiCommand is named in a certain way: ModuleName_CommandName e.g "Base_Open" this is the Open Gui Command in the Base system. The GuiCommand in a certain module is named with the module name in front e.g. "Part_Cylinder".

If the docu is not finished use Template:UnfinishedDocu

Pagina Help

Fiecare GuiCommand trebuie să aibă o pagină de ajutor. Pagina de ajutor este găzduită pe FreeCAD docu wiki. Articolul are același nume ca și GuiCommand, de ex. Draft ShapeString.

To create your own help pages you can use the template: GuiCommand model

Exemplu:

Iconițe

Every GuiCommand has to have an icon. We use the Tango icon set and its guidelines. On the right side you see the tango color palette.

Preferable all Icons are drafted with SVG with e.g. Inkscape. This makes it easier to apply changes and derive additional Icons in the same application space.

icons color coding chart

Încercăm cât mai mult posibil să respectăm această diagramă, astfel încât culoarea icoanelor are un sens direct.

Cerințe de calitate

Există o mulțime de GuiCommands (Funcții) în FreeCAD care sunt experimentale sau utilizate în scurt timp pentru punerea în aplicare. Aceste comenzi Gui sunt în mare parte în Atelierele de lucru dedicate cum ar fi Part, Mesh/Plasa sau Cam. Pentru a asigura o bună experiență a utilizatorilor, a fost creat "Workbench" "Complete". Acest Atelier de lucru include toate GuiCommands care îndeplinesc anumite "cerințe de calitate " care sunt descrise aici:

  • The Command/Feature has to be finished. No work in progress!
  • Has to have a help page like Draft ShapeString
    • All the fields in Template:GuiCommand have to filled in
    • A picture of the dialogs the command eventually yield
    • detailed description of the command and all its parameters and settings
    • Description of the related python interfaces and classes with example code
  • Set up a proper Icon and menu position

Sperăm că acest lucru devine adevărat pentru toți GuiCommands dinList of Commands.