Device.ColorFill Method

Article
12/12/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
)

Not applicable.

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:

Platforms

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

The Microsoft .NET Framework 3.0 is supported on Windows Vista, Microsoft Windows XP SP2, and Windows Server 2003 SP1.

Version Information

.NET Compact Framework

Supported in: 2.0

Share via