TranslateDispatch callback function

[TranslateDispatch is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Used by the client of the DoReaderMode function to intercept and explicitly handle any windows messages targeted for the scrolling area of the reader mode window. This is an application-defined callback function.


BOOL CALLBACK TranslateDispatch(
  _In_ const MSG *lpmsg


lpmsg [in]

Type: const MSG*

A pointer to an MSG structure that contains the intercepted message.

Return value

Type: BOOL

TRUE if the message was handled by this function; otherwise, FALSE. If FALSE, the message is handled by the default reader mode implementation. That implementation handles mouse movement and buttons as well as key presses.


The following example outlines an implementation of this function.

TranslateDispatchCallback(LPMSG lpmsg)
    BOOL fResult = FALSE;

    if (lpmsg->message == WM_KEYDOWN)
        // Perform custom keyboard actions here.
        fResult = TRUE;

    return fResult;


Minimum supported client

Windows Vista, Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]