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


ScreenDisplay CoClass (ArcObjects .NET 10.5 SDK)
ArcObjects Library Reference (Display)  

ScreenDisplay CoClass

Display class for drawing to window.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Interfaces

Interfaces Description
IConnectionPointContainer (esriDisplay) Supports connection points for connectable objects.
IDisplay Provides access to members that control the Display.
IDisplayFiltersControl Provides access to members that control filters the Display.
IDraw Provides access to members that control drawing.
IDynamicScreenDisplay Provides access to dynamic screen display.
IScreenCacheManager Provides access to a ScreenDisplay's caches.
IScreenDisplay Provides access to members that control Screen Display.
IScreenDisplay2 Provides access to additional members that control the Screen Display.
IScreenDisplay3 Provides access to members that control Screen Display.
IScreenDisplayBasemap Provides access to members that control Screen Display Basemap drawing.
IScreenDisplayOverlays Provides access to members that control Screen Display Overlays.
IScreenDisplayZoom Provides access to zooming the screen display.
IScreenInvalidate Provides access to a ScreenDisplay's refresh methods.
ITimeDisplay Provides access to members that control the Time Extent.
ITimeDisplay2 Provides access to members that control the Time Extent.
ITransformEvents Provides access to members that control Transform Events.

Event Interfaces

Interfaces Description
IDisplayEvents (default) Provides access to members that control Display Events.
ITimeDisplayEvents Provides access to members that control Display Time Events.

Remarks

The ScreenDisplay object is a display device that is associated with a window.  In addition to managing the display attributes for the screen, a ScreenDisplay also manages other issues specific to windows including backing stores (caches), scrolling, and invalidation.

Several objects manage (CoCreate) a ScreenDisplay object to help control their associated window.  For example, each active view, Map and PageLayout, has its own associated ScreenDisplay and so does the MapInsetWindow. The AppDisplay object does not instantiate a new ScreenDisplay object; instead, this object implements the IScreenDisplay interface which is also what the ScreenDisplay object does.

A reference to a ScreenDisplay object is typically obtained via IActiveView::ScreenDisplay for the active views or ILensWindow::ScreenDisplay for the MapInsetWindow.

The ScreenDisplay object is CoCreateable; one case when you may have to create a new ScreenDisplay object, is when creating a custom active view.

The ScreenDisplay object listens for and reacts to the following keyboard and mouse actions:

Mouse-Wheel: Pan up and down the display
Cntrl Mouse-Wheel : Zoom in and out of the display
Page Up Key : Pan up the display
Page Down Key : Pan down the display
Home Key : Pan to the far left of the display extent
End Key :  Pan to the far right of the display extent

Working with Events

[Visual Basic 6.0]

When working with ScreenDisplay's default outbound interface in Visual Basic 6 declare variables as follows:

Private WithEvents pScreenDisplay as ScreenDisplay

When implementing ITimeDisplayEvents declare variables as follows:

Private WithEvents pTimeDisplayEvents as TimeDisplayEvents

See Also

IActiveView Interface