Zuletzt geändert am 10. September 2014 um 14:34

GetObject

Version vom 10. September 2014, 14:34 Uhr von Uhula (Diskussion | Beiträge)

(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

GetObject()

Offiziell dokumentiert: Ja

Liefert das erste gefundene Objekt für die "ID" oder den "Namen" zurück. Objekte sind Geräte, Kanäle, Systemvariable und Programme - und sollten deswegen auch alle mit unterschiedlichen Namen versehen werden. Datenpunkte eines Kanals können auch durch die Angabe der Adresse gefunden werden, für Geräte und Kanäle funktioniert das hingegen nicht.

Parameter

  • integer (Object-ID) oder string (Name des Objekts)

Rückgabewert

Referenz auf das Objekt oder "null" falls kein Objekt gefunden wurde

Beispiel

Objektreferenz holen und "Objekt gefunden!" ausgeben falls Objekt gefunden wurde:

 object o = dom.GetObject("Fenster-Wohnzimmer");
 if (o) {
   Write("Objekt gefunden!");
 }

! Gerätereferenz holen

 object dev1 = dom.GetObject("AZ.Thermostat"); ! Geht
 object dev2 = dom.GetObject("BidCos-RF.JEQ0035924"); ! Geht nicht

! Datenpunktreferenz holen, via Adresse bzw. Namen

 object dp1 = dom.GetObject("BidCos-RF.JEQ0035924:1.TEMPERATURE"); ! geht 
 object dp2 = dom.GetObject("AZ.Thermostat.Istwerte.TEMPERATURE"); ! Geht nicht
 object dp3 = dom.GetObject("AZ.Thermostat.Istwerte").DPByHssDP("TEMPERATURE"); ! geht

Siehe auch

CreateObject, DeleteObject

Objekte

OT_ALL (üblich: Verwendung mit dem dom-Objekt)