IShellView::UIActivate

Quick Info

Windows NT
Yes
Win95
Yes
Win32s
No
Import Library
-
Header File
shlobj.h
Unicode
No
Platform Notes
None

[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.