phoenix_title wx.Point

A wx.Point is a useful data structure for graphics operations.

It contains integer x and y members. See wx.RealPoint for a floating point version.

Note that the width and height stored inside a wx.Point object may be negative and that wx.Point functions do not perform any check against negative values (this is used to e.g. store the special -1 value in wx.DefaultPosition instance).

See also

wx.RealPoint


class_hierarchy Class Hierarchy

Inheritance diagram for class Point:

method_summary Methods Summary

__init__

Constructs a point.

Get

Return the x and y properties as a tuple.

GetIM

Returns an immutable representation of the wx.Point object, based on namedtuple.

IsFullySpecified

Returns True if neither of the point components is equal to DefaultCoord.

Round

Creates a wx.Point by rounding the coordinates of the given wx.RealPoint.

SetDefaults

Combine this object with another one replacing the uninitialized values.

Truncate

Creates a wx.Point by truncating the coordinates of the given wx.RealPoint.

__eq__

__getitem__

__len__

__ne__

__reduce__

__repr__

__setitem__

__str__

__iadd__

__isub__


property_summary Properties Summary

IM

See GetIM

x

A public C++ attribute of type int. x member.

y

A public C++ attribute of type int. y member.


api Class API

class wx.Point(object)

Possible constructors:

Point() -> None

Point(x, y) -> None

Point(pt) -> None

A Point is a useful data structure for graphics operations.


Methods

__init__(self, *args, **kw)

overload Overloaded Implementations:



__init__ (self)

Constructs a point.

Initializes the internal x and y coordinates to zero.

Return type:

None



__init__ (self, x, y)

Initializes the point object with the given x and y coordinates.

Parameters:
  • x (int)

  • y (int)

Return type:

None



__init__ (self, pt)

Converts the given wx.RealPoint (with floating point coordinates) to a wx.Point instance.

Notice that since v3.1.2 the behaviour of this constructor has changed to round the floating point values of pt components, if you want to truncate them instead, please use wx.Point.Truncate .

Parameters:

pt (wx.RealPoint)

Return type:

None





Get(self)

Return the x and y properties as a tuple.

Return type:

Any



GetIM(self)

Returns an immutable representation of the wx.Point object, based on namedtuple.

This new object is hashable and can be used as a dictionary key, be added to sets, etc. It can be converted back into a real wx.Point with a simple statement like this: obj = wx.Point(imObj).



IsFullySpecified(self)

Returns True if neither of the point components is equal to DefaultCoord.

This method is typically used before calling SetDefaults .

Return type:

bool

Added in version 2.9.2.



static Round(pt)

Creates a wx.Point by rounding the coordinates of the given wx.RealPoint.

This is equivalent to using the constructor taking wx.RealPoint but is more explicit about the fact that rounding is performed.

Parameters:

pt (wx.RealPoint)

Return type:

wx.Point

Added in version 4.3/wxWidgets-3.3.2.



SetDefaults(self, pt)

Combine this object with another one replacing the uninitialized values.

It is typically used like this:

if not pos.IsFullySpecified():

    pos.SetDefaults(GetDefaultPosition())
Parameters:

pt (wx.Point)

Return type:

None

Added in version 2.9.2.

See also

IsFullySpecified



static Truncate(pt)

Creates a wx.Point by truncating the coordinates of the given wx.RealPoint.

This is similar to Round but instead of rounding the coordinates, they are simply truncated to integers.

Parameters:

pt (wx.RealPoint)

Return type:

wx.Point

Added in version 4.3/wxWidgets-3.3.2.



__eq__(self, other)
Return type:

bool



__getitem__(self, idx)


__len__(self)


__ne__(self, other)
Return type:

bool



__reduce__(self)


__repr__(self)


__setitem__(self, idx, val)


__str__(self)


__iadd__(self, *args, **kw)

overload Overloaded Implementations:



__iadd__ (self, sz)

Parameters:

sz (wx.Size)

Return type:

wx.Point



__iadd__ (self, pt)

Parameters:

pt (wx.Point)

Return type:

wx.Point





__isub__(self, *args, **kw)

overload Overloaded Implementations:



__isub__ (self, sz)

Parameters:

sz (wx.Size)

Return type:

wx.Point



__isub__ (self, pt)

Parameters:

pt (wx.Point)

Return type:

wx.Point




Properties

IM

See GetIM



x

A public C++ attribute of type int. x member.



y

A public C++ attribute of type int. y member.