This document is archived and information here might be outdated.  Recommended version.


IDisplay Interface (ArcObjects .NET 10.7 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Display > ESRI.ArcGIS.Display > Interfaces > ID > IDisplay Interface
ArcGIS Developer Help

IDisplay Interface

Provides access to members that control the Display.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

When To Use

Use the IDisplay interface to draw points, lines, polygons, rectangles, and text on a device.

Members

Name Description
Read-only property ClipEnvelope The bounds of the invalid region. Use after StartDrawing and before FinishDrawing.
Read-only property ClipEnvelopes The invalid region as a set of envelopes. Use after StartDrawing and before FinishDrawing.
Read/write property ClipGeometry User-specified clip shape. This shape is merged with the invalid region to arrive at the actual clip region. Must be specified before StartDrawing.
Read/write property DisplayTransformation The transformation used by the display.
Method DrawMultipoint Draws specified multipoint on the display.
Method DrawPoint Draws specified point on the display.
Method DrawPolygon Draws specified polygon on the display.
Method DrawPolyline Draws specified line on the display.
Method DrawRectangle Draws specified rectangle on the display.
Method DrawText Draws specified text on the display.
Read/write property Filter Display filter. Must call while in a StartDrawing-FinishDrawing sequence. Set Filter to 0 to resume normal drawing.
Method FinishDrawing Completes drawing.
Read-only property hDC The device context that the display is currently drawing to. Only valid between calls to StartDrawing and FinishDrawing.
Read/write property hPalette Palette.
Read/write property IlluminationProps Illumination properties used by the display.
Method Progress Call frequently during drawing process.
Method SetSymbol Sets the symbol used for drawing. Four different symbols can be specified simultaneously: Marker, Line, Fill, Text.
Method StartDrawing Prepare the display for drawing. Specify the device context and the cache to draw to (normally esriNoScreenCache). The ScreenDisplay coclass will automatically create a window device context if you specify hdc = 0.
Read/write property SuppressEvents Indicates if display object suppresses events.

Classes that implement IDisplay

Classes Description
AppDisplay (esriArcMapUI) Esri Display.
ScreenDisplay Display class for drawing to window.
SimpleDisplay Display class for drawing to any HDC.

Remarks

The Display objects, those that implement IDisplay, are a set of objects which allow application developers to easily draw graphics on a variety of output devices.  These objects allow you to render shapes stored in real-world coordinates to a screen, printer, or export file.

The IDisplay interface abstracts a drawing surface.  A drawing surface is simply any hardware device, export file, or memory bitmap that can be represented by a Windows Device Context.   Each display manages its own DisplayTransformation object which handles the conversion of coordinates from real-world space to device space and back. 

There are currently two Display objects: ScreenDisplay and SimpleDisplay.  The ScreenDisplay object abstracts a normal application window and implements scrolling and backing store.  The SimpleDisplay abstracts all other devices that can be rendered to using a Windows Device Context such as printers and metafiles.

.NET Samples

Move a graphic along a path in ArcMap Dynamic biking Dynamic display animated zoom Dynamic display animated zoom Dynamic logo Edit event listener Multivariate renderer RSS weather layer Implementing a schematic digitizing tool Triangle graphic element