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