Gui Befehl

From FreeCAD Documentation
Revision as of 20:53, 19 November 2019 by Maker (talk | contribs) (Created page with "<s>Es gibt viele Gui Befehle (Werkzeuge) in FreeCAD, die experimentell sind. oder für kurze Zeit genutzt werden, um die Implementierung neuer Funktionen zu testen. Diese Gui...")

Der Gui Befehl ist eine der wichtigsten Funktionen von FreeCAD. im Hauptinteraktionspunkt des Benutzers. Jedes Mal, wenn der Benutzer einen Menüpunkt auswählt oder eine Schaltfläche in der Werkzeugleiste drückt , die einen Gui Befehl aktiviert. Einige der Attribute eines Gui Befehls sind:

  • Definiert einen Namen
  • Enthält ein Symbol
  • Definiert den Umfang für ein Rückgängigmachen/Wiederherstellen.
  • Hat eine Hilfeseite
  • Öffnet und kontrolliert Dialoge
  • Makro Aufnahme
  • und andere.

Benennung

Der Gui Befehl wird standardmäßig benannt: ModuleName_CommandName. z.B. "Base_Open" Dies ist der Open Gui Befehl im Basissystem. Der Gui Befehl in einem bestimmten Modul wird mit dem Modulnamen benannt. davor z.B. "Teil Zylinder"

Wenn die Dokumentation noch nicht fertig ist, verwende Template:UnfinishedDocu.

Hilfeseite

Jeder Gui Befehl muss eine Hilfeseite haben. Die Hilfeseite wird auf der Seite FreeCAD Dokumentations Wiki. Der Artikel hat den gleichen Namen wie der Gui Befehl, z.B. Draft ShapeString.

Um Deine eigenen Hilfeseiten zu erstellen, kannst Du die Vorlage GuiCommand model verwenden.

Beispiel:

Symbole

Jeder Gui Befehl muss ein Symbol haben. Wir verwenden das Tango-Icon-Set und seine Richtlinien. Auf der rechten Seite siehst du die Tango-Farbpalette.

Alle Symbole sollten im Format SVG mit einer Vektorbildanwendung, wie beispielsweise Inkscape, erstellt werden. Dies erleichtert die Übernahme von Änderungen und die Ableitung von Änderungen. zusätzliche Symbole im gleichen Anwendungsbereich.

Symbol Farbkodierungstabelle

Wir versuchen so weit wie möglich, dieses Diagramm zu respektieren, so dass die Farbe der Symbole eine direkte Bedeutung hat.

Qualitätsanforderungen

Die Complete Workbench ist veraltet, sie enthält nicht mehr jeden der Befehle in FreeCAD.

Es gibt viele Gui Befehle (Werkzeuge) in FreeCAD, die experimentell sind. oder für kurze Zeit genutzt werden, um die Implementierung neuer Funktionen zu testen. Diese Gui Befehle befinden sich meist in den zugeordneten Arbeitsbereichen wie Part, Mesh oder Cam. Um ein gutes Benutzererlebnis zu gewährleisten, wurde der Arbeitsbereich Complete erstellt. Dieser Arbeitsbereich enthält alle Gui Befehle die bestimmte Qualitätsanforderungen erfüllen, die hier beschrieben werden:

  • The command or feature has to be "finished", that is, not be a work in progress.
  • It has to set up a proper icon and menu position.
  • It has to have a help page, like Draft ShapeString.
    • All the fields in Template:GuiCommand have to be filled in
    • It should have a detailed description of the command and all its parameters and settings.
    • It should have a picture of the dialogs that the command will produce.
    • It should have a description of the related Python interfaces and classes with example code.

Hopefully this becomes true for all GuiCommands in the List of Commands.