You’re reading the English version of this content since no translation exists yet for this locale. Help us translate this article!

This feature is non-standard and is not on a standards track. Do not use it on production sites facing the Web: it will not work for every user. There may also be large incompatibilities between implementations and the behavior may change in the future.

MSCandidateWindowUpdate fires after the Input Method Editor (IME) candidate window has been identified as needing to change size, but before any visual updates have rendered.

This proprietary method is specific to Internet Explorer.

General info



Windows 8.1 and Windows 7 IMEs for certain languages on Internet Explorer for the desktop might not support this event. On Internet Explorer in the new Windows UI, this event is supported in Windows 8.1 IMEs of all languages.


Event Property object.oncandidatewindowupdate = handler;
addEventListener Method object.addEventListener("MSCandidateWindowUpdate", handler, useCapture)



pEvtObj [in]

Type: IHTMLEventObj

Pointer to an IHTMLEventObj interface for the current event.

TAn IME candidate window may be identified as needing to change size for any of the following reasons:

  • As a result of displaying new / changed alternatives or predictions

Web applications need only register for this event once per element (the handler will remain valid for the lifetime of the element).

See also