IShellView::UIActivate

[Now Supported on Windows NT]

Called by the Explorer whenever the activation state of the view window is changed by a certain event that is not caused by the shell view itself. For example, if the TAB key is pressed when the tree has the focus, the view should be given the focus.

HRESULT UIActivate(

UINT uState // activation state flag
);  

Parameters

uState

Flag specifying the activation state of the window. This parameter can be one of the following values:

Value Meaning
SVUIA_ACTIVATE_FOCUS The Explorer has just created the view window with the input focus. This means the shell view should be able to set menu items appropriate for the focused state.
SVUIA_ACTIVATE_NOFOCUS The shell view is either losing the input focus or it has just been created without the input focus. The shell view should be able to set menu items appropriate for the nonfocused state. This means no selection-specific items should be added.
SVUIA_DEACTIVATE The Explorer is about to destroy the shell view window. The shell view should remove all extended UIs, typically merged menu and modeless popup windows.

Return Values

Returns NOERROR if successful or an OLE-defined error value otherwise.

Remarks

To remerge menu items, the shell view typically hooks the WM_SETFOCUS message and calls IShellBrowser::OnViewWindowActivated before remerging. The shell view should not hook the WM_KILLFOCUS message to remerge menu items.

Notes to Callers

Call this method to inform the view of activation state change.

Notes to Implementors

Use this method to track activation state and change any behavior, as appropriate.

See Also

IShellView