Dokumentation
RequireParent
Benötigt: IP-Symcon >= 4.0
boolean RequireParent (string $ÜbergordneteGUID)
Parameterliste
ÜbergordneteGUID |
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.
Sofern keine Verbindung existiert, wird eine übergeordnete Instanz mit der GUID ÜbergordneteGUID erstellt. Selbst dann, wenn eine kompatible übergeordneten Instanz vorhanden wäre.
Der Normalfall für die Funktion ist ein Splitter-Modul, welches beim Erstellen eine eigene I/O Instanz benötigt. Alternativ ist eventuell auch ForceParent passend.
Diese Funktion wird normalerweise nur in der Create() oder ApplyChanges() Methode aufgerufen.
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 neu erstellten Splitter, falls noch keine Verbindung besteht
$this->RequireParent("{46C969BF-3465-4E3E-B2A5-E404FB969735}");
}