Class Touch

Namespace

CSharpToJavaScript.APIs.JS

Assembly

CSharpToJavaScript.dll

The Touch interface represents a single contact point on a touch-sensitive device. The contact point is commonly a finger or stylus and the device may be a touchscreen or trackpad.

[Value("Touch")]
public class Touch

Inheritance

object

Touch

Inherited Members

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Remarks

The RadiusX, RadiusY, and RotationAngle describe the area of contact between the user and the screen, the touch area. This can be helpful when dealing with imprecise pointing devices such as fingers. These values are set to describe an ellipse that as closely as possible matches the entire area of contact (such as the user's fingertip).

NOTE

Many of the properties' values are hardware-dependent; for example, if the device doesn't have a way to detect the amount of pressure placed on the surface, the force value will always be 0. This may also be the case for radiusX and radiusY; if the hardware reports only a single point, these values will be 1.

-Touch events
-Document.CreateTouch

See also on MDN

Constructors

Touch()

public Touch()

Touch(TouchInit)

The Touch() constructor creates a new Touch object.

public Touch(TouchInit touchInitDict)

Parameters

touchInitDict TouchInit

Remarks

-TouchEvent, the interface of the objects it constructs.

See also on MDN

Properties

AltitudeAngle

[Value("altitudeAngle")]
public Number AltitudeAngle { get; }

Property Value

Number

AzimuthAngle

[Value("azimuthAngle")]
public Number AzimuthAngle { get; }

Property Value

Number

ClientX

The Touch.clientX read-only property returns the X coordinate of the touch
point relative to the viewport, not including any scroll offset.

[Value("clientX")]
public Number ClientX { get; }

Property Value

Number

A double floating point value representing the X coordinate of the touch point
relative to the viewport, not including any scroll offset.

Remarks

See also on MDN

ClientY

The Touch.clientY read-only property returns the Y
coordinate of the touch point relative to the browser's viewport, not including any
scroll offset.

[Value("clientY")]
public Number ClientY { get; }

Property Value

Number

A double floating point value representing the Y coordinate of the touch point
relative to the viewport, not including any scroll offset.

Remarks

See also on MDN

Force

The Touch.force read-only property returns the amount of
pressure the user is applying to the touch surface for a Touch point.

[Value("force")]
public Number Force { get; }

Property Value

Number

A float that represents the amount of pressure the user is applying to the
touch surface. This is a value between 0.0 (no pressure) and
1.0 (the maximum amount of pressure the hardware can recognize). A value of
0.0 is returned if no value is known (for example the touch device does not
support this property). In environments where force is known, the absolute pressure
represented by the force attribute, and the sensitivity in levels of pressure, may vary.

Remarks

See also on MDN

Identifier

The Touch.identifier returns a value uniquely identifying
this point of contact with the touch surface. This value remains consistent for every
event involving this finger's (or stylus's) movement on the surface until it is lifted
off the surface.

[Value("identifier")]
public long Identifier { get; }

Property Value

long

A long that represents the unique ID of the Touch object.

Remarks

See also on MDN

PageX

The Touch.pageX read-only property returns the X
coordinate of the touch point relative to the viewport, including any scroll offset.

[Value("pageX")]
public Number PageX { get; }

Property Value

Number

A double floating point value representing the X coordinate of the touch point
relative to the viewport, including any scroll offset.

Remarks

See also on MDN

PageY

The Touch.pageY read-only property returns the Y
coordinate of the touch point relative to the viewport, including any scroll offset.

[Value("pageY")]
public Number PageY { get; }

Property Value

Number

A double floating point value representing the Y coordinate of the touch point
relative to the viewport, including any scroll offset.

Remarks

See also on MDN

RadiusX

The radiusX read-only property of the Touch interface returns the X radius of the ellipse that most closely circumscribes the area of contact with the touch surface. The value is in CSS pixels of the same scale as ScreenX.

[Value("radiusX")]
public Number RadiusX { get; }

Property Value

Number

A number.

Remarks

This value, in combination with RadiusY and RotationAngle constructs an ellipse that approximates the size and shape of the area of contact between the user and the screen. This may be a relatively large ellipse representing the contact between a fingertip and the screen or a small area representing the tip of a stylus, for example.

See also on MDN

RadiusY

The radiusY read-only property of the Touch interface returns the Y radius of the ellipse that most closely circumscribes the area of contact with the touch surface. The value is in CSS pixels of the same scale as ScreenX.

[Value("radiusY")]
public Number RadiusY { get; }

Property Value

Number

A number.

Remarks

This value, in combination with RadiusX and RotationAngle constructs an ellipse that approximates the size and shape of the area of contact between the user and the screen. This may be a large ellipse representing the contact between a fingertip and the screen or a small one representing the tip of a stylus, for example.

See also on MDN

RotationAngle

The rotationAngle read-only property of the Touch interface returns the rotation angle, in degrees, of the contact area ellipse defined by RadiusX and RadiusY. The value may be between 0 and 90. Together, these three values describe an ellipse that approximates the size and shape of the area of contact between the user and the screen. This may be a relatively large ellipse representing the contact between a fingertip and the screen or a small area representing the tip of a stylus, for example.

[Value("rotationAngle")]
public Number RotationAngle { get; }

Property Value

Number

A number.

Remarks

See also on MDN

ScreenX

Returns the X coordinate of the touch point relative to the screen, not including any scroll offset.

[Value("screenX")]
public Number ScreenX { get; }

Property Value

Number

A number.

Remarks

See also on MDN

ScreenY

Returns the Y coordinate of the touch point relative to the screen, not including any scroll offset.

[Value("screenY")]
public Number ScreenY { get; }

Property Value

Number

A number.

Remarks

See also on MDN

Target

The read-only target property of the Touch interface returns the (EventTarget) on which the touch contact started when it was first placed on the surface, even if the touch point has since moved outside the interactive area of that element or even been removed from the document. Note that if the target element is removed from the document, events will still be targeted at it, and hence won't necessarily bubble up to the window or document anymore. If there is any risk of an element being removed while it is being touched, the best practice is to attach the touch listeners directly to the target.

[Value("target")]
public EventTarget Target { get; }

Property Value

EventTarget

The EventTarget the Touch object applies to.

Remarks

See also on MDN

TouchType

[Value("touchType")]
public TouchType TouchType { get; }

Property Value

TouchType