Dokumentation
ConnectParent
Benötigt: IP-Symcon >= 4.0
boolean ConnectParent (string $ÜbergeordneteGUID)
Parameterliste
ÜbergeordneteGUID |
Rückgabewert
Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
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.
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}");
}