Partager via

IOleComponentUIManager.OnUIEvent Method

  • Article

Informs the SOleComponentUIManager service of a UI event.

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

Syntax

'Déclaration
Sub OnUIEvent ( _
    dwCompRole As UInteger, _
    ByRef rclsidComp As Guid, _
    ByRef pguidUIEventGroup As Guid, _
    nUIEventId As UInteger, _
    dwUIEventStatus As UInteger, _
    dwEventFreq As UInteger, _
    prcEventRegion As RECT(), _
    ByRef pvarEventArg As Object _
)
'Utilisation
Dim instance As IOleComponentUIManager
Dim dwCompRole As UInteger
Dim rclsidComp As Guid
Dim pguidUIEventGroup As Guid
Dim nUIEventId As UInteger
Dim dwUIEventStatus As UInteger
Dim dwEventFreq As UInteger
Dim prcEventRegion As RECT()
Dim pvarEventArg As Object

instance.OnUIEvent(dwCompRole, rclsidComp, _
    pguidUIEventGroup, nUIEventId, dwUIEventStatus, _
    dwEventFreq, prcEventRegion, pvarEventArg)

void OnUIEvent(
    uint dwCompRole,
    ref Guid rclsidComp,
    ref Guid pguidUIEventGroup,
    uint nUIEventId,
    uint dwUIEventStatus,
    uint dwEventFreq,
    RECT[] prcEventRegion,
    ref Object pvarEventArg
)

void OnUIEvent(
    [InAttribute] unsigned int dwCompRole, 
    [InAttribute] Guid% rclsidComp, 
    [InAttribute] Guid% pguidUIEventGroup, 
    [InAttribute] unsigned int nUIEventId, 
    [InAttribute] unsigned int dwUIEventStatus, 
    [InAttribute] unsigned int dwEventFreq, 
    [InAttribute] array<RECT>^ prcEventRegion, 
    [InAttribute] Object^% pvarEventArg
)

function OnUIEvent(
    dwCompRole : uint, 
    rclsidComp : Guid, 
    pguidUIEventGroup : Guid, 
    nUIEventId : uint, 
    dwUIEventStatus : uint, 
    dwEventFreq : uint, 
    prcEventRegion : RECT[], 
    pvarEventArg : Object
)

Parameters

  • dwCompRole
    Type: System.UInt32

    [in] Role of the affected in-place VSPackage object. For valid dwCompRole values, see OLEROLE.

  • rclsidComp
    Type: System.Guid%

    [in] Class identifier (CLSID) of the in-place VSPackage object.

  • pguidUIEventGroup
    Type: System.Guid%

    [in] Uniquely identifies the UI events group of the in-place VSPackage object.

  • nUIEventId
    Type: System.UInt32

    [in] Identifies the event using a combination of the events group and event ID.

  • prcEventRegion
    Type: array<Microsoft.VisualStudio.OLE.Interop.RECT[]

    [in] Screen coordinates of the region that might be affected by the event. The environment uses this information to avoid the region.

  • pvarEventArg
    Type: System.Object%

    [in] Contains event-specific information if applicable. Typically, pvarEventArg will be nulla null reference (Nothing in Visual Basic).

Remarks

COM Signature

From oleipc.idl:

void IOleComponentUIManager::OnUIEvent(
   [in] DWORD dwCompRole,
   [in] REFCLSID rclsidComp,
   [in] const GUID *pguidUIEventGroup,
   [in] DWORD nUIEventId,
   [in] DWORD dwUIEventStatus,
   [in] DWORD dwEventFreq,
   [in] RECT *prcEventRegion,
   [in] VARIANT *pvarEventArg
);

The functionality provided by OnUIEvent is also available with the SVsStatusbar service. OnUIEvent can be used to control various fields in the environment's status bar. It is intended to insulate an in-place VSPackage object from interacting directly with any environment-specific UI peculiarities.

A call to OnUIEvent communicates an event's identifier, its status, its frequency, and the region affected. The following events are currently supported by OnUIEvent.

Events

 

uieventidSetTextLinePos

uieventidSetGraphicYPos

uieventidSetTextColPos

uieventidSetGraphicXSize

uieventidSetTextSelMode

uieventidSetGraphicYSize

uieventidSetTextCharPos

uieventidSetGraphicXPos

uieventidSetTextInsMode

uieventidAnimateIcon

Permissions

See Also

Reference

IOleComponentUIManager Interface

IOleComponentUIManager Members

Microsoft.VisualStudio.Shell.Interop Namespace