{"id":3617,"date":"2025-10-03T22:30:28","date_gmt":"2025-10-03T20:30:28","guid":{"rendered":"https:\/\/ru.davidka.net\/ru\/?p=3617"},"modified":"2025-10-04T01:33:14","modified_gmt":"2025-10-03T23:33:14","slug":"lezione-4-gui","status":"publish","type":"post","link":"https:\/\/it.davidka.net\/it\/lezione-4-gui\/","title":{"rendered":"Lezione 4. Interfaccia grafica (GUI): finestra di dialogo con campi di input"},"content":{"rendered":"\n<p class=\"has-medium-font-size wp-block-paragraph\"><em>\ud83d\udcd8 Corso di formazione: Creazione di addon per FreeCAD<\/em><\/p>\n\n\n\n<div id=\"rtoc-mokuji-wrapper\" class=\"rtoc-mokuji-content frame2 preset1 animation-fade rtoc_open default\" data-id=\"3617\" data-theme=\"Neve - Davidka\">\n\t\t\t<div id=\"rtoc-mokuji-title\" class=\"rtoc_btn_none rtoc_left\">\n\t\t\t\n\t\t\t<span>In Questo Articolo<\/span>\n\t\t\t<\/div><ol class=\"rtoc-mokuji decimal_ol level-1\"><li class=\"rtoc-item\"><a href=\"#rtoc-1\"><\/a><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-2\">\ud83d\uddbc Parte 1. Come funziona la GUI in FreeCAD?<\/a><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-2\">\ud83d\udee0 Parte 2. Addon: \u00abBox Builder con GUI\u00bb<\/a><ul class=\"rtoc-mokuji mokuji_ul level-2\"><li class=\"rtoc-item\"><a href=\"#rtoc-3\">Passaggio 1. Crea una cartella<\/a><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-4\">Passaggio 2. File <code class=\"\" data-line=\"\">InitGui.py<\/code><\/a><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-5\">Passaggio 3. File <code class=\"\" data-line=\"\">box_builder_workbench.py<\/code><\/a><\/li><\/ul><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-6\">\ud83d\udd0d Analisi delle parti chiave<\/a><ul class=\"rtoc-mokuji mokuji_ul level-2\"><li class=\"rtoc-item\"><a href=\"#rtoc-7\">1. Finestra di dialogo (<code class=\"\" data-line=\"\">BoxBuilderDialog<\/code>)<\/a><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-8\">2. Elaborazione dell&#8217;input<\/a><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-9\">3. Creazione dell&#8217;oggetto<\/a><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-10\">4. Avvio della finestra<\/a><\/li><\/ul><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-11\">\u25b6\ufe0f Passaggio 4. Verifica del funzionamento<\/a><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-12\">\ud83e\uddea Esercizio pratico<\/a><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-13\">\ud83d\udca1 Consigli per lavorare con la GUI<\/a><\/li><li class=\"rtoc-item\"><a href=\"#rtoc-14\">\u25b6\ufe0f Cosa c&#8217;\u00e8 dopo?<\/a><\/li><\/ol><\/div><h2 id=\"rtoc-1\"  class=\"wp-block-heading\"><\/h2>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\"><strong>Obiettivo della lezione<\/strong>: creare una finestra con campi per l&#8217;inserimento di lunghezza, larghezza e altezza, e al clic di un pulsante costruire una scatola con questi parametri.<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">\ud83d\uddbc Parte 1. Come funziona la GUI in FreeCAD?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">FreeCAD utilizza <strong>PySide<\/strong> \u2014 un wrapper Python per la libreria <strong>Qt<\/strong> (la stessa usata in Blender, Maya e molti altri programmi).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Componenti principali:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code class=\"\" data-line=\"\">QtGui.QDialog<\/code> \u2014 finestra modale<\/li>\n\n\n\n<li><code class=\"\" data-line=\"\">QtGui.QLineEdit<\/code> \u2014 campo di input testuale<\/li>\n\n\n\n<li><code class=\"\" data-line=\"\">QtGui.QPushButton<\/code> \u2014 pulsante<\/li>\n\n\n\n<li><code class=\"\" data-line=\"\">QtGui.QFormLayout<\/code> \u2014 layout comodo &#8220;etichetta + campo&#8221;<\/li>\n<\/ul>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\ud83d\udca1 Tutti gli elementi GUI vengono creati <strong>all&#8217;interno dello script Python<\/strong>, senza file esterni (anche se \u00e8 possibile utilizzare <code class=\"\" data-line=\"\">.ui<\/code> da Qt Designer \u2014 ma inizieremo con il semplice).<\/p>\n<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 id=\"rtoc-2\"  class=\"wp-block-heading\">\ud83d\udee0 Parte 2. Addon: \u00abBox Builder con GUI\u00bb<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Estenderemo l&#8217;addon precedente, aggiungendo una finestra di dialogo.<\/p>\n\n\n\n<h3 id=\"rtoc-3\"  class=\"wp-block-heading\">Passaggio 1. Crea una cartella<\/h3>\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<h3 id=\"rtoc-4\"  class=\"wp-block-heading\">Passaggio 2. File <code class=\"\" data-line=\"\">InitGui.py<\/code><\/h3>\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<h3 id=\"rtoc-5\"  class=\"wp-block-heading\">Passaggio 3. File <code class=\"\" data-line=\"\">box_builder_workbench.py<\/code><\/h3>\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# === FUNZIONE DI CREAZIONE SCATOLA ===\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    # Nome unico\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\n# === FINESTRA DI DIALOGO ===\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        # Campi di input\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        # Pulsanti\n        self.create_button = QtGui.QPushButton(&quot;Create Box&quot;)\n        self.cancel_button = QtGui.QPushButton(&quot;Cancel&quot;)\n\n        # Connessione dei pulsanti\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;Length (mm):&quot;, self.length_input)\n        layout.addRow(&quot;Width (mm):&quot;, self.width_input)\n        layout.addRow(&quot;Height (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;All dimensions must be positive&quot;)\n\n            create_box(length, width, height)\n            self.accept()  # Chiudi la finestra\n\n        except ValueError as e:\n            QtGui.QMessageBox.warning(self, &quot;Input Error&quot;, f&quot;Invalid input:\\n{str(e)}&quot;)\n\n\n# === COMANDO ===\nclass BoxBuilderCommand:\n    def GetResources(self):\n        return {\n            &quot;MenuText&quot;: &quot;Box Builder&quot;,\n            &quot;ToolTip&quot;: &quot;Create a box with custom dimensions&quot;\n        }\n\n    def Activated(self):\n        dialog = BoxBuilderDialog()\n        dialog.exec_()  # Chiamata modale\n\n    def IsActive(self):\n        return True\n\n\n# === AMBIENTE DI LAVORO ===\nclass BoxBuilderWorkbench(FreeCADGui.Workbench):\n    MenuText = &quot;Box Builder&quot;\n    ToolTip = &quot;Create custom boxes with GUI&quot;\n\n    def Initialize(self):\n        self.list = &#091;&quot;BoxBuilderCommand&quot;]\n        self.appendToolbar(&quot;Box Tools&quot;, self.list)\n        self.appendMenu(&quot;Box Builder&quot;, self.list)\n\n    def GetClassName(self):\n        return &quot;Gui::PythonWorkbench&quot;\n\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<h2 id=\"rtoc-6\"  class=\"wp-block-heading\">\ud83d\udd0d Analisi delle parti chiave<\/h2>\n\n\n\n<h3 id=\"rtoc-7\"  class=\"wp-block-heading\">1. <strong>Finestra di dialogo (<code class=\"\" data-line=\"\">BoxBuilderDialog<\/code>)<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Eredita da <code class=\"\" data-line=\"\">QtGui.QDialog<\/code><\/li>\n\n\n\n<li>Utilizza <code class=\"\" data-line=\"\">QFormLayout<\/code> per un posizionamento ordinato dei campi<\/li>\n\n\n\n<li>Il pulsante <strong>Create Box<\/strong> chiama <code class=\"\" data-line=\"\">on_create()<\/code>, <strong>Cancel<\/strong> \u2014 chiude la finestra<\/li>\n<\/ul>\n\n\n\n<h3 id=\"rtoc-8\"  class=\"wp-block-heading\">2. <strong>Elaborazione dell&#8217;input<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Convertiamo il testo in <code class=\"\" data-line=\"\">float<\/code><\/li>\n\n\n\n<li>Verifichiamo che i valori siano <strong>positivi<\/strong><\/li>\n\n\n\n<li>In caso di errore \u2014 mostriamo un avviso tramite <code class=\"\" data-line=\"\">QMessageBox.warning<\/code><\/li>\n<\/ul>\n\n\n\n<h3 id=\"rtoc-9\"  class=\"wp-block-heading\">3. <strong>Creazione dell&#8217;oggetto<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li>La funzione <code class=\"\" data-line=\"\">create_box()<\/code> \u00e8 separata \u2014 per un codice pi\u00f9 pulito<\/li>\n\n\n\n<li>Genera un nome unico per evitare conflitti<\/li>\n<\/ul>\n\n\n\n<h3 id=\"rtoc-10\"  class=\"wp-block-heading\">4. <strong>Avvio della finestra<\/strong><\/h3>\n\n\n\n<ul class=\"wp-block-list\">\n<li><code class=\"\" data-line=\"\">dialog.exec_()<\/code> \u2014 rende la finestra <strong>modale<\/strong> (non \u00e8 possibile interagire con FreeCAD finch\u00e9 \u00e8 aperta)<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 id=\"rtoc-11\"  class=\"wp-block-heading\">\u25b6\ufe0f Passaggio 4. Verifica del funzionamento<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Salva i file<\/li>\n\n\n\n<li>Riavvia FreeCAD<\/li>\n\n\n\n<li>Seleziona l&#8217;ambiente di lavoro <strong>\u00abBox Builder\u00bb<\/strong><\/li>\n\n\n\n<li>Clicca sul pulsante <strong>\u00abBox Builder\u00bb<\/strong><\/li>\n\n\n\n<li>Nella finestra che appare, inserisci le dimensioni \u2192 clicca su <strong>Create Box<\/strong><\/li>\n<\/ol>\n\n\n\n<p class=\"wp-block-paragraph\">\u2705 Dovrebbe apparire una scatola con i tuoi parametri!<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Prova a:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Inserire lettere \u2192 apparir\u00e0 un errore<\/li>\n\n\n\n<li>Inserire un numero negativo \u2192 errore<\/li>\n\n\n\n<li>Inserire numeri decimali (ad esempio, <code class=\"\" data-line=\"\">12.5<\/code>) \u2192 funziona!<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 id=\"rtoc-12\"  class=\"wp-block-heading\">\ud83e\uddea Esercizio pratico<\/h2>\n\n\n\n<ol class=\"wp-block-list\">\n<li>Aggiungi un <strong>quarto campo<\/strong>: \u00abName\u00bb \u2014 in modo che l&#8217;utente possa specificare il nome dell&#8217;oggetto.<\/li>\n\n\n\n<li>Fai in modo che, se il nome \u00e8 vuoto, venga utilizzato un valore predefinito (<code class=\"\" data-line=\"\">&quot;CustomBox&quot;<\/code>).<\/li>\n\n\n\n<li>Aggiungi una <strong>casella di controllo<\/strong> \u00abCenter on origin\u00bb \u2014 se selezionata, la scatola dovrebbe essere centrata all&#8217;origine.<\/li>\n<\/ol>\n\n\n\n<blockquote class=\"wp-block-quote is-layout-flow wp-block-quote-is-layout-flow\">\n<p class=\"wp-block-paragraph\">\ud83d\udca1 Suggerimento per la centratura:<br>Dopo aver creato la scatola, modifica la sua propriet\u00e0 <code class=\"\" data-line=\"\">Placement<\/code>:<\/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<\/blockquote>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 id=\"rtoc-13\"  class=\"wp-block-heading\">\ud83d\udca1 Consigli per lavorare con la GUI<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Avvolgi sempre l&#8217;input in <code class=\"\" data-line=\"\">try\/except<\/code> \u2014 l&#8217;utente pu\u00f2 inserire qualsiasi cosa<\/li>\n\n\n\n<li>Utilizza <code class=\"\" data-line=\"\">QDoubleValidator<\/code> per consentire solo numeri (opzionale)<\/li>\n\n\n\n<li>Per interfacce complesse \u00e8 meglio usare <strong>Qt Designer<\/strong> e caricare file <code class=\"\" data-line=\"\">.ui<\/code>, ma per compiti semplici \u2014 il codice \u00e8 pi\u00f9 facile<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 id=\"rtoc-14\"  class=\"wp-block-heading\">\u25b6\ufe0f Cosa c&#8217;\u00e8 dopo?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Nella <strong>Lezione 5<\/strong> impareremo a:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li><strong>Salvare le impostazioni<\/strong> tra gli avvii di FreeCAD<\/li>\n\n\n\n<li>Fare in modo che l&#8217;ultimo valore delle dimensioni inserito venga <strong>memorizzato<\/strong><\/li>\n\n\n\n<li>Utilizzare il meccanismo integrato di FreeCAD: <code class=\"\" data-line=\"\">FreeCAD.ParamGet()<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Questo render\u00e0 il tuo addon ancora pi\u00f9 comodo!<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\ud83d\udcd8 Corso di formazione: Creazione di addon per FreeCAD In Questo Articolo \ud83d\uddbc Parte 1. Come funziona la GUI in FreeCAD? \ud83d\udee0 Parte 2. Addon: \u00abBox Builder con GUI\u00bb Passaggio 1. Crea una cartella Passaggio 2. File InitGui.py Passaggio 3. File box_builder_workbench.py \ud83d\udd0d Analisi delle parti chiave 1. Finestra di dialogo (BoxBuilderDialog) 2. Elaborazione dell&#8217;input&hellip;&nbsp;<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"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":[948],"tags":[],"class_list":["post-3617","post","type-post","status-publish","format-standard","hentry","category-creazione-di-addon-per-freecad"],"acf":[],"_links":{"self":[{"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/posts\/3617","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/comments?post=3617"}],"version-history":[{"count":0,"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/posts\/3617\/revisions"}],"wp:attachment":[{"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/media?parent=3617"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/categories?post=3617"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/it.davidka.net\/it\/wp-json\/wp\/v2\/tags?post=3617"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}