com.esri.arcgis.geodatabase
Interface IInvalidArea

All Superinterfaces:
Serializable
All Known Subinterfaces:
IInvalidArea2, IInvalidArea3
All Known Implementing Classes:
InvalidArea

public interface IInvalidArea
extends Serializable

Provides access to members that modify an invalidated area object.

When To Use

To avoid graphical artifacts on the screen, instead of invalidating (refreshing) the entire display each time the rendered objects change, use this interface to create a collection of objects whose envelopes can be invalidated with one call. For example, when rotating features, use Add to add the selected features to the collection, perform the rotate operation, then call Invalidate . The same objects can be added again after the operation so that the new region is also invalidated. In summary, call Invalidate once at the end of an operation to refresh the screen within the envelopes bounding the objects that were added using the Add method.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux


Method Summary
 void add(Object thing)
          Add IFeature, IGeometry, ISet, or IEnumFeature.
 IScreenDisplay getDisplay()
          The display that will be invalidated.
 void invalidate(short screenCache)
          Invalidate the display.
 void setDisplayByRef(IScreenDisplay dpy)
          The display that will be invalidated.
 

Method Detail

getDisplay

IScreenDisplay getDisplay()
                          throws IOException,
                                 AutomationException
The display that will be invalidated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Returns:
A reference to a com.esri.arcgis.display.IScreenDisplay
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

setDisplayByRef

void setDisplayByRef(IScreenDisplay dpy)
                     throws IOException,
                            AutomationException
The display that will be invalidated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
dpy - A reference to a com.esri.arcgis.display.IScreenDisplay (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

add

void add(Object thing)
         throws IOException,
                AutomationException
Add IFeature, IGeometry, ISet, or IEnumFeature.

Remarks

This method allows you to add the following object types as a collection of regions whose envelopes can be invalidated (refreshed) with the Invalidate method : ISet, IGeometry, IFeature, and IEnumFeature.
 


Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
thing - A reference to another Object (IUnknown) (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

invalidate

void invalidate(short screenCache)
                throws IOException,
                       AutomationException
Invalidate the display.

Remarks

This method invalidates (refreshes) the screen in the regions specified by a collection of envelopes belonging to the objects added with this interface's Add method. The input parameter is typically the Editor's Display property, and defines the display that must be invalidated.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Parameters:
screenCache - The screenCache (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.