miniGUI的消息转换函数TranslateMessage

TranslateMessage将keyup、keydown等消息转换为char类型的消息

/**
 * /fn BOOL TranslateMessage (PMSG pMsg)
 * /brief Translates key down and key up messages to MSG_CHAR
 *        message and post it into the message queue.
 *
 * This function translates key down and key up message to an MSG_CHAR
 * message or some MSG_KEYSYM messages, and send the message(s) to
 * the window procedure as a notification message. If the message is
 * not a key message, this function does nothing.
 *
 * The behavior of this function is inflected by the current
 * keyboard layout. The default keyboard layout is US PC keyboard, but
 * you can call /a SetKeyboardLayout function to set a different keyboard
 * layout.
 *
 * /param pMsg The pointer of message.
 * /return A boolean indicates whether the message is a key message.
 *
 * /sa SetKeyboardLayout, MSG_CHAR, MSG_KEYSYM
 */
MG_EXPORT BOOL GUIAPI TranslateMessage (PMSG pMsg);

/**
 * /fn BOOL GUIAPI TranslateKeyMsgToChar (int message, /
                WPARAM wParam, LPARAM lParam, WORD *ch)
 * /brief Translates a key down and key up message to a corresponding character.
 *
 * This function translates a key down and key up message to a character.
 * If the message is not a key message, this function does nothing.
 *
 * The behavior of this function is inflected by the current
 * keyboard layout. The default keyboard layout is US PC keyboard, but
 * you can call /a SetKeyboardLayout function to set a different keyboard
 * layout.
 *
 * /param message The type of message.
 * /param wParam Message parameter.
 * /param lParam Message parameter.
 * /param ch A string buffer for storing translated characters.
 *
 * /return A boolean indicates whether the message is a key message.
 *
 * /sa TranslateMessage
 */
MG_EXPORT BOOL GUIAPI TranslateKeyMsgToChar (int message,
                WPARAM wParam, LPARAM lParam, WORD *ch);