« Zurück zu Produkt

Dokumentation

ConnectParent

Benötigt: IP-Symcon >= 4.0

 boolean ConnectParent (string $ÜbergeordneteGUID) 

Parameterliste

ÜbergeordneteGUID

GUID

Rückgabewert

Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.

Beschreibung

Warning

Diese Funktion ist nur für IPSModule verfügbar. Die Alternative für IPSModuleStrict ist GetCompatibleParents.

Die Funktion verbindet die Instanz mit einer vorhandenen übergeordneten kompatiblen (Parent) Instanz. Sollte diese nicht vorhanden sein, wird diese erstellt und anschließend verbunden. Eine Liste der verfügbaren ModulIDs (GUID) kann hier entnommen werden.

Warning

Der Normalfall für die Funktion ist ein Device-Modul, welches sich an einen Splitter hängen möchte. Dabei wird nur, sofern kein Splitter vorhanden ist, ein neuer erstellt.

Beispiel

// IPSModuleStrict
ConnectParent/RequireParent/ForceParent ist nicht verfügbar, 
kann aber durch die neue Funktion "GetCompatibleParents()" ersetzt werden.

// IPSModule
public function Create() {

    // Die Zeile niemals entfernen!
    parent::Create();

    // Verbinde mit vorhandenem Splitter oder erstelle gegebenfalls einen neuen
    $this->ConnectParent("{46C969BF-3465-4E3E-B2A5-E404FB969735}");
    
}
Haben Sie noch Fragen?