« Zurück zu Produkt

Dokumentation

IPS_GetObject

 array IPS_GetObject (int $ObjektID) 

Parameterliste

ObjektID

Die zu zeigende ObjektID

Rückgabewert

Folgende Informationen stehen als key => value Paare zur Verfügung:

Index Typ Beschreibung
ChildrenIDs array Untergeordnete ObjektIDs. Siehe: IPS_GetChildrenIDs
HasChildren boolean TRUE, wenn das Objekt Unterobjekte hat. Siehe: IPS_HasChildren
ObjectID integer ObjektID
ObjectIcon string Dateiname ohne Erweiterung des Icons. Siehe: IPS_SetIcon
ObjectIdent string Identifikator des Objekts. Siehe IPS_SetIdent
ObjectInfo string Beschreibung, die der Benutzer angeben kann. Siehe: IPS_SetInfo
ObjectIsDisabled (ab 4.0) boolean TRUE, wenn das Objekt inaktiv gesetzt ist. Siehe IPS_SetDisabled
ObjectIsHidden boolean TRUE, wenn das Objekt in der Visualisierung versteckt sein soll. Siehe IPS_SetHidden
ObjectIsReadOnly boolean TRUE, wenn das Objekt schreibgeschützt ist. (Wird zur Zeit nur für Status Variablen benutzt)
ObjectName string Name des Objekts. Siehe: IPS_SetName
ObjectPosition integer Position, die das Objekt in der Visualisierung haben soll. Dieser Wert muss nicht unbedingt eindeutig sein. Siehe: IPS_SetPosition
ObjectType integer Objekt-Typ (0: Kategorie, 1: Instanz, 2: Variable, 3: Skript, 4: Ereignis, 5: Media, 6: Link)
ObjectSummary string   Kurzbeschreibung eines Objektes, welches vom Modul zur Laufzeit bei Bedarf generiert wird.
ParentID integer Übergeordnetes Objekt. 0 = Kein übergeordnetes Objekt. Siehe: IPS_SetParent

Beschreibung

Die Funktion liefert ein Array mit Informationen über das Objekt mit der ID ObjektID. Sollte das Objekt nicht vorhanden sein, wird eine Warnung generiert.

Beispiel

print_r(IPS_GetObject(19668));  
/* liefert z.B.:
Array
(
    [ParentID] => 26691
    [ObjectID] => 43502
    [ObjectType] => 1
    [ObjectIdent] =>
    [ObjectName] => MX Gerät (ID: 1)
    [ObjectInfo] => Dies ist eine Instanz von einem Gerät
    [ObjectIcon] => IPS
    [ObjectSummary] =>
    [ObjectPosition] => 1
    [ObjectIsReadOnly] =>
    [ObjectIsHidden] =>
    [ObjectIsDisabled] =>
    [ObjectIsLocked] =>
    [HasChildren] => 1
    [ChildrenIDs] => Array
    (
        [0] => 43430
        [1] => 55892
        [2] => 36597
        [3] => 18993
        [4] => 34524
        [5] => 12269
        [6] => 44450
        [7] => 23394
        [8] => 11693
        [9] => 13654
    )
)
*/
Haben Sie noch Fragen?