ArcObjects Library Reference (Geometry)

IPoint Interface

Provides access to members that define two dimensional points.

Product Availability

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

Description

A Point is a zero-dimensional object that represents a specific (X, Y) location in a the two-dimensional XY-Plane. A Point may also have Z, M, and ID attributes associated with it. Existence of attributes does not alter the dimensionality of a Point nor does it alter geometric calculations performed on the Point. Attributes are only considered for attribute calculations when the Point is ZAware, MAware, or PointIDAware. Points may be constructed using PutCoords, individually setting the X and Y properties, or using the IConstructPoint interface.

Members

		Description
	Compare	Compares X, Y, M, Z, ID of this point (in that order) with that of the other point. Returns -1 if this point's value is less, 1 if greater, and 0 otherwise. Useful for sorting a group of points.
	ConstrainAngle	Projects this point to the point on the infinite line defined by anchor and angle (in radians). If allowOpposite is true, then the point can also snap to angle + pi radians.
	ConstrainDistance	Projects this point to the perimeter of the circle defined by radius and anchor.
	Dimension	The topological dimension of this geometry.
	Envelope	Creates a copy of this geometry's envelope and returns it.
	GeometryType	The type of this geometry.
	GeoNormalize	Shifts longitudes, if need be, into a continuous range of 360 degrees.
	GeoNormalizeFromLongitude	Normalizes longitudes into a continuous range containing the longitude. This method is obsolete.
	ID	The Point ID attribute.
	IsEmpty	Indicates whether this geometry contains any points.
	M	The measure attribute.
	Project	Projects this geometry into a new spatial reference.
	PutCoords	Sets the X and Y coordinates.
	QueryCoords	Returns the X and Y coordinates.
	QueryEnvelope	Copies this geometry's envelope properties into the specified envelope.
	SetEmpty	Removes all points from this geometry.
	SnapToSpatialReference	Moves points of this geometry so that they can be represented in the precision of the geometry's associated spatial reference system.
	SpatialReference	The spatial reference associated with this geometry.
	X	The X coordinate.
	Y	The Y coordinate.
	Z	The Z attribute.

Inherited Interfaces

Interfaces	Description
IGeometry	Provides access to members that describe properties and behavior of all geometric objects.

CoClasses that implement IPoint

CoClasses and Classes	Description
Point	A two dimensional point, optionally with measure, height, and ID attributes.

Remarks

Point Example

See Also

IGeometry Interface | IMultipoint Interface | IConstructPoint Interface

.NET Snippets

Zoom to Selected Globe Features | Create CircularArc From Points | Get All Features from Point Search in GeoFeatureLayer | Get Azimuth from Two Points | Get Geographic Coordinates in Globe | Draw Line on Dynamic Display | Statements - Convert Coordinates MGRS to LatLong, DMS and UTM | Draw Compound Marker on Dynamic Display | Add Graphics Layer to Globe | Get Screen Coordinates from Map Coordinates | Toggle Between Surface and Global Navigation Mode | Get Map Coordinates from Screen Coordinates | Get Distance from Two Points | Set M Value on Point | Zoom by Ratio and Recenter | Draw Point | Display LatLong, DMS, and UTM from MGRS | Create Force Element | Move Force Element | Set Z Value on Point | Get First Feature from Point Search in GeoFeatureLayer |

.NET Samples

