fillRect method
[This documentation is preliminary and is subject to change.]
Paints a rectangle onto a CanvasRenderingContext2D object by using the current fill style.
![]() ![]() |
Syntax
var retval = CanvasRenderingContext2D.fillRect(x, y, w, h);Standards information
- HTML Canvas 2D Context, Section 8
Parameters
- x [in]
-
Type: float
The x-coordinate, in pixels, of the upper-left corner of the rectangle in relation to the coordinates of the canvas.
- y [in]
-
Type: float
The y-coordinate, in pixels, of the upper-left corner of the rectangle in relation to the coordinates of the canvas.
- w [in]
-
Type: float
The width, in pixels, of the rectangle in relation to the coordinates of the canvas.
- h [in]
-
Type: float
The height, in pixels, of the rectangle in relation to the coordinates of the canvas.
Return value
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Type: HRESULT
If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.
Remarks
If the w or h parameter is zero, the fillRect method does not draw the rectangle.
Examples
The following code example fills rectangles by using a linear gradient and a solid color.
<!DOCTYPE html> <html>
<head>
<script type="text/javascript">
function draw()
{
var canvas = document.getElementById("MyCanvas");
if (canvas.getContext)
//get a context
var ctx = canvas.getContext("2d");
//create a gradient object
var gradient = ctx.createLinearGradient(0, 0, canvas.width, 0);
// Add the colors with fixed stops at 1/4 of the width.
gradient.addColorStop("0","magenta");
gradient.addColorStop(".25","blue");
gradient.addColorStop(".50","green");
gradient.addColorStop(".75","yellow");
gradient.addColorStop("1.0","red");
// Use the gradient as a fill pattern
ctx.fillStyle = gradient;
ctx.fillRect (0,0,300,250);
ctx.fillStyle = "blue";
ctx.fillRect(250,300,600,500);
}
}
</script>
</head>
<body onload="draw();">
<canvas id="MyCanvas" width="600" height="500"> </canvas>
</body>
</html>
See also
Build date: 2/14/2012
It's missing a '{' after the if statement.
<!DOCTYPE html> <html>
<head>
<script type="text/javascript">
function draw()
{
var canvas = document.getElementById("MyCanvas");
if (canvas.getContext) {
//get a context
var ctx = canvas.getContext("2d");
//create a gradient object
var gradient = ctx.createLinearGradient(0, 0, canvas.width, 0);
// Add the colors with fixed stops at 1/4 of the width.
gradient.addColorStop("0","magenta");
gradient.addColorStop(".25","blue");
gradient.addColorStop(".50","green");
gradient.addColorStop(".75","yellow");
gradient.addColorStop("1.0","red");
// Use the gradient as a fill pattern
ctx.fillStyle = gradient;
ctx.fillRect (0,0,300,250);
ctx.fillStyle = "blue";
ctx.fillRect(250,300,600,500);
}
}
</script>
</head>
<body onload="draw();">
<canvas id="MyCanvas" width="600" height="500"> </canvas>
</body>
</html>
- 4/25/2012
- Mike Jackson [MSFT]

