Share via


IShellView::UIActivate (Windows Embedded CE 6.0)

1/6/2010

This method is 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.

Syntax

HRESULT UIActivate(
  UINT uState
);

Parameters

  • uState
    [in] Flag specifying the activation state of the window. This parameter can be one of the following values:

    Flag Description

    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

    The shell view is active without focus.

Return Value

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

Remarks

This method is called to inform the view of an activation state change. It is implemented to track the activation state and change any behavior, as appropriate.

Requirements

Header shobjidl.h, shobjidl.idl
Library Developer Implemented
Windows Embedded CE Windows CE 5.0 and later

See Also

Reference

IShellView
Standard Shell Interfaces