ITextHost::TxViewChange method (textserv.h)

Article
02/22/2024

Indicates to the text host that the update region has changed.

Syntax

void TxViewChange(
  [in] BOOL fUpdate
);

Parameters

[in] fUpdate

Type: BOOL

Update flag. If TRUE, the text host calls UpdateWindow; otherwise it does nothing. See the Remarks section.

Return value

None

Remarks

The text services object must call TxViewChange every time its visual representation has changed, even if the control is inactive. If the control is active, then text services must also make sure the control's window is updated. It can do this in a number of ways:

Call ITextHost::TxGetDC to get a device context for the control's window and then repaint or update the window. Afterward, call ITextHost::TxReleaseDC.
Call ITextHost::TxInvalidateRect to invalidate the control's window.
Call ITextHost::TxScrollWindowEx to scroll the control's window.

After the text services object has updated the active view, it can call TxViewChange and set fUpdate to TRUE along with the call. By passing TRUE, the text host calls UpdateWindow to make sure any unpainted areas of the active control are repainted.

Requirements

Requirement	Value
Minimum supported client	Windows Vista [desktop apps only]
Minimum supported server	Windows Server 2003 [desktop apps only]
Target Platform	Windows
Header	textserv.h
DLL	Msftedit.dll