GetObject: Unterschied zwischen den Versionen
Aus Wikimatic
Uhula (Diskussion | Beiträge) |
|||
| (Eine dazwischenliegende Version von einem anderen Benutzer werden nicht angezeigt) | |||
| Zeile 2: | Zeile 2: | ||
|objects=[[category:OT_ALL]]OT_ALL (üblich: Verwendung mit dem [[Objekte#dom|dom-Objekt]]) | |objects=[[category:OT_ALL]]OT_ALL (üblich: Verwendung mit dem [[Objekte#dom|dom-Objekt]]) | ||
|official=Ja | |official=Ja | ||
| − | |description=Liefert das erste gefundene Objekt zurück | + | |description=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. |
|params=* integer (Object-ID) oder string (Name des Objekts) | |params=* integer (Object-ID) oder string (Name des Objekts) | ||
|return=Referenz auf das Objekt oder "null" falls kein Objekt gefunden wurde | |return=Referenz auf das Objekt oder "null" falls kein Objekt gefunden wurde | ||
| Zeile 10: | Zeile 10: | ||
Write("Objekt gefunden!"); | 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 | ||
| + | |||
| + | |||
|see=[[CreateObject]], [[DeleteObject]] | |see=[[CreateObject]], [[DeleteObject]] | ||
}} | }} | ||
[[Category:Methoden]] | [[Category:Methoden]] | ||
Aktuelle Version vom 10. September 2014, 14:34 Uhr
Inhaltsverzeichnis
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
