IShellView::UIActivate

Other versions of this page are also available for the following:

• Windows Embedded CE 6.0 R3

8/28/2008

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

See Also

Reference

IShellView
Standard Shell Interfaces