Jump to content

Std Variablensatz erstellen

From FreeCAD Documentation
This page is a translated version of the page Std VarSet and the translation is 100% complete.

Std Variablensatz erstellen

Menüeintrag
Keiner
Arbeitsbereich
Alle
Standardtastenkürzel
Keiner
Eingeführt in Version
1.0
Siehe auch
Spreadsheet, DynamicData

Beschreibung

Der Befehl Std Variablensatz erstellen erstellt einen Variablensatz. Ein Variablensatz ist ein Objekt, das einen Satz von Eigenschaften verwaltet, die als Variablen in Ausdrücken verwendet werden können.

Das Dialogfeld Eigenschaft hinzufügen

Anwendung

  1. Eine der folgenden Möglichkeiten ausführen:
    • Ein neuen Variablensatz anlegen: Die Schaltfläche Variablensatz drücken.
    • Einen bestehenden Variablensatz bearbeiten: Ein Doppelklick auf den Variablensatz in der Baumansicht.
  2. Das Dialogfeld Eigenschaften hinzufügen wird geöffnet.
  3. Einen Namen für die Eigenschaft eingeben.
    • Der Name muss für den Variablensatz eindeutig sein.
    • Nur alphanumerische Zeichen und Unterstriche (A bis Z, a bis z, 0 bis 9 und _) sind zulässig.
    • Das erste Zeichen darf keine Ziffer sein.
    • FreeCAD verwendet die Binnenmajuskel Konvention für die Namen seiner Eigenschaften, d.h. jedes Wort beginnt mit einem Großbuchstaben, und es gibt keine Leerzeichen oder Unterstriche. Wenn die Eigenschaften-Ansicht einen solchen Namen anzeigt, werden Leerzeichen zwischen den Wörtern eingefügt, um die Lesbarkeit des Namens zu verbessern. Es ist ratsam, diese Konvention zu befolgen.
  4. Den Namen für die Gruppe der Eigenschaft eingeben oder eine Gruppe aus der Liste auswählen. Für Gruppennamen gelten die gleichen Einschränkungen wie für die Namen der Eigenschaften.
  5. Die Art der Eigenschaft in der Auswahlliste Typ auswählen. Siehe unten für gebräuchliche Arten von Eigenschaften.
  6. Einen Wert für die Eigenschaft eingeben. Die Eingabe einer Einheit wird akzeptiert, falls eine Einheit für die Eigenschaft vorgesehen ist. Es kann auch ein Ausdruck eingegeben werden.
  7. 1.0 und davor: Wahlweise das Kontrollkästchen Weitere hinzufügen aktivieren, um weitere Eigenschaften hinzuzufügen.
  8. Wahlweise eine Quick-Info für die Eigenschaft eingeben.
  9. Die Schaltfläche OK drücken.
  10. Das Dialogfeld wird erneut geöffnet (1.0 und davor: nur wenn das Kontrollkästchen Weitere hinzufügen aktiviert wurde) und es kann eine weitere Eigenschaft hinzugefügt werden.
  11. Die Schaltfläche Abbrechen drücken, um das Hinzufügen von Eigenschaften zu beenden.

Gebräuchliche Typen von Eigenschaften

FreeCAD unterstützt viele Eigenschaftstypen. Die folgende Tabelle listet einige der gebräuchlichsten Typen auf. Siehe PythonFunktion Benutzerdefinierte Eigenschaften für weitere Informationen.

Eigenschaftstyp Standardeinheit (falls vorhanden) Bemerkung
App::PropertyAngle ° (oder deg)
App::PropertyBool true oder false, kann in Bedingten Ausdrücken verwendet werden
App::PropertyDistance mm
App::PropertyFloat Dezimalzahl
App::PropertyInteger Ganze Zahl
App::PropertyLength mm Ähnlich wie App::PropertyDistance kann aber nicht negativ sein
App::PropertyString Zeichenkette

Hinweise

  • Eigenschaften können auch zu bestehenden Variablensätzen über den Ausdruckseditor hinzugefügt werden, wenn das Kontrollkästchen In Variablensatz speichern… ausgewählt ist.
  • Eine Eigenschaft kann über das Kontextmenü der Eigenschaften-Ansicht aus einem Variablensatz entfernt werden.
  • Der Name einer Gruppe kann über dasselbe Kontextmenü geändert werden.
  • 1.0 und davor: Der Befehl kann nicht die Liste der zulässigen Elemente einer App::PropertyEnumeration-Eigenschaft festlegen. Dies kann mit Python-Code erfolgen oder in der Eigenschaften-Ansicht. Die Schritte für letztere Möglichkeit sind:
    1. Ausgeblendete anzeigen im Kontextmenü der Eigenschaften-Ansicht auswählen.
    2. Den Eintrag der Eigenschaft erweitern.
    3. In das Feld Aufzählung klicken.
    4. Die Schaltfläche drücken, die jetzt angezeigt wird.
    5. Werte im Dialogfenster Liste eingeben, das geöffnet wird.
    6. Die Schaltfläche OK drücken.
  • Variablensätze können auch mit Befehlen des Arbeitsbereich DynamicData bearbeitet werden. Eigenschaften können. umbenannt, neu gruppiert, neu eingegeben und ihre QuickInfos aktualisiert werden. Dieser externe Arbeitsbereich kann mit dem Addon-Manager installiert werden.

Skripten

import FreeCAD as App

doc = App.ActiveDocument

var_set = doc.addObject("App::VarSet", "VarSetName")
var_set.addProperty("App::PropertyInteger", "MyNumber")  # Property is added to the Base group.
var_set.MyNumber = 123
var_set.addProperty("App::PropertyString", "MyText", group="SomeGroup", doc="Some tooltip information")
var_set.MyText = "Abc"

doc.recompute()