Windows Dev Center

ITextServices::OnTxInPlaceDeactivate method

Notifies the text services object that this control is no longer in-place active.

Syntax


HRESULT OnTxInPlaceDeactivate();

Parameters

This method has no parameters.

Return value

Type: HRESULT

The return value is always S_OK.

Remarks

In-place activation refers to an embedded object running in-place (for example, for regular controls and embeddings, it would have a window to draw in). In contrast, UI active means that an object currently has the editing focus. Specifically, things like menus and toolbars on the container may also contain elements from the UI-active control/embedding. There can only be one UI-active control at any given time, while many can be in-place active at once.

Note, UI activation is different from getting the focus. To let the text services object know that the control is getting or losing focus, the host will send WM_SETFOCUS and WM_KILLFOCUS messages. Also, note that a windowless host will pass NULL as the wParam (window that lost the focus) for these messages.

When making the transition from the UI-active state to a nonactive state, the host should call ITextServices::OnTxUIDeactivate first and then ITextServices::OnTxInPlaceDeactivate.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Textserv.h

DLL

Msftedit.dll

See also

ITextServices
Reference
OnTxUIDeactivate
Conceptual
Windowless Rich Edit Controls
Other Resources
WM_KILLFOCUS
WM_SETFOCUS

 

 

Community Additions

ADD
Show:
© 2015 Microsoft