Migration - Smarthome-Components

IPS_SetMediaFile
boolean IPS_SetMediaFile ( integer $MedienID , string $DateiName , boolean $DateiMussExistieren )
Parameterliste
MedienID ID des zu verändernden Medienobjekts
DateiName Dateiname der Mediendatei. Folgende Erweiterungen sind erlaubt:
Typ des Medienobjekts passende Mediendateien
0 (Designer Form) bin
1 (Image Objekt) bmp, jpg, jpeg, gif, png, ico
2 (Sound Objekt) wav, mp3
DateiMussExistieren TRUE, wenn Existenz geprüft werden soll, sonst FALSE
Rückgabewerte
Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Der Befehl bindet den Dateinamen DateiName an das Medienobjekt mit der ID MedienID. Der Parameter
DateiMussExistieren gibt an, ob intern geprüft werden soll, ob die Datei vorhanden ist. Die zuzuordnende Mediendatei
muss zum Medientyp des Medienobjekts passen.
Beispiel
$ImageFile = "C:\\Bilder\\Alarmsymbol.png"; // Image-Datei
$MediaID = IPS_CreateMedia(1); // Image im MedienPool anlegen
IPS_SetMediaFile($MediaID, $ImageFile, true); // Image im MedienPool mit Image-Datei verbinden