IOleInPlaceComponent::OnWindowActivate Method (UInt32, Int32)

Visual Studio 2015

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

Namespace: Microsoft.VisualStudio.Shell.Interop
Assembly: Microsoft.VisualStudio.Shell.Interop (in Microsoft.VisualStudio.Shell.Interop.dll)

Syntax

C++

int OnWindowActivate(
	unsigned int dwWindowType,
	int fActivate
)

Parameters

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

fActivate: Type: System::Int32
[in] Flag that is set to true if the window is activating and false if it is deactivating.

Return Value

Type: System::Int32

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

Remarks

COM Signature

From oleipc.idl:

C++

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.