Share via


ICanvasRenderingContext2D interface

Provides an object that represents a two-dimensional surface that has an origin (0,0) at the upper-left corner, with x-coordinates increasing as you move right and y-coordinates increasing as you move down.

Members

The ICanvasRenderingContext2D interface inherits from the IDispatch interface. ICanvasRenderingContext2D also has these types of members:

  • Methods
  • Properties

Methods

The ICanvasRenderingContext2D interface has these methods.

Method Description
arc

Adds points to a path that represents an arc.

arcTo

Draws an arc of a fixed radius between two tangents that are defined by the current point in a path and two additional points.

beginPath

Resets the current path.

bezierCurveTo

Adds a point to the current subpath by using the specified control points that represent a cubic Bézier curve.

clearRect

Clears the pixels on a CanvasRenderingContext2D object within a given rectangle.

clip

Specifies a new clipping region.

closePath

Closes the current subpath and starts a new subpath that has a start point that is equal to the end of the closed subpath.

createImageData

Returns a CanvasImageData object with the given dimensions in CSS pixels.

createLinearGradient

Creates an object that represents a linear gradient to use in a canvas context.

createPattern

Returns a CanvasPattern object that repeats the specified element in the specified direction.

createRadialGradient

Returns an object that represents a radial or circular gradient to use in a canvas context.

drawImage

Draws a specified image onto a canvas.

fill

Fills subpaths by using the current fill style.

fillRect

Paints a rectangle onto a CanvasRenderingContext2D object by using the current ICanvasRenderingContext2D::fillStyle.

fillText

Renders filled text to the canvas by using the current ICanvasRenderingContext2D::fillStyle and font.

getImageData

Returns an ICanvasImageData object that represents the pixel data for the specified rectangle on a canvas. Use the data property to get a CanvasPixelArray to manipulate individual pixel data.

isPointInPath

Determines if the specified point is in the current path.

lineTo

Adds a new point to a subpath and connects that point to the last point in the subpath by using a straight line.

measureText

Returns a CanvasTextMetrics object that contains the width of the specified text.

moveTo

Creates a new subpath by using the specified point.

putImageData

Paints the data from a specified CanvasImageData object onto a canvas.

quadraticCurveTo

Adds a point to the current subpath by using the specified control points that represent a quadratic Bézier curve.

rect

Creates a new closed rectangular subpath.

restore

Returns previously saved CanvasRenderingContext2D path state and attributes.

rotate

Rotates the current context coordinates (that is, a transformation matrix).

save

Saves the state of the current context.

scale

Scales the current context by the specified horizontal (x) and vertical (y) factors.

setTransform

Resets the current transformation matrix of the context back to the identity matrix and then multiplies it by the specified matrix.

stroke

Renders the strokes of the current subpath by using the current stroke styles.

strokeRect

Creates an outline of the specified rectangle on a canvas by using the current stroke, line width, and join styles.

strokeText

Renders the specified text at the specified position by using the current ICanvasRenderingContext2D::font, ICanvasRenderingContext2D::lineWidth, and ICanvasRenderingContext2D::strokeStyle property.

transform

Modifies the transformation matrix of the current context.

translate

Specifies values to move the origin point in a canvas.

 

Properties

The ICanvasRenderingContext2D interface has these properties.

Property Access type Description

canvas

Gets a back reference to the canvas object that the current context derives from.

fillStyle

Gets or sets the current style that is used to fill shapes.

font

Read/write

Gets or sets the current font for the context.

globalAlpha

Gets or sets the current alpha or transparency value that is applied to global composite rendering operations.

globalCompositeOperation

Gets or sets a value that indicates how source images are drawn onto a destination image.

lineCap

Gets or sets the current line cap style.

lineJoin

Gets or sets the type of corner that is created when two lines meet.

lineWidth

Gets or sets the current line width, in pixels.

miterLimit

Gets or sets the maximum allowed ratio between half of the ICanvasRenderingContext2D::lineWidth value and the miter length.

shadowBlur

Read/write

Gets or sets the current level of blur that is applied to shadows.

shadowColor

Read/write

Gets or sets the color to use for shadows.

shadowOffsetX

Read/write

Gets or sets the horizontal distance of a shadow from a shape.

shadowOffsetY

Read/write

Gets or sets the vertical distance of a shadow from a shape.

strokeStyle

Read/write

Gets or sets the current style that is used for strokes (lines) on shapes.

textAlign

Gets or sets the current anchor point or alignment settings for text in the current context.

textBaseline

Gets or sets the current settings for the font baseline alignment.

 

Remarks

The ICanvasRenderingContext2D interface provides most of the drawing methods and properties that are used with the IHTMLCanvasElement object.

You can include only one ICanvasRenderingContext2D object per canvas. Additional calls to this interface return the same context.

To see an interactive demo, see the Windows Internet Explorer 9 Test Drive Canvas demo.

Requirements

Minimum supported client

Windows Vista with SP1, Windows 7

Minimum supported server

Windows Server 2008 R2

Header

Mshtml.h

IDL

Mshtml.idl

DLL

Mshtml.dll

See also

IDispatch