ArcObjects Library Reference (GeoDatabase)

XYEventSource Class

XY event source object.

XYEventSource is a non-creatable object. References to non-creatable objects must be obtained through other objects.

Product Availability

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

Supported Platforms

Windows, Solaris, Linux

Interfaces

Interfaces	Description
IClass	Provides access to members that return information about and manage the class.
IDataset	Provides access to members that supply dataset information.
IDatasetEdit	Provides access to information about the status of datasets being edited.
IDatasetEditInfo	Provides access to members that maintain dataset editing information.
IEventSource	Provides access to event source properties.
IFeatureClass	Provides access to members that control the behavior and properties of a feature class.
IGeoDataset	Provides access to members that provide information about a Geographic Dataset.
IObjectClass	Provides access to members that return information about an object class.
IObjectClassInfo	Provides access to method that indicates whether an object can bypass the store method.
IObjectClassInfo2	Provides access to method that indicates whether an object can be modified outside of an edit session.
ISubtypes	Provides access to members that return and modify subtype information.
ITable	Provides access to members that return information about and manage tables.
ITableCapabilities	Provides access to members that return information about and manage tables.
IVirtualTable	Indicator interface that identifies temporary memory tables.
IXYEventSource	Provides access to members that allow interaction with an existing XY Event Layer.

Event Interfaces

Interfaces	Description
IObjectClassEvents (default)	Provides access to events that occur with an object class.
IObjectClassSchemaEvents	Provides access to events that occur with an object class' schema.

Remarks

A table that contains a field with X coordinates and a field with Y coordinates can be used to dynamically create a point feature class. The feature class is dynamic in that the shapes are generated as needed from data in a source table rather than accessed from a physical data source. The source table that contains the coordinates is called the XY event table.

The XYEventSource class generates a dynamic featureclass from an XY event table. A point, based on the coordinates in the fields specified by XYEvent2FieldsProperties, is created for each row in the XY event table.

In order to create an XYEventSource, you must first create an XYEventSourceName. Since XYEventSource inherits from FeatureClass, it implements the same interfaces and can be treated like any other point feature class. It can be added to ArcMap as a point feature layer and even edited directly with the editor.

There may be some limitations imposed by the XY event table, however. For example, you will not be able to directly edit a feature class created from a delimited text file table since the editor doesn't allow text files to be edited directly. Also, you cannot add or move points using the tools in the editor toolbar. To add or move points, you must edit the coordinates or add new records to the table.

Working with Events

[Visual Basic 6.0]

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

Private WithEvents pXYEventSource as XYEventSource

When implementing IObjectClassSchemaEvents declare variables as follows:

Private WithEvents pObjectClassSchemaEvents as ObjectClassSchemaEvents