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

IAppDisplay Interface (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Display > ESRI.ArcGIS.Display > Interfaces > IA > IAppDisplay Interface
ArcGIS Developer Help

IAppDisplay Interface

Provides access to members that control the Mx Display.

Product Availability

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


Name Description
Read/write property ActiveCache Screen cache where drawing occurs. Use rarely. Change cache inside StartDrawing/FinishDrawing sequence.
Method AddCache Creates a new cache and return its ID. The ID can be specified to StartDrawing to direct output to the cache. It can also be used with a number of other methods such as DrawCache and Invalidate.
Read-only property CacheCount Number of screen caches.
Read-only property CacheMemDC Memory device context for the specified screen cache.
Read/write property CancelTracker Cancel tracker that is associated with the display.
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-only property Count The number of ScreenDisplays associated with the application.
Read/write property DisplayTransformation The transformation used by the display.
Method DoScroll Scrolls the screen by the specified amount.
Method DrawCache Draws the specified screen cache to the specified window device context. Pass an empty rectangle to copy the full bitmap to the DC origin.
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 FocusScreen The ScreenDisplay associated with the window the mouse is over. May be a lens window or the main window.
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 hWnd Associated window handle.
Read/write property IlluminationProps Illumination properties used by the display.
Method Invalidate Cause the specified area of the specified cache to redraw.
Method IsCacheDirty Indicates if the specified cache needs refreshing.
Read/write property IsFirstCacheTransparent Indicates if the bottom cache is transparent.
Read/write property IsFramed Indicates if drawing occurs in a frame rather than on the whole window.
Read/write property MainScreen The ScreenDisplay associated with the main application window. Set this property before using the other properties and methods.
Method PanMoveTo Pans to a new point.
Method PanStart Prepares display for panning.
Method PanStop Stops panning and returns new visible bounds.
Method Progress Call frequently during drawing process.
Method RemoveAllCaches Removes all caches.
Method RemoveCache Removes the specified cache.
Method RotateMoveTo Rotates to new point.
Method RotateStart Prepares display for rotating. If centerPt is NULL, the center of the visible bounds is used.
Method RotateStop Stops rotating and returns new angle.
Method RotateTimer Draws the rotated display. Call in response to WM_TIMER.
Read/write property ScaleContents Indicates if the contents of the screen scale when a resize occurs. True means scale contents to fit new window size. False means contents stays the same with more or less of it showing.
Read-only property ScreenDisplay The nth ScreenDisplay associated with the application.
Method SetScrollbarHandles Optionally specify application supplied scrollbars.
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.
Method StartRecording Starts recording all output to the recording cache.
Method StopRecording Stops recording to the recording cache.
Read/write property SuppressEvents Indicates if display object suppresses events.
Read/write property SuppressResize Indicates if display resizing is suppressed. True means the display doesn't resize with the window. False ensures that the display is the same size as the window.
Method TrackPan Interactively pans the screen.
Method TrackRotate Interactively rotates the screen.
Method UpdateWindow Forces a redraw.
Read/write property UseScrollbars Indicates if scrollbars should appear.
Read-only property WindowDC Device context for the associated window. Only use this between calls to StartDrawing and FinishDrawing.

Inherited Interfaces

Interfaces Description
IScreenDisplay Provides access to members that control Screen Display.
IDisplay Provides access to members that control the Display.

Classes that implement IAppDisplay

Classes Description
AppDisplay (esriArcMapUI) Esri Display.

.NET Samples

Angle Angle shape constructor Implementing a schematic digitizing tool