IShellView::UIActivateIShellView::UIActivate*
*Contents  *Index  *Topic Contents
*Previous Topic: IShellView::TranslateAccelerator
*Next Topic: ITaskbarList

IShellView::UIActivate


HRESULT UIActivate(
    UINT uState
   );

Called when the activation state of the view window is changed by an 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.

uState
Flag specifying the activation state of the window. This parameter can be one of the following values:
SVUIA_ACTIVATE_FOCUS Windows 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 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 Windows Explorer is about to destroy the shell view window. The shell view should remove all extended user interfaces. These are typically merged menus and merged modeless pop-up windows.
SVUIA_INPLACEACTIVATE Not used for this interface.

Before remerging menu items, the shell view typically hooks the WM_SETFOCUS message and calls the IShellView::OnViewWindowActive method. 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 an activation state change.

Notes to Implementers

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

See also IShellView

Up Top of Page
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.