GetObject

Aus Wikimatic
Wechseln zu: Navigation, Suche

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)