Syntax APPLICATION_QUERY(erweiterung, parameter, variable1, variable2, ...) |

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. |