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