Eigenschaften der Datei objects.inp

Benutzerdefinierte Attributdefinitionen in der Datei objects.inp halten folgende Struktur ein.

Allgemeine Informationen zum Ändern von Definitionen, z. B. Dateipfad und Lesereihenfolge, finden Sie unter Definieren und Aktualisieren von benutzerdefinierten Attributen (BDA).

Benutzerdefinierte Attribute können auch ausgeblendet oder ausgegraut werden. Weitere Informationen finden Sie unter Ausblenden und Ausgrauen von benutzerdefinierten Attributen.

In diesem Beispiel werden die wichtigsten Eigenschaften der Datei objects.inp dargestellt:

attribute("MY_INFO_1", "My Info 1", string, "%s", no, none, "0.0", "0.0")
{
	value ("", 0)
}
picture("image_name", 8, 2, 260, 25)

Allgemeine Eigenschaften


Eigenschaft	Im Beispiel	Beschreibung
`attribute` oder `unique_attribute`	`attribute`	Hierüber spezifizieren Sie, ob es sich um ein reguläres oder ein nicht kopierbares Attribut handelt. `attribute` ist ein reguläres Attribut, das zusammen mit anderen Teileigenschaften kopiert wird. `unique_attribute` ist ein nicht kopierbares Attribut. Der Wert des Attributs wird niemals in einen anderen Teil kopiert. Statusattribute der Teileprüfung können z. B. normalerweise nicht kopiert werden.
`attribute_name`	`MY_INFO_1`	Das ist der Attributname, über den der Attributwert gesucht werden kann. Vergewissern Sie sicher, dass Tekla Structures nicht den von Ihnen verwendeten Attributnamen noch nicht verwendet. Ziehen Sie in Betracht, den Namen durch ein Präfix, z. B. durch Ihre Initialen oder die Abkürzung des Unternehmensnamens, einmalig zu gestalten. Bei Attributnamen wird zwischen Groß- und Kleinschreibung unterschieden. Verwenden Sie keine Leerzeichen oder reservierte Zeichen in Attributnamen. Der Name darf maximal 19 Zeichen lang sein. Um das Attribut in einer Liste oder eine Vorlage aufzunehmen, fügen Sie den Namen des Attributs in Ihr Layout im Vorlageneditor ein. Beim Ausführen einer Liste oder Erstellen einer Zeichnung zeigt Tekla Structures den aktuellen Wert des Attributs an.
`label_text`	`My Info 1`	Diese Bezeichnung zeigt Tekla Structures im Dialogfeld. Einige Standardattribute haben Eingabeaufforderungen, z. B. `j_comment`. Das bedeutet, dass die Eingabeaufforderung aus der Meldungsdatei joints.ail stammt.
`value_type`	`string`	Das ist der Werttyp, den das Feld enthalten kann. Wenn Sie den `value_type` ändern müssen, erstellen Sie ein neues benutzerdefiniertes Attribut, anstatt das aktuelle Attribut in der Datei objects.inp zu ändern. Wenn Sie zum Beispiel den `value_type` von `string` in `option` ändern, kann der Wert nicht für Teile geändert werden, deren Eigenschaft mit dem alten Werttyp angegeben wurde. Daraufhin wird der Wert in Listen oder bei Abfragen von Objekten falsch angezeigt. Wenn die erweiterte Option XS_DIAGNOZE_AND_REPAIR_WRONG_UDA_TYPE auf `TRUE` eingestellt ist, können Sie über Diagnose und Reparatur > Attributdefinitionen prüfen und ändern die fehlerhaften BDA-Werttypen erkennen und durch das Wiederherstellen der Standardwerte für die Werttypen diese reparieren. Bei dem Befehl wird geprüft, ob die BDA-Werttypen wie `string` oder `option`, die in der Datei objects.inp definiert sind, den in environment.db definierten Werten entsprechen. Werden Werttypen nach Zuweisung der BDA-Werte geändert, treten gegebenenfalls Abweichungen auf.
`field_format`	`%s`	Format des Feldes im Dialogfeld `%s` bei Strings `%d` bei Zahlen
`special_flag`	`no`	Bei Teilen: Hiermit wird spezifiziert, ob das Teil bei der Positionierung zu berücksichtigen ist. Bei Zeichnungen: Hiermit wird spezifiziert, ober der Attributwert im Dokument-Manager angezeigt wird. Bei anderen Elementen: Auf diese hat die Eigenschaft keine Wirkung. Geben Sie `no` oder `yes` ein. Die Spezialmarkierung wird beim Attribut `FixedMainView` nicht berücksichtigt.
`check_switch`	`none`	Diese Eigenschaft findet keine Anwendung. Geben Sie immer `none` ein.
`attribute_value_max`	`0.0`	Diese Eigenschaft findet keine Anwendung. Geben Sie immer `0.0` ein.
`attribute_value_min`	`0.0`	Diese Eigenschaft findet keine Anwendung. Geben Sie immer `0.0` ein.
`value("attribute_value", default_switch)`	`value ("", 0)`	Das ist der Wert des Attributs und die Angabe, ob es sich um den Standardwert handelt. Der Text `attribute_value` in Anführungszeichen dient als Attributwert. Der einzugebende Werttyp richtet sich nach dem Werttyp des Attributs. Steht kein Text in Anführungszeichen, bleibt der Wert leer. Beim Werttyp `option` kann ein Werte aus der Werteliste als Standardwert eingestellt werden. Die nach dem Komma angegebene Zahl `default_switch` spezifiziert, ob es sich um den Standardwert handelt: 2: Der Wert ist zwar der Standardwert, wurde jedoch nicht in der Datenbank gespeichert. In den meisten Fällen empfiehlt sich die Verwendung von 2, damit die Datenbank nicht unnötig groß wird. 1: Der Wert ist der Standardwert und in der Datenbank gespeichert. 0: Der Wert ist nicht der Standardwert. Sollte es sich beim Werttyp nicht um `option` handelt, verwenden Sie immer 0. Ist keiner der Werte als Standardwert festgelegt, gilt automatisch der erste Wert der Liste als Standardwert.

