Std DlgParameter/it: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Created page with "Probabilmente è una cattiva idea modificare le preferenze di altre parti di FreeCAD a meno che non lo si faccia su richiesta dell'utente. Il setter può tuttavia essere utilizzato per impostare i parametri per il proprio ambiente di lavoro e il getter può essere utilizzato per obbedire ai parametri esistenti.")
 
(104 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{GuiCommand/it|Name=Parameter editor|Name/it=Parametri|Icon=Std DlgParameter.svg|Workbenches=Tutti|MenuLocation=[[Std Tools Menu/it|Strumenti]] → Modifica parametri... |Shortcut=|SeeAlso=}}


{{Docnav/it
|
|[[Std_ViewScreenShot/it|Cattura schermata]]
|[[Std_Tools_Menu/it|Menu strumenti]]
|IconL=
|IconR=Std_ViewScreenShot.svg
|IconC=Freecad.svg
}}

{{GuiCommand/it
|Name=Std_DlgParameter
|Name/it=Modifica parametri
|MenuLocation=Strumenti → Modifica parametri...
|Workbenches=Tutti
|SeeAlso=[[Preferences_Editor/it|Editor delle preferenze]]
}}

<span id="Description"></span>
==Descrizione==
==Descrizione==
[[Std DlgParameter/it|Editor dei parametri]] consente di accedere e modificare i parametri e le preferenze delle diverse funzioni e ambienti di lavoro.


Il comando '''Modifica parametri''' apre l'editor dei parametri. Nell'editor dei parametri i parametri che controllano il comportamento di FreeCAD e dei suoi ambienti di lavoro possono essere ispezionati e facoltativamente rimossi, aggiunti o modificati. I parametri sono memorizzati in un file chiamato {{FileName|user.cfg}}, la posizione di questo file dipende dal sistema operativo.
Le opzioni più comuni possono essere modificate dall' [[Preferences Editor/it|editor delle preferenze]], ma alcune modifiche sono accessibili solo tramite l'editor dei parametri.


Lavorare con l'editor dei parametri richiede una certa esperienza. Per i parametri più comuni conviene usare l'[[Preferences_Editor/it|editor delle preferenze]].
==Uso==
Andare nel menu {{MenuCommand|Strumenti → Modifica parametri}}; quindi sfogliare le diverse categorie per accedere alle variabili in ciascuna categoria.


[[Image:Std_DlgParameter_dialog.png]]
Consultare [[Fine-tuning/it|fine-tuning]] per vedere quali parametri possono essere modificati.
{{Caption|La finestra di dialogo Editor dei parametri}}


<span id="Usage"></span>
[[Image:Parameter_editor.png]]
==Utilizzo==


# Selezionare l'opzione {{MenuCommand|Strumenti → [[Image:Std_DlgParameter.svg|16px]] Modifica parametri...}} dal menu.
# Viene visualizzata la finestra di dialogo Editor parametri. Per ulteriori informazioni, vedere le [[Std_DlgParameter/it#Opzioni|Opzioni]].
# Opzionalmente premere il pulsante {{Button|Salva nel disco}} per aggiornare immediatamente il file {{FileName|user.cfg}}. Ciò non è indispensabile in quanto FreeCAD aggiornerà automaticamente quel file alla chiusura dell'applicazione.
# Premere il pulsante {{Button|Chiudi}} per chiudere l'editor dei parametri.

<span id="Options"></span>
==Opzioni==

<span id="Left_panel"></span>
===Pannello di sinistra===

Il pannello di sinistra mostra un albero con gruppi di parametri e sottogruppi.

''Nel menu di scelta rapida del pannello sono disponibili le seguenti opzioni:''

<span id="Expand/Collapse"></span>
====Espandi/Riduci====

# Se un gruppo selezionato ha uno o più sottogruppi, può essere espanso o compresso scegliendo questa opzione dal menu contestuale. Ma si può anche espandere e comprimere l'albero nel solito modo.

<span id="Add_sub-group"></span>
====Aggiungi sottogruppo====

# Selezionare un gruppo.
# Selezionare l'opzione {{MenuCommand|Aggiungi sottogruppo}} nel menu contestuale.
# Immettere un nome per il nuovo sottogruppo nella finestra di dialogo che si apre.
# Premere il pulsante {{Button|OK}}.

<span id="Remove_group"></span>
====Rimuovi gruppo====

# Selezionare un gruppo.
# Selezionare l'opzione {{MenuCommand|Rimuovi gruppo}} nel menu contestuale.
# Premere il pulsante {{Button|Sì}} nella finestra di dialogo che si apre per confermare che si desidera rimuovere il gruppo (inclusi tutti i suoi sottogruppi e tutti i parametri del gruppo e dei suoi sottogruppi).