3D dynamic element tracking (Code Files: TrackDynamicObject) | 3D multipatch examples (Code Files: CompositeExamples DrawUtilities ExtrusionExamples GeometryUtilities Transform3DExamples Vector3DExamples) | Add map surrounds using the SymbologyControl (Code Files: NorthArrows ScaleBars ScaleText) | Angle Angle shape constructor (Code Files: AngleAngleCstr) | ArcGIS GPConsole (Code Files: Program) | Arranging MOLE graphics using manual decluttering (Code Files: MainForm) | Buffer snap agent (Code Files: BufferSnap) | Building a MapViewer application using the ArcGIS Engine controls (Code Files: AddDateTool) | Clonable object (Code Files: ClonableObjClass) | Closest facility application using the NAServer extension in ArcGIS Server via a GIS server (Code Files: ClosestFacility_GISServerAPIClass) | Configure a command for a specific locale (Code Files: CultureTool) | Control text symbols using the SymbologyControl (Code Files: TextSymbols) | Controls commands environment (Code Files: CommandsEnvironment) | Create a custom marker placement for placing markers around a point (Code Files: AroundPoint) | Create a custom selection extension by extending ArcObjects (Code Files: SelectByLineTool) | Create custom move, rotate, and scale GeometricEffects within a single project (Code Files: clsGE_Transform_Rotate clsGE_Transform_Scale) | Creating a toolbar of globe tools (Code Files: PointGeometry PolygonGeometry PolylineGeometry) | Curve conversion add-in (Code Files: CurveConversionDockWin) | Custom map navigation commands (Code Files: Pan PanDown PanLeft PanRight PanUp ZoomIn ZoomOut) | Custom map selection commands (Code Files: SelectFeatures) | Custom scene navigation commands (Code Files: Fly Navigate Pan SelectFeatures SelectGraphics SetObserver TargetCenter TargetZoom ZoomIn ZoomOut) | Custom selection extension (Code Files: SelectByLineTool) | Custom subtyped command and tool (Code Files: PolyFeedbackTools) | Custom vertex editing commands (Code Files: CustomVertexCommands) | Decluttering MOLE graphics using leadering and stacking (Code Files: MainForm) | Displaying MOLE symbology with the GlobeControl (Code Files: MainForm) | Displaying symbol-based MOLE graphics on a MapControl (Code Files: MoleDisplay) | Draw text on a MapControl (Code Files: DrawText) | Dynamic biking (Code Files: DynamicBikingCmd) | Dynamic display animated zoom (Code Files: AnimatedZoomInTool AnimatedZoomOutTool) | Dynamic display layer (Code Files: MyDynamicLayerClass) | Dynamic displaytracking dynamic object (Code Files: TrackObject) | Dynamic logo (Code Files: DynamicLogo) | Edit event listener (Code Files: EventListener) | Export any network analysis class to a text file (Code Files: NAClassToTextfileCmd) | Find an address (Code Files: AddressForm) | Find near features REST SOE (Code Files: FindNearFeaturesRestSOE_VBNet) | Find near features SOAP SOE (Code Files: FindNearFeaturesSoapSOE_VBNet) | Find the closest intersection from a point (Code Files: FindClosestIntersection) | Geodesy MapControl (Code Files: GeodesyMapControl) | Geoevents in a MapControl (Code Files: GeoEvents) | Globe Fly tool (Code Files: Fly) | GraphicTracker with the map (Code Files: AddGT GTMapForm) | Implementing a schematic digitizing tool (Code Files: DigitTool) | Import signposts (Code Files: ImportDynamapSignsFunction ImportMultiNetSignsFunction ImportNavStreetsSignsFunction) | Locate coordinates (Code Files: LocateCoordinates) | Move a graphic along a path in ArcMap (Code Files: AnimationUtils MapGraphicKeyframe) | Navigating around the GlobeControl (Code Files: Navigation) | Points along line construction tool (Code Files: PointsAlongLineForm PointsAlongLineTool) | Route application using the NAServer extension in ArcGIS Server via a GIS client (Code Files: Route_GISClientClass) | Route application using the NAServer extension in ArcGIS Server via a GIS server (Code Files: Route_GISServerAPIClass) | RSS weather GraphicTracker (Code Files: RSSWeather) | RSS weather layer (Code Files: AddRSSWeatherLayer AddWeatherItemTool RSSWeatherLayerClass) | Server spatial query COM utility (Code Files: VegTool_VBNet VegUtils_VBNet) | Server spatial query server object extension (Code Files: Extension VegTool) | Service area application using the NAServer extension in ArcGIS Server via a GIS server (Code Files: ServiceArea_GISServerAPIClass) | Simple dynamic display application (Code Files: MyDynamicLayer) | Simple point plug-in data source (Code Files: SimplePointCursor) | Simple SOE (Code Files: Form1 UtilSOE_VBNet) | Single line address geocoding (Code Files: SingleLineGeocodingForm) | StreetMap routing (Code Files: RoutingForm) | Tabbed feature inspector (Code Files: ObjectInspector TabbedInspector) | Triangle graphic element (Code Files: TriangleElementClass TriangleElementTool) | Using MOLE symbol-based graphics with interactive maps (Code Files: MainForm) | Using the traversal result to select source features (Code Files: SelectFeaturesTool) | ViperPin tool (Code Files: ViperPinForm ViperPinTool) | Visualizing the camera path while animating (Code Files: VisualizeCameraPath) |

.NET Related Topics

Updating features | Adjusting feature locations with spatial adjustment | Building a map viewing application using the ArcGIS Engine controls | Creating a TIN | Creating class extensions | Creating custom symbols | DataSourcesRaster | DefenseSolutions | Feature services | Geocode services | Geometry service | Geoprocessing services | Getting started with dynamic display | How to build a polygon using segments and points | How to convert coordinate arrays | How to convert degrees/minutes/seconds to decimal degrees | How to create a multipoint using the ConstructIntersectionEx method | How to create a polygon | How to create a polyline | How to create a raster dataset | How to create an SOE client | How to draw a point on the screen | How to find the address closest to a point using reverse geocoding | How to geocode a single address | How to geocode a table of addresses | How to get map coordinates from screen coordinates | How to get screen coordinates from map coordinates | How to interpolate spot heights and profile lines on a TIN | How to load data into a network analysis problem | How to modify a specific segment of a polyline | How to modify a specific vertex of a polyline | How to perform an affine transformation | How to perform surface analysis on a terrain dataset | How to query an image service | How to rotate the MapControl display | How to set raster properties when saving as a raster | How to snap a point to a coordinate grid | How to use some basic properties and methods on ICircularArc | How to use the IAffineTransformation2D project and MoveOrigin methods | How to use the ICurve methods | How to use the IEnumSegment methods | How to use the IEnumVertex methods | How to work with geocoding properties | How to work with geoprocessing services | How to work with IBezierCurve | How to work with ICurve methods | How to work with IEllipticArc properties | How to work with IExtrude | How to zoom to selected features in globe | Implementing cloning | Implementing persistence | NetworkAnalysis | Performing basic map functions | Programming with server objects | Server | SOAP Web services | TrackingAnalyst | Transforming envelopes in the display | Updating attributes of existing features | Using ArcObjects (COM-based) in .NET | Using ArcObjects as tool input | Using feature templates | Using IGeometryBridge or IGeometryBridge2 | Working with map elements | Working with PageLayout elements | Working with query cursors | Working with server contexts | Working with the ArcGIS snapping environment | Working with the edit sketch | Working with vertex attributes | Writing .NET code using methods | Writing .NET code using properties |