Bildeigenschaften


Eigenschaft	Im Beispiel	Beschreibung
`picture`	`picture`	`picture` dient zum Hinzufügen von Bildern in Dialogfeldern mit benutzerdefinierten Attributen.
Bildname	`image_name`	Das ist der Name des Bildes.
Breite	`2`	Das ist die für das Bild reservierte Breite.
Höhe	`8`	Das ist die für das Bild reservierte Höhe.
Horizontaler Versatz	`260`	Das ist der horizontale Abstand zwischen der linken Bildkante und der linken Kante des Dialogfeldes.
vertikaler Versatz	`25`	Das ist der vertikale Abstand zwischen Oberkante Bild und Oberkante Dialogfeld ab Unterkante Registerkartenbereich.

Werttypen in benutzerdefinierten Attributen


Werttyp	Beschreibung	Zulässige Werte
`angle`	Winkel (Grad)	Zahlen mit einer Dezimalstelle
`area`	Fläche (mm²)	Zahlen mit einer Dezimalstelle
`areaperlength`	Fläche nach Einheitslänge (mm²/m)	Zahlen mit einer Dezimalstelle
`bolt_size`	Durchmesser	Zahlen mit einer Dezimalstelle
`bolt_standard`	Schraubennorm	Text
`date`	Datum mit kleinem Kalender	Datum in Tag, Monat und Jahr
`date_time_min`	Datum und Uhrzeit in Stunden und Minuten [12:00] mit kleinem Kalender	Datum in Tag, Monat und Jahr und Uhrzeit in Stunden und Minuten.
`date_time_sec`	Datum und Uhrzeit in Stunden, Minuten und Sekunden [12:00:00] mit kleinem Kalender	Datum in Tag, Monat und Jahr und Uhrzeit in Stunden, Minuten und Sekunden.
`deformation`	Formänderung (mm)	Zahlen mit einer Dezimalstelle
`density`	Dichte (kg/m³)	Zahlen mit einer Dezimalstelle
`dimension`	Abmessung (mm)	Zahlen mit einer Dezimalstelle
`distribload`	Verteilte Last (N/m)	Zahlen mit einer Dezimalstelle
`distribmoment`	Verteiltes Moment (Nm/m)	Zahlen mit einer Dezimalstelle
`file_in`	Eingabedatei	Text
`file_out`	Ausgabedatei	Text
`float`	Eine Zahl mit einer Dezimalstelle	Zahlen mit einer Dezimalstelle
`force`	Kraft (N)	Zahlen mit einer Dezimalstelle
`integer`	Eine Ganzzahl	Ganze Zahlen
`label`	Die Bezeichnung des Felds	Text
`material`	Material Typ	Ganze Zahlen zur Darstellung des Materialtyps: 1: Stahl 2: Beton 5: Holz 6: Allgemeines
`modulus`	Elastizitätsmodul (N/m²)	Zahlen mit einer Dezimalstelle
`moment`	Moment (Nm)	Zahlen mit einer Dezimalstelle
`momentofinertia`	Trägheitsmoment (mm⁴)	Zahlen mit einer Dezimalstelle
`option`	Eine Dropdown-Optionsliste. Die einzelnen Optionen sind jeweils mit der Eigenschaft `value ("", 0)` anzugeben.	Text
`profile`	Profil	Text
`radiusofinertia`	Trägheitsradius (mm)	Zahlen mit einer Dezimalstelle
`ratio`	Verhältnis	Zahlen mit einer Dezimalstelle
`rotspringconst`	Drehfederkonstante (Nm/rad)	Zahlen mit einer Dezimalstelle
`sectionmodulus`	Widerstandsmoment (mm³)	Zahlen mit einer Dezimalstelle
`springconstant`	Federkonstante (N/m)	Zahlen mit einer Dezimalstelle
`strain`	Dehnung	Zahlen mit einer Dezimalstelle
`strength`	Festigkeit (N/m²)	Zahlen mit einer Dezimalstelle
`string`	Im Feld angezeigter Text. Der Wert im Feld wird gespeichert oder geändert, sobald der Benutzer auf die Schaltfläche Anwenden bzw. Ändern klickt.	Text Die maximale Länge beträgt 79 Zeichen.
`string_not_modifiable`	Im Feld angezeigter, schreibgeschützter Text. Ein Feld mit der Eigenschaft `string_not_modifiable` immer ausgegraut angezeigt. Benutzer können den Wert des Feldes nicht ändern. Der Wert im Feld wird nicht gespeichert oder geändert, sobald der Benutzer auf die Schaltfläche Anwenden bzw. Ändern klickt.	Schreibgeschützter Text Die maximale Länge beträgt 79 Zeichen.
`surfaceload`	Flächenlast (N/m²)	Zahlen mit einer Dezimalstelle
`temperature`	Temperatur K (°C)	Zahlen mit einer Dezimalstelle
`thermdilatcoeff`	Ausdehnungskoeffizient 1/K (1/°C)	Zahlen mit einer Dezimalstelle
`torsionconstant`	Torsionskonstante (mm⁴)	Zahlen mit einer Dezimalstelle
`warpingconstant`	Wölbsteifigkeit (mm⁶)	Zahlen mit einer Dezimalstelle
`weight`	Gewicht (kg)	Zahlen mit einer Dezimalstelle

