Platform Package reference: Function EwGetAutoObject()

Description of the function EwGetAutoObject() available in all Platform Packages for ANSI C compatible target systems. This function is intended to be used when integrating the Embedded Wizard created GUI application with the underlying graphics subsystem, graphics hardware or other external GUI applications coexisting on the same system.


XObject EwGetAutoObject( const XVariant* aAutoObject, XClass aClass )



Pointer to a data structure representing the autoobject to access. This data structure and all associated contents are generated by Embedded Wizard.


Pointer to data structure representing the class of the autoobject to access. The specified class has to match with the class defined originally in the autoobject member.


The function EwGetAutoObject() returns an autoobject identified by aAutoObject. The function verifies whether the required object is already instantiated and if it's true, the existing instance is returned immediately. If no instance of the desired autoobject could be found, EwGetAutoObject() prepares a new object of the class aClass and initializes it properly. For example:

ApplicationDeviceClass device = EwGetAutoObject( &ApplicationDeviceObject,
                                                  ApplicationDeviceClass );

The created object will remain in memory as long as the object is in use. Objects, which are not in use anymore are automatically released during the next EwReclaimMemory() invocation.