HTMLElement: mscandidatewindowupdate event

Non-standard: 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.

The mscandidatewindowupdate event is thrown 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.

Note: 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.

An 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).


Use the event name in methods like addEventListener(), or set an event handler property.

addEventListener('mscandidatewindowupdate', event => { })

onmscandidatewindowupdate = event => { }

Event type

A generic Event with no added properties.

See also