{"id":3612,"date":"2025-10-03T22:39:00","date_gmt":"2025-10-03T20:39:00","guid":{"rendered":"https:\/\/davidka.net\/?p=3612"},"modified":"2025-10-24T12:40:58","modified_gmt":"2025-10-24T09:40:58","slug":"lektion-4-grafische-benutzeroberflache-gui","status":"publish","type":"post","link":"http:\/\/de.davidka.net\/de\/lektion-4-grafische-benutzeroberflache-gui\/","title":{"rendered":"Lektion 4. Grafische Benutzeroberfl\u00e4che (GUI): Dialogfenster mit Eingabefeldern"},"content":{"rendered":"\n<p class=\"has-neve-link-color-color has-text-color has-link-color has-medium-font-size wp-elements-baab409e3716459f89082d6a85825529 wp-block-paragraph\"><strong>Lernziel:<\/strong> Erstelle ein Fenster mit Feldern zur Eingabe von L\u00e4nge, Breite und H\u00f6he und baue durch Klick auf eine Schaltfl\u00e4che eine Box mit diesen Parametern.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Teil 1. Wie funktioniert die GUI in FreeCAD?<\/strong><br>FreeCAD verwendet <strong>PySide<\/strong> \u2013 einen Python-Wrapper f\u00fcr die Qt-Bibliothek (dieselbe, die auch in Blender, Maya und vielen anderen Programmen verwendet wird).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Wichtige Komponenten:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code class=\"\" data-line=\"\">QtGui.QDialog<\/code> \u2014 modales Fenster<\/li>\n\n\n\n<li><code class=\"\" data-line=\"\">QtGui.QLineEdit<\/code> \u2014 Texteingabefeld<\/li>\n\n\n\n<li><code class=\"\" data-line=\"\">QtGui.QPushButton<\/code> \u2014 Schaltfl\u00e4che<\/li>\n\n\n\n<li><code class=\"\" data-line=\"\">QtGui.QFormLayout<\/code> \u2014 praktisches Layout f\u00fcr \u201eBeschriftung + Feld\u201c<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Alle GUI-Elemente werden innerhalb eines Python-Skripts erstellt \u2013 ohne externe Dateien (obwohl man auch <code class=\"\" data-line=\"\">.ui<\/code>-Dateien aus Qt Designer nutzen kann; wir beginnen jedoch mit etwas Einfachem).<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Teil 2. Addon: \u201eBox Builder mit GUI\u201c<\/strong><br>Wir erweitern das vorherige Addon um ein Dialogfenster.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Schritt 1. Ordner erstellen<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code line-numbers\"><code class=\" language-python\" data-line=\"\">...\/Mod\/BoxBuilderAddon\/<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Schritt 2. Datei <code class=\"\" data-line=\"\">InitGui.py<\/code><\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code line-numbers\"><code class=\" language-python\" data-line=\"\"># InitGui.py\nimport FreeCADGui\nfrom BoxBuilderAddon.box_builder_workbench import BoxBuilderWorkbench\n\nFreeCADGui.addWorkbench(BoxBuilderWorkbench())<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Schritt 3. Datei <code class=\"\" data-line=\"\">box_builder_workbench.py<\/code><\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code line-numbers\"><code class=\" language-python\" data-line=\"\"># box_builder_workbench.py\nimport FreeCAD, FreeCADGui\nfrom PySide import QtGui, QtCore\n\n# === BOX-ERSTELLUNGSFUNKTION ===\ndef create_box(length, width, height, name=&quot;CustomBox&quot;):\n    doc = FreeCAD.ActiveDocument\n    if not doc:\n        doc = FreeCAD.newDocument(&quot;BoxBuilder&quot;)\n\n    # Eindeutiger Name\n    base_name = name\n    index = 1\n    obj_name = base_name\n    while obj_name in &#091;obj.Name for obj in doc.Objects]:\n        obj_name = f&quot;{base_name}_{index}&quot;\n        index += 1\n\n    box = doc.addObject(&quot;Part::Box&quot;, obj_name)\n    box.Length = length\n    box.Width = width\n    box.Height = height\n    doc.recompute()\n    return box\n\n# === DIALOGFENSTER ===\nclass BoxBuilderDialog(QtGui.QDialog):\n    def __init__(self):\n        super(BoxBuilderDialog, self).__init__()\n        self.setWindowTitle(&quot;Box Builder&quot;)\n        self.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)\n        self.resize(300, 150)\n\n        # Eingabefelder\n        self.length_input = QtGui.QLineEdit(&quot;30.0&quot;)\n        self.width_input = QtGui.QLineEdit(&quot;20.0&quot;)\n        self.height_input = QtGui.QLineEdit(&quot;10.0&quot;)\n\n        # Schaltfl\u00e4chen\n        self.create_button = QtGui.QPushButton(&quot;Box erstellen&quot;)\n        self.cancel_button = QtGui.QPushButton(&quot;Abbrechen&quot;)\n\n        # Schaltfl\u00e4chen verbinden\n        self.create_button.clicked.connect(self.on_create)\n        self.cancel_button.clicked.connect(self.reject)\n\n        # Layout\n        layout = QtGui.QFormLayout()\n        layout.addRow(&quot;L\u00e4nge (mm):&quot;, self.length_input)\n        layout.addRow(&quot;Breite (mm):&quot;, self.width_input)\n        layout.addRow(&quot;H\u00f6he (mm):&quot;, self.height_input)\n\n        button_layout = QtGui.QHBoxLayout()\n        button_layout.addWidget(self.create_button)\n        button_layout.addWidget(self.cancel_button)\n\n        main_layout = QtGui.QVBoxLayout()\n        main_layout.addLayout(layout)\n        main_layout.addLayout(button_layout)\n        self.setLayout(main_layout)\n\n    def on_create(self):\n        try:\n            length = float(self.length_input.text())\n            width = float(self.width_input.text())\n            height = float(self.height_input.text())\n\n            if length &lt;= 0 or width &lt;= 0 or height &lt;= 0:\n                raise ValueError(&quot;Alle Abmessungen m\u00fcssen positiv sein&quot;)\n\n            create_box(length, width, height)\n            self.accept()  # Fenster schlie\u00dfen\n\n        except ValueError as e:\n            QtGui.QMessageBox.warning(self, &quot;Eingabefehler&quot;, f&quot;Ung\u00fcltige Eingabe:\\n{str(e)}&quot;)\n\n# === BEFEHL ===\nclass BoxBuilderCommand:\n    def GetResources(self):\n        return {\n            &quot;MenuText&quot;: &quot;Box Builder&quot;,\n            &quot;ToolTip&quot;: &quot;Erstelle eine Box mit benutzerdefinierten Abmessungen&quot;\n        }\n\n    def Activated(self):\n        dialog = BoxBuilderDialog()\n        dialog.exec_()  # Modaler Aufruf\n\n    def IsActive(self):\n        return True\n\n# === ARBEITSUMGEBUNG ===\nclass BoxBuilderWorkbench(FreeCADGui.Workbench):\n    MenuText = &quot;Box Builder&quot;\n    ToolTip = &quot;Erstelle benutzerdefinierte Boxen mit grafischer Oberfl\u00e4che&quot;\n\n    def Initialize(self):\n        self.list = &#091;&quot;BoxBuilderCommand&quot;]\n        self.appendToolbar(&quot;Box-Werkzeuge&quot;, self.list)\n        self.appendMenu(&quot;Box Builder&quot;, self.list)\n\n    def GetClassName(self):\n        return &quot;Gui::PythonWorkbench&quot;\n\nFreeCADGui.addCommand(&quot;BoxBuilderCommand&quot;, BoxBuilderCommand())<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Analyse der wichtigsten Teile<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Dialogfenster (<code class=\"\" data-line=\"\">BoxBuilderDialog<\/code>)<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Erbt von <code class=\"\" data-line=\"\">QtGui.QDialog<\/code><\/li>\n\n\n\n<li>Verwendet <code class=\"\" data-line=\"\">QFormLayout<\/code> f\u00fcr eine \u00fcbersichtliche Anordnung der Felder<\/li>\n\n\n\n<li>Die Schaltfl\u00e4che \u201eBox erstellen\u201c ruft <code class=\"\" data-line=\"\">on_create()<\/code> auf, \u201eAbbrechen\u201c schlie\u00dft das Fenster<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Eingabeverarbeitung<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Wandelt Text in <code class=\"\" data-line=\"\">float<\/code> um<\/li>\n\n\n\n<li>Pr\u00fcft, ob Werte positiv sind<\/li>\n\n\n\n<li>Bei Fehlern wird eine Warnung \u00fcber <code class=\"\" data-line=\"\">QMessageBox.warning<\/code> angezeigt<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Objekterstellung<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Die Funktion <code class=\"\" data-line=\"\">create_box()<\/code> ist separat \u2013 f\u00fcr \u00fcbersichtlicheren Code<\/li>\n\n\n\n<li>Generiert einen eindeutigen Namen, um Konflikte zu vermeiden<\/li>\n<\/ul>\n\n\n\n<ol class=\"wp-block-list\">\n<li><strong>Fensterstart<\/strong><\/li>\n<\/ol>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code class=\"\" data-line=\"\">dialog.exec_()<\/code> macht das Fenster modal (man kann FreeCAD nicht bedienen, solange es ge\u00f6ffnet ist)<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Schritt 4. Funktionspr\u00fcfung<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Speichere die Dateien<\/li>\n\n\n\n<li>Starte FreeCAD neu<\/li>\n\n\n\n<li>W\u00e4hle die Arbeitsumgebung \u201eBox Builder\u201c aus<\/li>\n\n\n\n<li>Klicke auf die Schaltfl\u00e4che \u201eBox Builder\u201c<\/li>\n\n\n\n<li>Gib im erscheinenden Fenster Abmessungen ein \u2192 klicke auf \u201eBox erstellen\u201c<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">Es sollte eine Box mit deinen Parametern erscheinen!<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Probiere aus:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Buchstaben eingeben \u2192 Fehlermeldung erscheint<\/li>\n\n\n\n<li>Negative Zahl eingeben \u2192 Fehler<\/li>\n\n\n\n<li>Dezimalzahlen (z.\u202fB. 12,5) eingeben \u2192 funktioniert!<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Praktische Aufgabe<\/strong><\/p>\n\n\n\n<ol class=\"wp-block-list\">\n<li>F\u00fcge ein viertes Feld <strong>\u201eName\u201c<\/strong> hinzu \u2013 damit der Benutzer den Objektnamen festlegen kann.<\/li>\n\n\n\n<li>Stelle sicher, dass bei leerem Namen der Standardwert (<code class=\"\" data-line=\"\">&quot;CustomBox&quot;<\/code>) verwendet wird.<\/li>\n\n\n\n<li>F\u00fcge ein Kontrollk\u00e4stchen <strong>\u201eAm Ursprung zentrieren\u201c<\/strong> hinzu \u2013 wenn aktiviert, soll die Box am Ursprung zentriert werden.<\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Hinweis zur Zentrierung:<\/strong><br>Nach der Erstellung der Box die <code class=\"\" data-line=\"\">Placement<\/code>-Eigenschaft \u00e4ndern:<\/p>\n\n\n\n<pre class=\"wp-block-code line-numbers\"><code class=\" language-python\" data-line=\"\">from FreeCAD import Vector\nbox.Placement.Base = Vector(-length\/2, -width\/2, -height\/2)<\/code><\/pre>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Tipps zur Arbeit mit der GUI<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Umschlie\u00dfe Eingaben <strong>immer mit <code class=\"\" data-line=\"\">try\/except<\/code><\/strong> \u2013 der Benutzer kann alles M\u00f6gliche eingeben<\/li>\n\n\n\n<li>Verwende optional <code class=\"\" data-line=\"\">QDoubleValidator<\/code>, um nur Zahlen zuzulassen<\/li>\n\n\n\n<li>F\u00fcr komplexe Oberfl\u00e4chen ist es besser, <strong>Qt Designer<\/strong> zu nutzen und <code class=\"\" data-line=\"\">.ui<\/code>-Dateien zu laden \u2013 f\u00fcr einfache Aufgaben reicht jedoch Code<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Was kommt als N\u00e4chstes?<\/strong><br>In <strong>Lektion 5<\/strong> werden wir:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Lernen, wie man Einstellungen zwischen FreeCAD-Sitzungen speichert<\/li>\n\n\n\n<li>Sicherstellen, dass der zuletzt eingegebene Wert gemerkt wird<\/li>\n\n\n\n<li>Den integrierten Mechanismus von FreeCAD nutzen: <code class=\"\" data-line=\"\">FreeCAD.ParamGet()<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Damit wird dein Addon noch komfortabler!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>Lernziel: Erstelle ein Fenster mit Feldern zur Eingabe von L\u00e4nge, Breite und H\u00f6he und baue durch Klick auf eine Schaltfl\u00e4che eine Box mit diesen Parametern.<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"neve_meta_sidebar":"","neve_meta_container":"","neve_meta_enable_content_width":"","neve_meta_content_width":0,"neve_meta_title_alignment":"","neve_meta_author_avatar":"","neve_post_elements_order":"","neve_meta_disable_header":"","neve_meta_disable_footer":"","neve_meta_disable_title":"","_themeisle_gutenberg_block_has_review":false,"footnotes":""},"categories":[],"tags":[],"class_list":["post-3612","post","type-post","status-publish","format-standard","hentry"],"_links":{"self":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts\/3612","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/comments?post=3612"}],"version-history":[{"count":0,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/posts\/3612\/revisions"}],"wp:attachment":[{"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/media?parent=3612"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/categories?post=3612"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/de.davidka.net\/de\/wp-json\/wp\/v2\/tags?post=3612"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}