<span id="Rename_group"></span>
====Rinomina gruppo====

# Selezionare un gruppo.
# Selezionare l'opzione {{MenuCommand|Rinomina gruppo}} nel menu contestuale.
# Inserire un nuovo nome
# Un gruppo può anche essere rinominato facendo doppio clic su di esso.

<span id="Export_parameter"></span>
====Esporta parametro====

# Selezionare un gruppo.
# Selezionare l'opzione {{MenuCommand|Esporta parametro}} nel menu contestuale.
# Immettere un nome file nella finestra di dialogo.
# Premere il pulsante {{Button|Salva}}.

<span id="Import_parameter"></span>
====Importa parametro====

# Selezionare un gruppo che non contiene alcun sottogruppo o rimuoverli prima. Tutti i parametri esistenti nel gruppo andranno persi.
# Selezionare l'opzione {{MenuCommand|Importa parametro}} nel menu contestuale.
# Selezionare un file *.FCParam nella finestra di dialogo.
# Premere il pulsante {{Button|Apri}}.

<span id="Right_panel"></span>
===Pannello di destra===

Il pannello di destra mostra i parametri nel gruppo selezionato nel pannello di sinistra. Se questo gruppo contiene solo sottogruppi, il pannello di destra è vuoto.

''Nel menu di scelta rapida del pannello sono disponibili le seguenti opzioni:''

<span id="Change_value"></span>
====Cambia valore====

# Selezionare un parametro
# Selezionare l'opzione {{MenuCommand|Cambia valore}} nel menu contestuale.
# Inserire un nuovo valore nella finestra di dialogo che si apre.
# Premere il pulsante {{Button|OK}}.
# Il valore di un parametro può anche essere modificato facendo doppio clic sul suo campo "Tipo" o "Valore".

<span id="Remove_key"></span>
====Rimuovi la chiave====

# Selezionare un parametro.
# Selezionare l'opzione {{MenuCommand|Rimuovi la chiave}} nel menu contestuale.

<span id="Rename_key"></span>
====Rinomina la chiave====

# Selezionare un gruppo.
# Selezionare l'opzione {{MenuCommand|Rinomina la chiave}} nel menu contestuale.
# Inserire un nuovo nome
# Un parametro può anche essere rinominato facendo doppio clic sul suo campo "Nome".

<span id="New_string_item"></span>
====Nuovo elemento string====

# Selezionare l'opzione {{MenuCommand|Nuovo elemento string}} o {{MenuCommand|Nuovo → Nuovo elemento string}} dal menu contestuale.
# Inserire un nome nella finestra di dialogo che si apre.
# Premere il pulsante {{Button|OK}}.
# Immettere un valore nella finestra di dialogo successiva.
# Premere il pulsante {{Button|OK}}.

<span id="New_float_item"></span>
====Nuovo elemento float====

# Selezionare l'opzione {{MenuCommand|Nuovo elemento float}} o {{MenuCommand|Nuovo → Nuovo elemento float}} dal menu contestuale.
# I passaggi successivi sono simili a quelli per un [[#Nuovo elemento string|Nuovo elemento string]]

<span id="New_integer_item"></span>
====Nuovo elemento integer====

# Seleziona l'opzione {{MenuCommand|Nuovo elemento integer}} o {{MenuCommand|Nuovo → Nuovo elemento integer}} dal menu contestuale.
# I passaggi successivi sono simili a quelli per un [[#New_string_item/it|Nuovo elemento string]]

<span id="New_unsigned_item"></span>
====Nuovo elemento unsigned====

# Seleziona l'opzione {{MenuCommand|Nuovo elemento unsigned}} o {{MenuCommand|Nuovo → Nuovo elemento unsigned}} dal menu contestuale.
# I passaggi successivi sono simili a quelli per un [[#Nuovo elemento string|Nuovo elemento string]]

<span id="New_Boolean_item"></span>
====Nuovo elemento Boolean====

# Selezionare l'opzione {{MenuCommand|Nuovo elemento Boolean}} o {{MenuCommand|Nuovo → Nuovo elemento Boolean}} dal menu contestuale.
# I passaggi successivi sono simili a quelli per un [[#Nuovo elemento string|Nuovo elemento string]]

<span id="Sorting"></span>
===Ordinamento===

Per impostazione predefinita, i gruppi in ogni livello dell'albero nel pannello di sinistra sono ordinati alfabeticamente e anche i parametri nel pannello di destra sono ordinati alfabeticamente. Ma l'ordine in ciascun pannello può essere invertito facendo clic rispettivamente sull'intestazione "Gruppo" o "Nome".

