ITfContextOwnerCompositionSink::OnUpdateComposition method (msctf.h)

Called when an existing composition is changed.

Syntax

HRESULT OnUpdateComposition(
  [in] ITfCompositionView *pComposition,
  [in] ITfRange           *pRangeNew
);

Parameters

[in] pComposition

Pointer to an ITfCompositionView object that represents the composition updated.

[in] pRangeNew

Pointer to an ITfRange object that contains the range of text the composition will cover after the composition is updated.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

To determine what has changed within the composition, compare pRangeNew with the range returned from ITfCompositionView::GetRange. The range returned by ITfCompositionView::GetRange is not updated until after ITfContextOwnerCompositionSink::OnUpdateComposition returns.

Requirements

See also

ITfCompositionView interface, ITfContextOwnerCompositionSink interface, ITfCompositionView::GetRange, ITfRange interface