Microsoft Windows CE 3.0  

TouchCalibrateUI_WaitForConfirmation

Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.

This function is called to wait for the user to accept or reject the calibration.

void TouchCalibrateUI_WaitForConfirmation(
HANDLE
hevt
,
HDC
hdc
);

Parameters

hevt
Event handle to wait on.
hdc
Handle to the device context of the confirmation screen.

Return Values

None.

Remarks

This function can update the confirmation screen by drawing on the given hdc.

The function does not have to wait forever for the calibration to be performed. If the function returns before the TouchCalibrateUI_Done function is called (by the TouchCalibrateUI_HandleUserInputMessage function), the calibration is rejected.

The sample code tests for a keyboard. If the keyboard is present and enabled, the function waits forever for the event to be signaled. If the keyboard is not present or enabled, the function waits until a tap is detected or until 30 seconds have elapsed, whichever occurs first. If there is a tap, the calibration is accepted. If the function times out, the function returns and the calibration is rejected.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.10 and later Calibrui.h    

See Also

TouchCalibrateUI_Done, TouchCalibrateUI_DrawConfirmationScreen, TouchCalibrateUI_DrawMainScreen, TouchCalibrateUI_HandleUserInputMessage, TouchCalibrateUI_Initialize