This topic has not yet been rated - Rate this topic

Point Structure

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Represents an x- and y-coordinate pair in two-dimensional space.

Namespace:  System.Windows
Assembly:  WindowsBase (in WindowsBase.dll)
XMLNS for XAML: http://schemas.microsoft.com/winfx/2006/xaml/presentation, http://schemas.microsoft.com/netfx/2007/xaml/presentation
[SerializableAttribute]
[TypeConverterAttribute(typeof(PointConverter))]
public struct Point : IFormattable
<object property="x,y"/>
-or-
<object property="x y"/>

XAML Values

x

The x-coordinate of this Point.

y

The y-coordinate of this Point.

The Point type exposes the following members.

  Name Description
Public method Point Creates a new Point structure that contains the specified coordinates.
Top
  Name Description
Public property X Gets or sets the X-coordinate value of this Point structure.
Public property Y Gets or sets the Y-coordinate value of this Point.
Top
  Name Description
Public method Static member Add Adds a Vector to a Point and returns the result as a Point structure.
Public method Equals(Object) Determines whether the specified Object is a Point and whether it contains the same coordinates as this Point. (Overrides ValueType.Equals(Object).)
Public method Equals(Point) Compares two Point structures for equality.
Public method Static member Equals(Point, Point) Compares two Point structures for equality.
Protected method Finalize Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
Public method GetHashCode Returns the hash code for this Point. (Overrides ValueType.GetHashCode().)
Public method GetType Gets the Type of the current instance. (Inherited from Object.)
Protected method MemberwiseClone Creates a shallow copy of the current Object. (Inherited from Object.)
Public method Static member Multiply Transforms the specified Point structure by the specified Matrix structure.
Public method Offset Offsets a point's X and Y coordinates by the specified amounts.
Public method Static member Parse Constructs a Point from the specified String.
Public method Static member Subtract(Point, Point) Subtracts the specified Point from another specified Point and returns the difference as a Vector.
Public method Static member Subtract(Point, Vector) Subtracts the specified Vector from the specified Point and returns the resulting Point.
Public method ToString() Creates a String representation of this Point. (Overrides ValueType.ToString().)
Public method ToString(IFormatProvider) Creates a String representation of this Point.
Top
  Name Description
Public operator Static member Addition Translates the specified Point by the specified Vector and returns the result.
Public operator Static member Equality Compares two Point structures for equality.
Public operator Static member Explicit(Point to Vector) Creates a Vector structure with an X value equal to the point's X value and a Y value equal to the point's Y value.
Public operator Static member Explicit(Point to Size) Creates a Size structure with a Width equal to this point's X value and a Height equal to this point's Y value.
Public operator Static member Inequality Compares two Point structures for inequality.
Public operator Static member Multiply Transforms the specified Point by the specified Matrix.
Public operator Static member Subtraction(Point, Point) Subtracts the specified Point from another specified Point and returns the difference as a Vector.
Public operator Static member Subtraction(Point, Vector) Subtracts the specified Vector from the specified Point and returns the resulting Point.
Top
  Name Description
Explicit interface implemetation Private method IFormattable.ToString This member supports the Windows Presentation Foundation (WPF) infrastructure and is not intended to be used directly from your code. For a description of this member, see ToString.
Top

In XAML, the delimiter between the X and Y values of a Point can be either a comma or a space.

Some cultures might use the comma character as the decimal delimiter instead of the period character. XAML processing for invariant culture defaults to en-US in most XAML processor implementations, and expects the period to be the decimal delimiter. You should avoid using the comma character as the decimal delimiter if specifying a Point in XAML, because that will clash with the string type conversion of a Point attribute value into the X and Y components.

The following example shows how to check if two Point structures are not equal. It also illustrates how to assign values to a Point structure when the structure is being declared and after the structure has been declared.


// Checks if two Points are equal using the overloaded inequality operator.
private Boolean pointInequalityExample()
{
    // Checks if two Points are not equal using the overloaded inequality operator.

    // Declaring point1 and initializing x,y values
    Point point1 = new Point(10, 5);

    // Declaring point2 without initializing x,y values
    Point point2 = new Point();

    // Boolean to hold the result of the comparison
    Boolean areNotEqual;

    // assigning values to point2
    point2.X = 15;
    point2.Y = 40;

    // Compare Point structures for equality.
    // areNotEqual is True
    areNotEqual = (point1 != point2);

    return areNotEqual;

}


More Code

How to: Make an Object Follow the Mouse Pointer This example shows how to change the dimensions of an object when the mouse pointer moves on the screen.

.NET Framework

Supported in: 4.5, 4, 3.5, 3.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 8 Consumer Preview, Windows Server 8 Beta, Windows 7, Windows Server 2008 SP2, Windows Server 2008 R2 (Server Core Role supported with SP1 or later; Itanium not supported)

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.
Did you find this helpful?
(1500 characters remaining)