Koord-Transf.2D Elemente3D ElementeNon Geo-ScripteFunktionenSteuerbefehleAttributeDiverseAddOns
ProgrammablaufSchleifenExt. VerbindungUmgebung
FILE_DEPEND. APPL._QUERY
Name
APPLICATION_QUERY
Syntax
APPLICATION_QUERY(erweiterung, parameter, variable1, variable2, ...)
Aufklappen Wertebereiche
erweiterung, Typ string; Mit folgenden Werten:
   "DOCUMENT_FEATURE" (1.)
   "PARAMETER_SCRIPT" (7.)
   (2.-6. betrifft MEP - in Arbeit)

parameter, Typ string
Aufklappen Erläuterung
APPLICATION_QUERY bietet diverse Abfragemöglichkeiten um in ArchiCAD bestimmte Umgebungswerte an ein GDL-Objekt zu übergeben:

Über den Wert von erweiterung wird der abzufragende Kontext bestimmt:

"DOCUMENT_FEATURE"

Dieser Befehl ist in der Lage, diverse Eigenschaften des aktiven Dokumentenfensters abzufragen. Derzeit gibt es nur eine Eigenschaft, die zurückgegeben werden kann - die Blickrichtung in Bezug auf das Dokument. Hat parameter den Wert "view_direction" wird also die Blickrichtung des aktuellen Dokumenttyps zurückgegeben, in welchem das Objekt visualisiert wird. Es gibt keine zusätzlichen Parameter.

Verwendung:
n = APPLICATION_QUERY ("document_feature", "view_direction", orientierung)

Mögliche Rückgabewerte in orientierung:
"vertical_only": Grundriss
"horizontal_only": für Schnitte und Ansichten, welche aus 3D erzeugt werden (nicht wenn das Objekt in Schnitt/Ansicht plaziert wird)
"free": für 3D und 3D-Dokument
"none":
"unset":

"PARAMETER_SCRIPT"

Dieser Befehl ist in der Lage, verschiedene Bedingungen des Parameter-Scriptes zu übergeben. Momentan gibt es nur eine Eigenschaft, welche zurückgegeben werden kann - die Unterscheidung des ersten Durchlaufes. Hat parameter den Wert "firstoccasion_in_progress", wird also angezeigt, ob der erste Durchlauf des Parameterscrptes erfolgt.

Verwendung:
n = APPLICATION_QUERY ("parameter_script", "firstoccasion_in_progress", ersterDurchlauf)

Der Rückgabewert in ersterDurchlauf zeigt an, ob der gegenwärtige Scriptdurchlauf der erste ist oder die Folge einer vorhergehenden Ausführung des Parameter-Scriptes, welcher einige Parameter verändert hat.

Diese Unterscheidung kann wichtig sein, wenn ein Teil des Parameter-Scriptes ein bestimmtes Ereignis anstösst - z.B. steuert es das Drücken eines UI_FUNCTION-Schalters.
Aufklappen ArchiCAD®
ab 12.0
Aufklappen Referenzen