Provides access to members that control the Display.
Product Availability
When To Use
Use the IDisplay interface to draw points, lines, polygons, rectangles, and text on a device.
Members
| Description | ||
|---|---|---|
 |
ClipEnvelope | The bounds of the invalid region. Use after StartDrawing and before FinishDrawing. |
|
ClipEnvelopes | The invalid region as a set of envelopes. Use after StartDrawing and before FinishDrawing. |
 |
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. |
|
DisplayTransformation | The transformation used by the display. |
 |
DrawMultipoint | Draws specified multipoint on the display. |
|
DrawPoint | Draws specified point on the display. |
|
DrawPolygon | Draws specified polygon on the display. |
|
DrawPolyline | Draws specified line on the display. |
|
DrawRectangle | Draws specified rectangle on the display. |
|
DrawText | Draws specified text on the display. |
 |
Filter | Display filter. Must call while in a StartDrawing-FinishDrawing sequence. Set Filter to 0 to resume normal drawing. |
|
FinishDrawing | Completes drawing. |
|
hDC | The device context that the display is currently drawing to. Only valid between calls to StartDrawing and FinishDrawing. |
|
hPalette | Palette. |
|
IlluminationProps | Illumination properties used by the display. |
|
Progress | Call frequently during drawing process. |
|
SetSymbol | Sets the symbol used for drawing. Four different symbols can be specified simultaneously: Marker, Line, Fill, Text. |
|
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. |
|
SuppressEvents | Indicates if display object suppresses events. |
CoClasses that implement IDisplay
| CoClasses and Classes | Description |
|---|---|
| AppDisplay (esriArcMapUI) | Esri Display. |
| GlobeDisplay (esriGlobeCore) | The globe display object. |
| SceneGraph (esri3DAnalyst) | A container for recording data and events that occur in a scene. |
| 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.