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

IActiveView.ScreenDisplay Property (ArcObjects .NET 10.8 SDK)
ArcObjects Help for .NET developers > ArcObjects Help for .NET developers > ArcObjects namespaces > Carto > ESRI.ArcGIS.Carto > Interfaces > IA > IActiveView Interface > IActiveView.ScreenDisplay Property
ArcGIS Developer Help

IActiveView.ScreenDisplay Property

The screen display used by the view.

[Visual Basic .NET]
Public ReadOnly Property ScreenDisplay As IScreenDisplay
public IScreenDisplay ScreenDisplay {get;}
HRESULT get_ScreenDisplay(
  IScreenDisplay** screen
screen [out, retval]

screen is a parameter of type IScreenDisplay**

Product Availability

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


Each view has a ScreenDisplay object which controls drawing in the application's window.  Use this property to get a reference to the ScreenDisplay object associated with the view you are currently working with.  For example, to draw a polygon in data view, you must get an IActiveView reference on the focus Map object and then get a reference to its ScreenDisplay object via this property.  If you are in data view and you mistakenly get an IActiveView reference on the PageLayout object, you will not see the polygon as you are drawing in the wrong view.

Each ScreenDisplay object has a DisplayTransformation object which is accessible via IDisplay::DisplayTransformation (ScreenDisplay inherits from Display ).  Each DisplayTransformation related to a Map, holds onto the map's spatial reference (IDisplayTransformation::SpatialReference ) and has useful methods for converting between device units and map units. The PageLayout's DisplayTransformation does not have a spatial reference, the property returns nothing, and in this case its members map between device units and page units.

See Also

IActiveView Interface

.NET Samples

Move a graphic along a path in ArcMap Custom map navigation commands Create a custom tool Custom UI elements using add-ins Dynamic display animated zoom Dynamic display animated zoom Make a custom time slider Building a MapViewer application using the ArcGIS Engine controls Copy the PageLayoutControl focus map and overwrite the MapControl map Print multiple pages RSS weather layer RSS weather layer