| Bitte wähle einen REQUEST-Befehl aus. |
Syntax
REQUEST ("ASSOCEL_PROPERTIES ", abfragetext, anzahl, variable)
Wertebereicheabfragetext, Typ Text [*]
anzahl, Typ integer
variable, Typ abhängig von abfragetext
[*] zulässige Schlüsselwörter:
ISCOMP = Ist Bestandteil (?)
DBSETNAME = Datenbasisname
KEYCODE = Schlüsselnummer (KEY)
KEYNAME = Schlüsselname (KEY)
CODE = Nummer Bestandteil (CODE COMPONENT)
NAME = Name Bestandteil (COMPONENT)
FULLNAME = vollständiger Name
QUANTITY = Menge
TOTQUANTITY = Gesamtmenge
UNITCODE = Einheit Index
UNITNAME = Einheit Name
UNITFORMATSTR = Einheit Formatierungstext
PROPOBJNAME = Name des Eigenschaftsobjekts
anzahl, Typ integer
variable, Typ abhängig von abfragetext
[*] zulässige Schlüsselwörter:
ISCOMP = Ist Bestandteil (?)
DBSETNAME = Datenbasisname
KEYCODE = Schlüsselnummer (KEY)
KEYNAME = Schlüsselname (KEY)
CODE = Nummer Bestandteil (CODE COMPONENT)
NAME = Name Bestandteil (COMPONENT)
FULLNAME = vollständiger Name
QUANTITY = Menge
TOTQUANTITY = Gesamtmenge
UNITCODE = Einheit Index
UNITNAME = Einheit Name
UNITFORMATSTR = Einheit Formatierungstext
PROPOBJNAME = Name des Eigenschaftsobjekts
ErläuterungDieser REQUEST liefert die Einstellungen der zugewiesenen Eigenschaften zurück. Bei Etiketten und Markern sind dies die Eigenschaften des verknüpften Elementes, bei Objekten die dem Objekt direkt zugewiesenen.
Welche Eigenschaftsbestandteile zurückgegeben werden richtet sich nach der Zusammenstellung von abfragetext. Alle benötigten Schlüsselwörter werden als Text, getrennt durch Kommata, aneinandergereiht. Die Reihenfolge bestimmt auch die Reihenfolge der Rückgabe. Achtung: Der Abfragetext muss eine Textangabe sein. Er darf nicht durch einen Platzhalter/Variable vorgegeben werden.
In anzahl wird die Gesamtanzahl der zurückgegebenen Werte übergeben. Die Anzahl der verknüpften Eigenschaften berechnet sich dann aus n = anzahl/Anzahl_Schlüsselwörter . Sind keine Eigenschaften vorhanden oder ist ein Fehler aufgetreten wird 0 übergeben.
In variable werden die angeforderten Werte abgelegt. Ist variable nicht als dynamisches Array (siehe DIM-Befehl) angelegt, werden nur so viele Werte übergeben, wie variable aufnehmen kann. Ist variable kein Array sondern eine einfache Variable natürlich nur 1 Wert, ist variable ein zweidimensionales Array, werden alle Werte in der ersten Zeile abgelegt.
Die Übergabe der Werte erfolgt nacheinander. Zunächst werden also von der ersten Eigenschaft alle den Schlüsselwörtern entsprechenden Ergebnisse übertragen, dann die der zweiten usw.
Welche Eigenschaftsbestandteile zurückgegeben werden richtet sich nach der Zusammenstellung von abfragetext. Alle benötigten Schlüsselwörter werden als Text, getrennt durch Kommata, aneinandergereiht. Die Reihenfolge bestimmt auch die Reihenfolge der Rückgabe. Achtung: Der Abfragetext muss eine Textangabe sein. Er darf nicht durch einen Platzhalter/Variable vorgegeben werden.
In anzahl wird die Gesamtanzahl der zurückgegebenen Werte übergeben. Die Anzahl der verknüpften Eigenschaften berechnet sich dann aus n = anzahl/Anzahl_Schlüsselwörter . Sind keine Eigenschaften vorhanden oder ist ein Fehler aufgetreten wird 0 übergeben.
In variable werden die angeforderten Werte abgelegt. Ist variable nicht als dynamisches Array (siehe DIM-Befehl) angelegt, werden nur so viele Werte übergeben, wie variable aufnehmen kann. Ist variable kein Array sondern eine einfache Variable natürlich nur 1 Wert, ist variable ein zweidimensionales Array, werden alle Werte in der ersten Zeile abgelegt.
Die Übergabe der Werte erfolgt nacheinander. Zunächst werden also von der ersten Eigenschaft alle den Schlüsselwörtern entsprechenden Ergebnisse übertragen, dann die der zweiten usw.
Beispiel ErläuterungDIM wert[]
s=0.5
sts = REQUEST ("ASSOCEL_PROPERTIES", "iscomp, code, name", anzahl, wert)
IF anzahl THEN
FOR i = 3 TO anzahl STEP 3
TEXT2 0,0, wert[i] ! name
ADD2 0,-s
NEXT i
ELSE
TEXT2 0,0, "Keine Eigenschaften verfügbar."
ENDIF
s=0.5
sts = REQUEST ("ASSOCEL_PROPERTIES", "iscomp, code, name", anzahl, wert)
IF anzahl THEN
FOR i = 3 TO anzahl STEP 3
TEXT2 0,0, wert[i] ! name
ADD2 0,-s
NEXT i
ELSE
TEXT2 0,0, "Keine Eigenschaften verfügbar."
ENDIF
BesonderheitenBis ArchiCAD 9 korrelieren auf Grund eines Fehlers die Abfrageergebnisse zum Teil nicht mit den Abfragetexten. Die falsche Zuordnung betrifft folgende Schlüsselwörter:
UNITCODE ist nicht verfügbar
UNITCODE ergibt UNITNAME
UNITNAME ergibt UNITFORMATSTR
UNITFORMATSTR ergibt PROPOBJNAME
PROPOBJNAME ergibt leeren Text
UNITCODE ist nicht verfügbar
UNITCODE ergibt UNITNAME
UNITNAME ergibt UNITFORMATSTR
UNITFORMATSTR ergibt PROPOBJNAME
PROPOBJNAME ergibt leeren Text
KontextFunktioniert nicht im Kontext der Auflistung (Berechnung).
ArchiCADab 8.0