Device.ColorFill Method

Article
07/18/2007

Allows an application to fill a rectangular area with a specified color.

Namespace: Microsoft.WindowsMobile.DirectX.Direct3D
Assembly: Microsoft.WindowsMobile.DirectX (in microsoft.windowsmobile.directx.dll)

Syntax

'Declaration
Public Sub ColorFill ( _
    surface As Surface, _
    rectangle As Rectangle, _
    color As Color _
)
'Usage
Dim instance As Device
Dim surface As Surface
Dim rectangle As Rectangle
Dim color As Color

instance.ColorFill(surface, rectangle, color)

public void ColorFill (
    Surface surface,
    Rectangle rectangle,
    Color color
)

public:
void ColorFill (
    Surface^ surface, 
    Rectangle rectangle, 
    Color color
)

public void ColorFill (
    Surface surface, 
    Rectangle rectangle, 
    Color color
)

public function ColorFill (
    surface : Surface, 
    rectangle : Rectangle, 
    color : Color
)

Parameters

surface
A surface to be filled.

rectangle
A source Rectangle. To fill the entire surface, specify a null reference (Nothing in Visual Basic).

color
A color used for filling.

Exceptions

Exception type	Condition
InvalidCallException	The method call is invalid. For example, a parameter might contain an invalid value.

Remarks

This method can be applied only to a render target, a render-target texture surface, or an off-screen plain surface.

ColorFill works with all formats. However, when using a reference or a software device, only the following formats are supported:

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see .

Platforms

Windows CE, Windows Mobile for Pocket PC, Windows Mobile for Smartphone

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

Version Information

.NET Compact Framework

Supported in: 2.0