SetKeyEvent

CForm member function to set an event to alter received keypresses before processing by the form.

void CForm::SetKeyEvent(int (*pEventKey)(CForm* pForm, CFormItem *pItem, int nData))

Parameters

pEventKey = Event to handle keypresses

Return Value

This function may return 0 to disregard the keypress or the ASCII value to be processed as the key.

Remarks

Examples

int DontAllowZKey(CForm* pForm CFormItem* pItem, int nData) {

if(nData == 'Z')

return 0;

else

return nData;

}

void CreateNoZForm(void) {

FORM_INIT(NoZ, EventNoZShow, NULL, NULL, NULL, nFormFlgNone);

FORM_ADD_INPUT(NoZ, ID, FONT_WIDTH * 2, FONT_HEIGHT * 3, "Input: ", 10, 0, 0, NULL, g_strID, NULL, "Enter ID, 'Z' not allowed");

formNoZ.SetKeyEvent(DontAllowZKey);

FORM_SHOW(NoZ); FORM_RUN(NoZ); FORM_HID(NoZ);

}

See Also