Beispiele für Werttypen in benutzerdefinierten Attributen

Anhand dieser Beispiele wird gezeigt, wie einige typische Werttypen in benutzerdefinierten Attributen genutzt werden.

Fläche

unique_attribute("ADReinfArea", "", area, "%d", no, none, "0.0", "0.0", 260, 440, 120)
{
     value("", 0)
}

Datum

unique_attribute("CHECKED_DATE", "j_CheckedDate", date, "%d", no, none, "0.0", "0.0")
{
     value("", 0)
}

Abstand

attribute("xs_shorten", "j_xs_shorten", distance, "%d", yes, none, "0.0", "0.0")
{
     value("0.0", 0)
}

float

attribute("PRODUCT_WEIGHT", "j_Product_weight", float,"%d", no, none, "0.0", "0.0")
{
     value("", 0)
}

force

unique_attribute("shear1", "", force, "%d", no, none, "0.0", "0.0", 260, 180, 120)
{
     value("-2147483648.0", 0)
}

integer

unique_attribute("NUMBERING_ORDER", "j_Numbering_Order", integer, "%d", no, none, "0.0", "0.0")
{
     value("", 0)
}

Überschrift in

attribute("start", "j_AD_start_node", label, "%s", no, none, "0.0", "0.0", 300, 20)

moment

unique_attribute("moment2", "", moment, "%d", no, none, "0.0", "0.0", 460, 210, 120)
{
     value("-2147483648.0", 0)
}

option

unique_attribute("OBJECT_LOCKED", "j_Locked", option,"%s", no, none,"0.0", "0.0")
{
     value("", 2)
     value("j_No", 0)
     value("j_Yes", 0)
}

string

attribute("comment", "j_comment", string, "%s", no, none, "0.0", "0.0")
{
     value("", 0)
}

Teil-BDA-Einstellungen kopieren

Einige benutzerdefinierte Attribute, z. B. der Modellprüfstatus, sind beim Kopieren von Teilen nicht zu kopieren. Diese Attribute werden als nicht-kopierbar bezeichnet und in der Datei object.inp als „unique_attribute“ definiert.

Siehe Beispiele unten. Werden die Definitionszeilen der Attributliste des Trägers in der Datei object.inp hinzugefügt, wird im Eigenschaftendialog des Trägers (1) der neue BDA-Text „Status überprüfen“ angezeigt. Somit wird der Wert des jeweiligen Feld Status überprüfen beim Kopieren des Trägers nicht kopiert. Die entsprechende Definition für ein normales, kopierbares Attribut wird zum Vergleich nachfolgend dargestellt.

Beispiel für ein nicht-kopierbares Attribut:

unique_attribute("check_status", "Check status", string, "%s", no, none, "0.0", "0.0")
    {
        value("", 0)
    }

Beispiel für ein normales, kopierbares Attribut:

attribute("comment", "j_comment", string, "%s", yes, none, "0.0", "0.0")
    {
        value("", 0)
    }

Über die Eigenschaft tab_page

Die Definition von tab_page muss im Abschnitt part angegeben sein. Die Abschnitte für bestimmte Attribute, z. B. column oder beam müssen hingegen nur einen Verweis darauf aufweisen.

/***************************************************************************/
/* Part attributes */
/***************************************************************************/
part(0,"Part")
{
 /* User defined tab page */
 tab_page("My UDA tab")
 {
 /* User defined attribute */
 attribute("MY UDA", "My UDA", string,"%s", no, none, "0,0", "0,0")
 {
 value("", 0)
 }
 }
 tab_page("My UDA tab", "My UDA tab", 19)
 modify (1)
 }
 /***************************************************************************/
 /* Column attributes */
 /***************************************************************************/
 column(0,"j_column")
 {
 /* Reference to the user defined tab page that is defined above in */
 /* the part() section: */
 tab_page("My UDA tab", "My UDA tab", 19)
 modify (1)}

Der Registerkartennamen darf höchstens 39 Zeichen lang sein.