[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