Gui Command/de: Difference between revisions

Latest revision as of 13:34, 27 September 2022

Other languages:

Der GUI-Befehl (Befehl der grafischen Benutzerschnittstelle) ist eine der wichtigsten Funktionen von FreeCAD im Hauptinteraktionsbereich des Benutzers. Jedes Mal, wenn der Benutzer einen Menüeintrag auswählt oder eine Schaltfläche in der Werkzeugleiste drückt, wird ein GUI-Befehl aktiviert. Einige der Merkmale eines GUI-Befehls sind:

Definiert einen Namen
Enthält ein Symbol
Definiert den Umfang für ein Rückgängigmachen/Wiederherstellen.
Besitzt eine Hilfeseite
Öffnet und steuert Dialoge
Makroaufnahme
und andere.

Benennung

Der GUI-Befehl wird nach einem Standardmuster benannt: Modulname_Befehlsname, z.B. "Base_Öffnen"; dies wäre der GUI-Befehl Öffnen in einem Basissystem. Der GUI-Befehl in einem bestimmten Modul wird mit dem Modulnamen an erster Stelle benannt z.B. "Part Zylinder"

Wenn die Dokumentation noch nicht fertig ist, verwendet man die Vorlage UnfinishedDocu.

Hilfe-Seite

Jeder GUI-Befehl muss eine Hilfeseite haben. Die Hilfeseite wird im Wiki der FreeCAD-Dokumentation gehostet. Der Artikel hat den gleichen Namen wie der GUI-Befehl, z.B. Draft ShapeString.

Um eigene Hilfeseiten zu erstellen, kann man die Vorlage GuiCommand model verwenden.

Beispiel:

Symbole

Jeder GUI-Befehl muss ein Symbol haben. Wir verwenden den Tango Symbolsatz und seine Richtlinien. Auf der rechten Seite ist die Tango-Farbpalette dargestellt.

Alle Symbole sollten im Format SVG mit einer Vektorgrafikanwendung, wie beispielsweise Inkscape, erstellt werden. Dies erleichtert die Anwendung von Änderungen und die Ableitung von zusätzlichen Symbolen im gleichen Anwendungsbereich.

Symbol-Farbkodierungstabelle

Wir versuchen so weit wie möglich, dieses Diagramm zu berücksichtigen, und so hat die Farbe der Symbole eine direkte Bedeutung.

Power user documentation

FreeCAD scripting: Python, Introduction to Python, Python scripting tutorial, FreeCAD Scripting Basics

Modules: Builtin modules, Units, Quantity
Workbenches: Workbench creation, Gui Commands, Commands, Installing more workbenches
Meshes and Parts: Mesh Scripting, Topological data scripting, Mesh to Part, PythonOCC

Parametric objects: Scripted objects, Viewproviders (Custom icon in tree view)
Scenegraph: Coin (Inventor) scenegraph, Pivy
Graphical interface: Interface creation, Interface creation completely in Python (1, 2, 3, 4, 5), PySide, PySide examples beginner, intermediate, advanced
Macros: Macros, How to install macros
Embedding: Embedding FreeCAD, Embedding FreeCADGui

Other: Expressions, Code snippets, Line drawing function, FreeCAD vector math library (deprecated)

Hubs: User hub, Power users hub, Developer hub

@@ Line 1: / Line 1: @@
 <languages/>
+{{TOCright}}
 Der GUI-Befehl (Befehl der grafischen Benutzerschnittstelle) ist eine der wichtigsten Funktionen von FreeCAD im Hauptinteraktionsbereich des Benutzers. Jedes Mal, wenn der Benutzer einen Menüeintrag auswählt oder eine Schaltfläche in der Werkzeugleiste drückt, wird ein GUI-Befehl aktiviert. Einige der Merkmale eines GUI-Befehls sind:
 * Definiert einen Namen
@@ Line 9: / Line 11: @@
 * und andere.