<span id="Quick_search"></span>
===Ricerca veloce===

La digitazione di una stringa (parziale) in questa casella di immissione espanderà completamente l'albero nel pannello di sinistra ed evidenzierà tutti i gruppi con nomi che corrispondono al valore immesso. Se non vengono trovate corrispondenze, lo sfondo della casella di input diventerà rosso.

<span id="Find"></span>
===Trova===

# Nel pannello di sinistra selezionare il gruppo dal quale iniziare la ricerca. La direzione di ricerca è verso il basso. La ricerca non è ristretta al gruppo e ai suoi sottogruppi, ma verrà effettuata nel gruppo selezionato e in tutto ciò che si trova sotto di esso nell'albero.
# Premere il pulsante {{Button|Trova...}}.
# Inserire una stringa nella casella di input '''Trova'''. La ricerca non fa distinzione tra maiuscole e minuscole.
# Selezionare una o più caselle di controllo {{CheckBox|TRUE|Gruppi}}, {{CheckBox|TRUE|Nomi}} e {{CheckBox|TRUE|Valori}}. Si noti che verranno cercati solo i valori stringa.
# Facoltativamente (de)selezionare la casella di controllo {{CheckBox|TRUE|Controlla solo stringa intera}}.
# Premere il pulsante {{Button|Trova successivo}} per selezionare il primo gruppo con una corrispondenza. I parametri corrispondenti non sono evidenziati individualmente. Se lo si desidera, ripetere l'operazione fino a quando non è possibile trovare ulteriori corrispondenze.
# È possibile iniziare una nuova ricerca senza chiudere la finestra di dialogo. Anche in questo caso, di solito è necessario selezionare il gruppo da cui iniziare la ricerca.
# Usare il pulsante {{Button|Annulla}} per chiudere la finestra di dialogo.

<span id="Notes"></span>
==Note==

