IOleInPlaceComponentUIManager.UIActivateForMe Method

Article
04/29/2015

Requests that the SOleComponentUIManager service participate in the activation or deactivation of an in-place VSPackage object.

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

Syntax

'Declaration
Function UIActivateForMe ( _
    dwCompRole As UInteger, _
    ByRef rclsidActive As Guid, _
    pIPActObj As IOleInPlaceActiveObject, _
    pCmdTrgtActive As IOleCommandTarget, _
    cCmdGrpId As UInteger, _
    rgnCmdGrpId As Integer() _
) As Integer

int UIActivateForMe(
    uint dwCompRole,
    ref Guid rclsidActive,
    IOleInPlaceActiveObject pIPActObj,
    IOleCommandTarget pCmdTrgtActive,
    uint cCmdGrpId,
    int[] rgnCmdGrpId
)

int UIActivateForMe(
    [InAttribute] unsigned int dwCompRole, 
    [InAttribute] Guid% rclsidActive, 
    [InAttribute] IOleInPlaceActiveObject^ pIPActObj, 
    [InAttribute] IOleCommandTarget^ pCmdTrgtActive, 
    [InAttribute] unsigned int cCmdGrpId, 
    [InAttribute] array<int>^ rgnCmdGrpId
)

abstract UIActivateForMe : 
        dwCompRole:uint32 * 
        rclsidActive:Guid byref * 
        pIPActObj:IOleInPlaceActiveObject * 
        pCmdTrgtActive:IOleCommandTarget * 
        cCmdGrpId:uint32 * 
        rgnCmdGrpId:int[] -> int

function UIActivateForMe(
    dwCompRole : uint, 
    rclsidActive : Guid, 
    pIPActObj : IOleInPlaceActiveObject, 
    pCmdTrgtActive : IOleCommandTarget, 
    cCmdGrpId : uint, 
    rgnCmdGrpId : int[]
) : int

Parameters

dwCompRole
Type: UInt32

[in] Role of the in-place VSPackage object that is either activating or deactivating. For valid dwCompRole values, see OLEROLE.

rclsidActive
Type: Guid%

[in] Class identifier (CLSID) of the in-place VSPackage object that is either activating or deactivating.

pIPActObj
Type: Microsoft.VisualStudio.OLE.Interop.IOleInPlaceActiveObject

[in] Pointer to the IOleInPlaceActiveObject interface of the innermost active object. The pIPActObj parameter must be nulla null reference (Nothing in Visual Basic) when the in-place object is deactivating and a valid interface pointer when it is activating.

pCmdTrgtActive
Type: Microsoft.VisualStudio.OLE.Interop.IOleCommandTarget

[in] Pointer to the IOleCommandTarget interface to handle the dispatching of active in-place object commands. The pCmdTrgtActive parameter must be null when the in-place object is deactivating and a valid interface pointer when it is activating.

cCmdGrpId
Type: UInt32

[in] Count of custom toolbar identifiers in the rgnCmdGrpId parameter.

rgnCmdGrpId
Type: array<Int32[]

[in] Array of identifiers for the custom toolbar to be displayed by the SOleComponentUIManager service.

Return Value

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

Remarks

COM Signature

From oleipc.idl:

HRESULT IOleInPlaceComponentUIManager::UIActivateForMe(
   [in] DWORD dwCompRole,
   [in] REFCLSID rclsidActive,
   [in] IOleInPlaceActiveObject *pIPActObj,
   [in] IOleCommandTarget *pCmdTrgtActive,
   [in] ULONG cCmdGrpId,
   [in] LONG *rgnCmdGrpId
);

UIActivateForMe is the primary method that differentiates the use of the SOleComponentUIManager service with traditional OLE in-place activation. When an in-place VSPackage object calls UIActivateForMe, the SOleComponentUIManager service takes all the necessary steps to integrate the object's menus, toolbars, and commands into the environment. The object does not need to participate in negotiation for border space to enable menu merging as is necessary in OLE in-place activation.

UIActivateForMe is a logical replacement for the SetActiveObject method in the IOleInPlaceFrame interface. The in-place VSPackage object passes its pIPActObj pointer to the environment in this method instead of through the container's UIActivateForMe method as is done in standard OLE in-place activation.

To implement UIActivateForMe, coordinate this method with the implementation of UIActivateForMe method in the IOleInPlaceFrame interface. The effect of this call is similar to an OLE object calling:

IOleInPlaceUIWindow::SetActiveObject(pActiveObj);

IOleInPlaceFrame::SetMenu(null);

IOleInPlaceUIWindow::SetBorderSpace(null);

When an in-place VSPackage object takes focus by calling UIActivateForMe, the SOleComponentUIManager service replaces any custom menus and toolbars displayed on behalf of the previous active object with those of the new active object. If the new object loses focus or a nested object takes focus, these menus and toolbars are removed.

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Partager via