Table of Contents
ITGIS_Shape.DrawLabel_2 method
DK for ActiveX | TatukGIS_XDK11.ITGIS_Shape.DrawLabel_2 | Methods | Properties
Render shape label and return bounding polygon points. Draws label and captures extent for hit testing.
Syntax
// C# public void DrawLabel_2( ref ITGIS_DrawBuf _points );
' VisualBasic Public Sub DrawLabel_2( ByRef _points As ITGIS_DrawBuf )
// Oxygene public procedure DrawLabel_2( var _points : ITGIS_DrawBuf );
Parameters
| Name | Type | Description |
|---|---|---|
| _points | ITGIS_DrawBuf | Output: Bounding polygon points of rendered label. Sequence starting from top-left, returning to start. For multi-part shapes, buffer contains multiple sequences (one per part). |
Remarks
PURPOSE:Render labels with extent tracking. Returns label bounding box for hit testing, label-aware spatial operations (FindLabelAt, etc.). Useful for interactive applications.
BEHAVIOR:Draws label using layer's label parameters (format, position, etc.). Captures bounding polygon. For arc/ multipart: multiple labels → multiple polygons in buffer.
USAGE:Label extent:shape.DrawLabel(labelBounds); if labelBounds.PointInPolygon(cursorPos) then HitLabel;
CONSTRAINTS:Virtual method. Do NOT use within FindFirst..FindNext iteration (causes conflicts). Virtual method.