* La pagina [[Fine-tuning/it|Ottimizzare l'installazione]] elenca una serie di parametri che potrebbero essere di interesse.

<span id="Scripting"></span>
==Script==
==Script==
È possibile manipolare la struttura dei parametri utilizzando l'API Python di FreeCAD:


{{Emphasis|Vedere anche:}} [[FreeCAD Scripting Basics/it|Script di base per FreeCAD]]
{{Code|code=
.GetBool(variable,bool) # method to get boolean


È possibile accedere alle preferenze dagli script Python utilizzando il percorso corrispondente in [[Std_DlgParameter/it|Modifica parametri]]. Ad esempio, la preferenza {{MenuCommand|Modifica → Preferenze → Importa-Esporta → DXF → Opzioni di importazione → Unisci geometria}} appare in {{MenuCommand|Strumenti → Modifica parametri → BaseApp → Preferences → Mod → Draft → dxfCreatePart}} che ha impostazione {{incode|Boolean}}. È quindi possibile accedervi in ​​Python utilizzando il seguente codice:
.SetBool # method to set boolean
{{Code|code=
.GetString
# get:
.SetString
App.ParamGet("User parameter:BaseApp/Preferences/Mod/Draft").GetBool('dxfCreatePart')
.GetFloat
# set:
.SetFloat
App.ParamGet("User parameter:BaseApp/Preferences/Mod/Draft").SetBool('dxfCreatePart', True)
}}
}}


Trovare quale parametro viene utilizzato per memorizzare quale opzione dall'editor delle preferenze può richiedere un po' di ricerca, ma l'[[Std_DlgParameter/it|Modifica parametri]] offre una funzione di ricerca, che dovrebbe essere d'aiuto.
{{Code|code=
.SetInt(variable, int) method to set integer
Example: to set the height of the Addon Manager
pref = FreeCAD.ParamGet("User parameter:BaseApp/Preferences/Addons")
pref.SetInt("WindowHeight",480)


Probabilmente è una cattiva idea modificare le preferenze di altre parti di FreeCAD a meno che non lo si faccia su richiesta dell'utente. Il setter può tuttavia essere utilizzato per impostare i parametri per il proprio ambiente di lavoro e il getter può essere utilizzato per obbedire ai parametri esistenti.
.GetInt
.RemInt
.GetUnsigned
}}



{{Code|code=
{{Docnav/it
App.ParamGet('User Parameters:BaseApp').GetGroup()
|
.GetContents()
|[[Std_ViewScreenShot/it|Cattura schermata]]
|[[Std_Tools_Menu/it|Menu strumenti]]
|IconL=
|IconR=Std_ViewScreenShot.svg
|IconC=Freecad.svg
}}
}}


{{Std Base navi{{#translation:}}}}
<div class="mw-translate-fuzzy">
{{Userdocnavi{{#translation:}}}}
{{Std Base/it}}
{{Userdocnavi/it}}
</div>

Latest revision as of 20:55, 14 April 2023

Modifica parametri

Posizione nel menu
Strumenti → Modifica parametri...
Ambiente
Tutti
Avvio veloce
Nessuno
Introdotto nella versione
-
Vedere anche
Editor delle preferenze

Descrizione

Il comando Modifica parametri apre l'editor dei parametri. Nell'editor dei parametri i parametri che controllano il comportamento di FreeCAD e dei suoi ambienti di lavoro possono essere ispezionati e facoltativamente rimossi, aggiunti o modificati. I parametri sono memorizzati in un file chiamato user.cfg, la posizione di questo file dipende dal sistema operativo.

Lavorare con l'editor dei parametri richiede una certa esperienza. Per i parametri più comuni conviene usare l'editor delle preferenze.

La finestra di dialogo Editor dei parametri

Utilizzo

  1. Selezionare l'opzione Strumenti → Modifica parametri... dal menu.
  2. Viene visualizzata la finestra di dialogo Editor parametri. Per ulteriori informazioni, vedere le Opzioni.
  3. Opzionalmente premere il pulsante Salva nel disco per aggiornare immediatamente il file user.cfg. Ciò non è indispensabile in quanto FreeCAD aggiornerà automaticamente quel file alla chiusura dell'applicazione.
  4. Premere il pulsante Chiudi per chiudere l'editor dei parametri.

Opzioni

Pannello di sinistra

Il pannello di sinistra mostra un albero con gruppi di parametri e sottogruppi.

Nel menu di scelta rapida del pannello sono disponibili le seguenti opzioni:

Espandi/Riduci

  1. Se un gruppo selezionato ha uno o più sottogruppi, può essere espanso o compresso scegliendo questa opzione dal menu contestuale. Ma si può anche espandere e comprimere l'albero nel solito modo.

Aggiungi sottogruppo

  1. Selezionare un gruppo.
  2. Selezionare l'opzione Aggiungi sottogruppo nel menu contestuale.
  3. Immettere un nome per il nuovo sottogruppo nella finestra di dialogo che si apre.
  4. Premere il pulsante OK.

Rimuovi gruppo

  1. Selezionare un gruppo.
  2. Selezionare l'opzione Rimuovi gruppo nel menu contestuale.
  3. Premere il pulsante nella finestra di dialogo che si apre per confermare che si desidera rimuovere il gruppo (inclusi tutti i suoi sottogruppi e tutti i parametri del gruppo e dei suoi sottogruppi).

Rinomina gruppo

  1. Selezionare un gruppo.
  2. Selezionare l'opzione Rinomina gruppo nel menu contestuale.
  3. Inserire un nuovo nome
  4. Un gruppo può anche essere rinominato facendo doppio clic su di esso.

Esporta parametro

  1. Selezionare un gruppo.
  2. Selezionare l'opzione Esporta parametro nel menu contestuale.
  3. Immettere un nome file nella finestra di dialogo.
  4. Premere il pulsante Salva.

Importa parametro

  1. Selezionare un gruppo che non contiene alcun sottogruppo o rimuoverli prima. Tutti i parametri esistenti nel gruppo andranno persi.
  2. Selezionare l'opzione Importa parametro nel menu contestuale.
  3. Selezionare un file *.FCParam nella finestra di dialogo.
  4. Premere il pulsante Apri.

Pannello di destra

Il pannello di destra mostra i parametri nel gruppo selezionato nel pannello di sinistra. Se questo gruppo contiene solo sottogruppi, il pannello di destra è vuoto.

Nel menu di scelta rapida del pannello sono disponibili le seguenti opzioni:

Cambia valore

  1. Selezionare un parametro
  2. Selezionare l'opzione Cambia valore nel menu contestuale.
  3. Inserire un nuovo valore nella finestra di dialogo che si apre.
  4. Premere il pulsante OK.
  5. Il valore di un parametro può anche essere modificato facendo doppio clic sul suo campo "Tipo" o "Valore".

Rimuovi la chiave

  1. Selezionare un parametro.
  2. Selezionare l'opzione Rimuovi la chiave nel menu contestuale.

Rinomina la chiave

  1. Selezionare un gruppo.
  2. Selezionare l'opzione Rinomina la chiave nel menu contestuale.
  3. Inserire un nuovo nome
  4. Un parametro può anche essere rinominato facendo doppio clic sul suo campo "Nome".

Nuovo elemento string

  1. Selezionare l'opzione Nuovo elemento string o Nuovo → Nuovo elemento string dal menu contestuale.
  2. Inserire un nome nella finestra di dialogo che si apre.
  3. Premere il pulsante OK.
  4. Immettere un valore nella finestra di dialogo successiva.
  5. Premere il pulsante OK.

Nuovo elemento float

  1. Selezionare l'opzione Nuovo elemento float o Nuovo → Nuovo elemento float dal menu contestuale.
  2. I passaggi successivi sono simili a quelli per un Nuovo elemento string

Nuovo elemento integer

  1. Seleziona l'opzione Nuovo elemento integer o Nuovo → Nuovo elemento integer dal menu contestuale.
  2. I passaggi successivi sono simili a quelli per un Nuovo elemento string

Nuovo elemento unsigned

  1. Seleziona l'opzione Nuovo elemento unsigned o Nuovo → Nuovo elemento unsigned dal menu contestuale.
  2. I passaggi successivi sono simili a quelli per un Nuovo elemento string

Nuovo elemento Boolean

  1. Selezionare l'opzione Nuovo elemento Boolean o Nuovo → Nuovo elemento Boolean dal menu contestuale.
  2. I passaggi successivi sono simili a quelli per un Nuovo elemento string

Ordinamento

Per impostazione predefinita, i gruppi in ogni livello dell'albero nel pannello di sinistra sono ordinati alfabeticamente e anche i parametri nel pannello di destra sono ordinati alfabeticamente. Ma l'ordine in ciascun pannello può essere invertito facendo clic rispettivamente sull'intestazione "Gruppo" o "Nome".

Ricerca veloce

La digitazione di una stringa (parziale) in questa casella di immissione espanderà completamente l'albero nel pannello di sinistra ed evidenzierà tutti i gruppi con nomi che corrispondono al valore immesso. Se non vengono trovate corrispondenze, lo sfondo della casella di input diventerà rosso.

Trova

  1. Nel pannello di sinistra selezionare il gruppo dal quale iniziare la ricerca. La direzione di ricerca è verso il basso. La ricerca non è ristretta al gruppo e ai suoi sottogruppi, ma verrà effettuata nel gruppo selezionato e in tutto ciò che si trova sotto di esso nell'albero.
  2. Premere il pulsante Trova....
  3. Inserire una stringa nella casella di input Trova. La ricerca non fa distinzione tra maiuscole e minuscole.
  4. Selezionare una o più caselle di controllo Gruppi, Nomi e Valori. Si noti che verranno cercati solo i valori stringa.
  5. Facoltativamente (de)selezionare la casella di controllo Controlla solo stringa intera.
  6. Premere il pulsante Trova successivo per selezionare il primo gruppo con una corrispondenza. I parametri corrispondenti non sono evidenziati individualmente. Se lo si desidera, ripetere l'operazione fino a quando non è possibile trovare ulteriori corrispondenze.
  7. È possibile iniziare una nuova ricerca senza chiudere la finestra di dialogo. Anche in questo caso, di solito è necessario selezionare il gruppo da cui iniziare la ricerca.
  8. Usare il pulsante Annulla per chiudere la finestra di dialogo.

Note

Script

Vedere anche: Script di base per FreeCAD

È possibile accedere alle preferenze dagli script Python utilizzando il percorso corrispondente in Modifica parametri. Ad esempio, la preferenza Modifica → Preferenze → Importa-Esporta → DXF → Opzioni di importazione → Unisci geometria appare in Strumenti → Modifica parametri → BaseApp → Preferences → Mod → Draft → dxfCreatePart che ha impostazione Boolean. È quindi possibile accedervi in ​​Python utilizzando il seguente codice:

# get:
App.ParamGet("User parameter:BaseApp/Preferences/Mod/Draft").GetBool('dxfCreatePart')
# set:
App.ParamGet("User parameter:BaseApp/Preferences/Mod/Draft").SetBool('dxfCreatePart', True)

Trovare quale parametro viene utilizzato per memorizzare quale opzione dall'editor delle preferenze può richiedere un po' di ricerca, ma l'Modifica parametri offre una funzione di ricerca, che dovrebbe essere d'aiuto.

Probabilmente è una cattiva idea modificare le preferenze di altre parti di FreeCAD a meno che non lo si faccia su richiesta dell'utente. Il setter può tuttavia essere utilizzato per impostare i parametri per il proprio ambiente di lavoro e il getter può essere utilizzato per obbedire ai parametri esistenti.