IOleInPlaceComponent.OnWindowActivate(UInt32, Int32) Method

Reference

Definition

Namespace:: Microsoft.VisualStudio.Shell.Interop

Assembly:: Microsoft.VisualStudio.Shell.Interop.dll

Assembly:: Microsoft.VisualStudio.Interop.dll

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Informs an in-place VSPackage object of important window activation events.

public:
 int OnWindowActivate(System::UInt32 dwWindowType, int fActivate);

public:
 int OnWindowActivate(unsigned int dwWindowType, int fActivate);

int OnWindowActivate(unsigned int dwWindowType, int fActivate);

public int OnWindowActivate (uint dwWindowType, int fActivate);

abstract member OnWindowActivate : uint32 * int -> int

Public Function OnWindowActivate (dwWindowType As UInteger, fActivate As Integer) As Integer

Parameters

dwWindowType: UInt32

[in] Specifies the type of window that is being activated. For a list of valid dwWindowType values, see OLEACTIVATE.

fActivate: Int32

[in] Flag that is set to true if the window is activating and false if it is deactivating.

Returns

Int32

If the method succeeds, it returns S_OK. If it fails, it returns an error code.

Remarks

COM Signature

From oleipc.idl:

HRESULT IOleInPlaceComponent::OnWindowActivate(  
   [in] DWORD dwWindowType,  
   [in] BOOL fActivate  
);

The OnWindowActivate method communicates the same information to an in-place VSPackage object that the innermost active object gets through OnFrameWindowActivate and OnDocWindowActivate. If an in-place object assuming the role of main component or subcomponent is the UI active object, only OnWindowActivate will be called. If the UI active object is assuming the role of a component control, only OnDocWindowActivate will be called.

Applies to