This property has slightly different meaning when used on a widget that makes use of the virtual input, and when used on a virtual input widget. Refer to the table below for sample useage.
For example, a text widget receiving this property would look at bAutoLayout first. If that value it TRUE it will rely on its internal input mode value when setting up the virtual keypad. If the value of bAutoLayout is false, it will use the layout data from the nInputMode parameter instead. Note: this does not affect the widget's internal input mode, it is specifically for setting up the virtual keypad. When the text widget is ready to bring up the virtual keypad, it will call SetVirtualInputMode on the keypad with bAutoLayout set to FALSE and nInput set to the previously determined layout value.
A virtual keypad receing this property would also look at bAutoLayout first. If that value is set to TRUE, it will attempt to query the target widget's input mode via IWidget_GetInputMode(). If bAutoLayout is false, it will rely on the value specified in the nInputMode parameter to determine which layout to use. If the virtual keypad does not recognize the received input mode, it will use it's own default.
See AEECLSID_TextController for possible values of the input modes.
- pif[in]:Pointer to the IWidget interface object.
- bAutoLayout[in]:Disable/Enabled auto determination of needed layout
- nInputMode[in]:Desired input mode (only relevant if bAutoLayout is false)
AEEResult IWidget_SetVirtualInputLayoutMode(IWidget *pif, boolean bAutoLayout, uint32 nInputMode)
AEE_SUCCESS -- The value was set successfully AEE_EFAILED -- The value could not be set.