-== Benennung ==
+==Benennung==
-Der GUI-Befehl wird nach einem Standardmuster benannt: ''Modulname_Befehlsname'', z.B. "[[Base_Open/de|Base_Öffnen]]" Dies wäre der GUI-Befehl Öffnen in einem Basissystem.
-Der GUI-Befehl in einem bestimmten Modul wird mit dem Modulnamen an erster Stelle benannt z.B. "[[Part_Cylinder/de|Part Zylinder]]"
+Der GUI-Befehl wird nach einem Standardmuster benannt: ''Modulname_Befehlsname'', z.B. "[[Base_Open/de|Base_Öffnen]]"; dies wäre der GUI-Befehl Öffnen in einem Basissystem. Der GUI-Befehl in einem bestimmten Modul wird mit dem Modulnamen an erster Stelle benannt z.B. "[[Part_Cylinder/de|Part Zylinder]]"
 Wenn die Dokumentation noch nicht fertig ist, verwendet man die Vorlage [[Template:UnfinishedDocu|UnfinishedDocu]].
-== Hilfeseite ==
+==Hilfe-Seite==
 Jeder GUI-Befehl muss eine Hilfeseite haben. Die Hilfeseite wird im Wiki der
 FreeCAD-Dokumentation gehostet. Der Artikel hat den gleichen Namen wie der GUI-Befehl, z.B. [[Draft_ShapeString|Draft ShapeString]].
@@ Line 25: / Line 28: @@
 * [[Draft_Line|Draft Line]]
-== Symbole ==
+==Symbole==
 [[Image:Tango-Palette.png|400px|right]]
-Jeder GUI-Befehl muss ein Symbol haben. Wir verwenden den [http://tango-project.org/Tango_Desktop_Project/ Tango Symbolsatz] und seine Richtlinien.
+Jeder GUI-Befehl muss ein Symbol haben. Wir verwenden den [http://tango-project.org/Tango_Desktop_Project/ Tango Symbolsatz] und seine Richtlinien. Auf der rechten Seite ist die Tango-Farbpalette dargestellt.
-Auf der rechten Seite ist die Tango-Farbpalette dargestellt.
-Alle Symbole sollten im Format [[SVG|SVG]] mit einer Vektorgrafikanwendung, wie beispielsweise [http://inkscape.org Inkscape], erstellt werden.
+Alle Symbole sollten im Format [[SVG/de|SVG]] mit einer Vektorgrafikanwendung, wie beispielsweise [http://inkscape.org Inkscape], erstellt werden.
 Dies erleichtert die Anwendung von Änderungen und die Ableitung von zusätzlichen Symbolen im gleichen Anwendungsbereich.
-=== Symbol-Farbkodierungstabelle===
+===Symbol-Farbkodierungstabelle===
 [[Image:Colorchart.png|200px]]
-Wir versuchen so weit wie möglich, dieses Diagramm zu respektieren, so dass die Farbe der Symbole eine direkte Bedeutung hat.
+Wir versuchen so weit wie möglich, dieses Diagramm zu berücksichtigen, und so hat die Farbe der Symbole eine direkte Bedeutung.
-== Qualitätsanforderungen ==
-{{VeryImportantMessage|Die [[Complete Workbench/de|Complete Workbench]] ist veraltet, sie enthält nicht mehr jeden der Befehle in FreeCAD.}}
-<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 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:
-* Der Befehl oder die Funktion muss "fertig" sein, d.h. es handelt sich nicht um eine laufende Arbeit.
-* Es muss ein geeignetes Symbol und eine korrekte Menüposition eingerichtet werden.
-* Es muss eine Hilfeseite haben, wie [[Draft ShapeString/de|Draft ShapeString]].
-** Alle Felder in [[Template:GuiCommand]] müssen ausgefüllt werden.
-** Es sollte eine detaillierte Beschreibung des Befehls und aller Parameter und Einstellungen enthalten.
-** Es sollte ein Bild der Dialoge haben, die der Befehl erzeugen wird.
-** Es sollte eine Beschreibung der zugehörigen [[Python|Python]] Schnittstellen und Klassen mit Beispielcode enthalten.
-Hoffentlich wird dies für alle Gui Befehle in der [[List of Commands/de|List of Commands]].</s> wahr.
 {{Powerdocnavi{{#translation:}}}}
-{{clear}}