ArcObjects Library Reference (Carto)  

IActiveView.ScreenDisplay Property

The screen display used by the view.

[Visual Basic .NET]
Public ReadOnly Property ScreenDisplay As IScreenDisplay
[C#]
public IScreenDisplay ScreenDisplay {get;}
[C++]
HRESULT get_ScreenDisplay(
  IScreenDisplay** screen
);
[C++]

Parameters

screen [out, retval]

  screen is a parameter of type IScreenDisplay

Product Availability

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

Remarks

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