Creare l'interfaccia

    From FreeCAD Documentation
    This page is a translated version of the page Interface creation and the translation is 100% complete.
    Other languages:

    Introduzione

    Gli utenti esperti hanno la possibilità di creare delle interfacce che li aiutino a produrre strumenti complessi per i loro addon personalizzati, come le macro o interi ambienti.

    Le interfacce vengono create usando PySide, che è una libreria per l'utilizzo di Qt con Python.

    FreeCAD creating interfaces.svg

    Due metodi generali per creare delle interfacce, includendo l'interfaccia nel file Python o usando i file .ui.

    Descrizione

    Esistono in genere due modi per creare delle interfacce con PySide.

    Interfaccia in un file .ui

    Con questo metodo l'interfaccia è definita in un file .ui (un documento XML che definisce la struttura dell'interfaccia), che viene poi importato nel codice Python che lo utilizza. Questo è l'approccio consigliato.

    • Consente al programmatore di lavorare con l'interfaccia grafica separatamente dalla logica che la utilizzerà.
    • Permette a chiunque di guardare solo l'interfaccia, cioè il file .ui, senza dover eseguire codice Python.
    • Il file .ui può essere progettato da chiunque non abbia conoscenze di programmazione.
    • L'interfaccia .ui può essere utilizzata in una finestra autonoma (modale) o in una finestra incorporata (non modale); pertanto, questo metodo è ideale per creare una Scheda Azioni.
    • Dato che il file .ui descrive solo "l'aspetto" dell'interfaccia, non ha bisogno di essere legato a un particolare linguaggio di programmazione; può essere utilizzato sia nel codice Python che in quello C++.

    Interfaccia completamente in codice Python

    In questo metodo l'intera interfaccia è definita da diverse chiamate Python.

    • Questo è un vecchio modo di lavorare con le interfacce.
    • Questo metodo produce un codice molto prolisso perché molti dettagli dell'interfaccia devono essere specificati manualmente.
    • Non è semplice separare l'interfaccia dalla logica che utilizza quel codice, il che significa che un utente dovrebbe eseguire il file Python nel contesto corretto per vedere come dovrebbe apparire l'interfaccia.
    • Questo metodo ha il vantaggio che diverse interfacce possono essere contenute all'interno di un singolo documento, a costo di rendere il file molto grande.
    • Questo metodo è consigliato solo per piccole interfacce che non definiscono più di alcuni widget, ad esempio in macro.

    Per esempi su questo metodo vedi Creare delle finestre di dialogo.