IVsTextMarkerGlyphDropHandler.DrawCandidateOutlineGlyph Method

Article
05/06/2010

Draws a shadow of the glyph in the widget margin at a potential destination line.

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

Syntax

'Déclaration
Function DrawCandidateOutlineGlyph ( _
    dwReserved As UInteger, _
    hdc As IntPtr, _
    pRect As RECT(), _
    clrref As UInteger _
) As Integer
'Utilisation
Dim instance As IVsTextMarkerGlyphDropHandler
Dim dwReserved As UInteger
Dim hdc As IntPtr
Dim pRect As RECT()
Dim clrref As UInteger
Dim returnValue As Integer

returnValue = instance.DrawCandidateOutlineGlyph(dwReserved, _
    hdc, pRect, clrref)

int DrawCandidateOutlineGlyph(
    uint dwReserved,
    IntPtr hdc,
    RECT[] pRect,
    uint clrref
)

int DrawCandidateOutlineGlyph(
    [InAttribute] unsigned int dwReserved, 
    [InAttribute] IntPtr hdc, 
    [InAttribute] array<RECT>^ pRect, 
    [InAttribute] unsigned int clrref
)

abstract DrawCandidateOutlineGlyph : 
        dwReserved:uint32 * 
        hdc:IntPtr * 
        pRect:RECT[] * 
        clrref:uint32 -> int

function DrawCandidateOutlineGlyph(
    dwReserved : uint, 
    hdc : IntPtr, 
    pRect : RECT[], 
    clrref : uint
) : int

Parameters

dwReserved
Type: System.UInt32
[in] Do not use.

hdc
Type: System.IntPtr
[in] Handle to the display context in which to draw the glyph.

pRect
Type: array<Microsoft.VisualStudio.OLE.Interop.RECT[]
[in] Pointer to a RECT structure that defines the bounding rectangle for the glyph.

clrref
Type: System.UInt32
[in] RGB color value for the glyph.

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 textmgr.idl:

HRESULT IVsTextMarkerGlyphDropHandler::DrawCandidateOutlineGlyph(
   [in] DWORD dwReserved,
   [in] HDC hdc,
   [in] RECT *pRect,
   [in] COLORREF clrref
);

Draw the same glyph without regard for whether the destination is valid or not. Feedback as to whether the destination is valid will be given by the mouse cursor.

.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.