Langner Communications: The Production-to-Business Company
20.11.2008
Lösungen Produkte Schulungen Downloads Langner Presse Kontakt
     Home

 
ACHTUNG Versionsschock!

Die folgenden Änderungen in den LUCA Komponenten sind inkompatibel zu LUCA Versionen älter als 5.2. Sollten Sie ausschließlich mit den LUCA API-Funktionen (Vwrite, Vread usw.) programmieren, ändert sich für Sie nichts. Für alle, die mit den LUCA Komponenten entwickeln, ist es wichtig die folgenden Änderungen zu beachten.

Neue Signaturen für Observer und Ereignisse bei den LUCA-Komponenten

In LUCA werden beim Auslösen von Ereignissen die zugehörigen Daten jetzt immer gleich mitgeliefert.
Beispiel: Fehler beim Dateitransfer
Bisher wurde dann das Ereigniss Vblob::OnTransferFail ausgelöst. Wenn man jedoch wissen wollte welcher Fehler auftrat, musste dies durch den Aufruf von Vbase::GetError und Vbase::GetErrorMessage explizit abgefragt werden. Jetzt liefert Vblob::OnTransferFail diese Daten gleich mit. Alle Ereignisse in den LUCA Basisklassen und in den LUCA Modulklassen, die ausgelöst werden, um neue Daten zu signalisieren, wurden entsprechend angepasst. Diese Änderung betrifft im Wesentlichen die C++ Klassen und die VCL-Komponenten. Bei den ActiveX-Komponenten lieferten die Ereignisbehandlungsroutinen schon immer ihre Daten mit.

Die einzelnen Änderungen können Sie unter folgenden Abschnitten nachlesen:

Änderungen in den C++ Klassen
Änderungen in den VCL-Komponenten
Änderungen in den ActiveX-Komponenten

Im Zuge dieser Umstellung wurden zusätzlich folgende Ereignisse umbenannt (gilt für C++ Klassen, VCL-Komponenten und ActiveX-Komponenten):

In der Basisklasse Vpacket

Das Ereignis OnBlockCanGet heißt jetzt Vpacket::OnDataReceived.
Das Ereignis OnBlockCanPut heißt jetzt Vpacket::OnCanWrite.
Das Ereignis OnQueueEmpty heißt jetzt Vpacket::OnTransmitQueueEmpty.

In der Basisklasse Vbitstream

Das Ereignis OnStreamCanGet heißt jetzt Vbitstream::OnDataReceived.
Das Ereignis OnStreamCanPut heißt jetzt Vbitstream::OnCanWrite.

In der Basisklasse Vbytestream

Das Ereignis OnLine heißt jetzt Vbytestream::OnLineReceived.

Zu diesen Änderungen beachten Sie bitte folgende Hinweise

Wichtige Hinweise für Benutzer der VCL- und ActiveX-Komponenten
Wenn Sie schon Projekte mit einer Vorgänger-Version der LUCA-ActiveX-Komponenten oder den LUCA-VCL-Komponenten erstellt haben, verwenden diese auch weiterhin ihre bisherigen Versionen der LUCA-Komponenten DLL's. Wenn Sie ihre bestehenden Projekte auf die aktuelle LUCA-Version umstellen wollen, müssen Sie dies manuell durchführen. Das bedeutet, dass Sie vor der Installation der neuen LUCA-Version die entsprechenden Projekte noch unter der Vorgängerversion laden und alle LUCA-Komponenten aus ihrem Projekt entfernen müssen. Danach installieren Sie die neue LUCA-Version und fügen die erforderlichen Komponenten wieder in das Projekt ein. Alle Ereignisbehandlungsroutinen, bei welchen sich der Methodenname (s.o.) geändert hat, müssen im Quelltext ausgetauscht werden (dies kann über die IDE geschehen).

Wichtige Hinweise für Benutzer der C++ Klassen
Wenn Sie schon Projekte mit einer Vorgänger-Version der LUCA C++ Klassen erstellt haben, so sind diese auch mit der neuen Lucaclasses.dll lauffähig. Wenn Sie ihre bestehenden Projekte auf die aktuelle LUCA-Version umstellen wollen, müssen Sie diese neu kompilieren. Alle in Ihrem Projekt bestehenden Observer, die in der neuen LUCA-Version geändert wurden, erzeugen einen Kompilerfehler. So können Sie die zu verändernden Observer sehr schnell lokalisieren und durch die neuen Observer ersetzen.

 
Copyright© 2001-2008 Langner Communications AG.
Langner, P2B, FactoryXML, i-Plant und LUCA sind eingetragene Marken der Langner Communications AG.
Alle anderen Namen sind Marken der betreffenden Firmen.