This function is used to enable the use of virtual input on widgets. Using this function on the RootContainer will turn on virtual input on all current and future widgets in the tree. It is also possible to send an enable/disable virtual input call to a single widgets besides the root container in order to limit virtual input usage.
- pif:[in] Pointer to the IWidget interface object.
int IWidget_EnableVirtualInput(IWidget *pif)
AEE_SUCCESS - The function was able to successfully enable virtual input on the provided widget and any of its children that supports touch. AEE_EFAILED - The passed in widget does not support virtual input.
The root container will first attempt to instantiate the AEECLSID_OEMVirtualInputMgr class will be checked first followed by the AEECLSID_VirtualInputMgr class. The targetted widget and all of it's children will now attempt to display the virtual keypad of their choice upon user click events.