ITfContextOwnerServices::OnLayoutChange method (msctf.h)

The ITfContextOwnerServices::OnLayoutChange method is called by the context owner when the on-screen representation of the text stream is updated during a composition. Text stream updates include when the position of the window that contains the text is changed or if the screen coordinates of the text change.

Syntax

HRESULT OnLayoutChange();

Return value

This method can return one of these values.

Value Description
S_OK
The method was successful.

Remarks

A call to ITfContextOwnerServices::OnLayoutChange could be in response to a text edit, font size change, window movement/resizing, and so on.

If a call to ITfContextView::GetTextExt or ITfContextOwner::GetACPFromPoint fails because the application did not calculate the screen layout (Return Value: TS_E_NOLAYOUT), the application must then call ITfContextOwnerServices::OnLayoutChange when the information is ready.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps | UWP apps]
Minimum supported server Windows 2000 Server [desktop apps | UWP apps]
Target Platform Windows
Header msctf.h
DLL Msctf.dll
Redistributable TSF 1.0 on Windows 2000 Professional

See also

ITfContextOwner::GetACPFromPoint

ITfContextOwnerServices

ITfContextView::GetTextExt