Freigeben über


Device.Clear-Methode (ClearFlags, Color, Single, Int32, array<Rectangle[])

Dieser Dokumentation für die Vorschau nur ist und in späteren Versionen geändert. Leere Themen wurden als Platzhalter eingefügt.]

Löscht den Viewport oder eine Reihe von Rechtecken im Viewport auf eine angegebene RGBA-Farbe, löscht den Tiefenpuffer und löscht den Stencilpuffer.

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

Syntax

'Declaration
Public Sub Clear ( _
    flags As ClearFlags, _
    color As Color, _
    zdepth As Single, _
    stencil As Integer, _
    rectangles As Rectangle() _
)
'Usage
Dim instance As Device
Dim flags As ClearFlags
Dim color As Color
Dim zdepth As Single
Dim stencil As Integer
Dim rectangles As Rectangle()

instance.Clear(flags, color, zdepth, stencil, _
    rectangles)
public void Clear(
    ClearFlags flags,
    Color color,
    float zdepth,
    int stencil,
    Rectangle[] rectangles
)
public:
void Clear(
    ClearFlags flags, 
    Color color, 
    float zdepth, 
    int stencil, 
    array<Rectangle>^ rectangles
)
member Clear : 
        flags:ClearFlags * 
        color:Color * 
        zdepth:float32 * 
        stencil:int * 
        rectangles:Rectangle[] -> unit 

Parameter

  • flags
    Typ: Microsoft.WindowsMobile.DirectX.Direct3D.ClearFlags
    Die Flags, die die Oberflächen deaktivieren angeben.Dieser Parameter kann eine beliebige Kombination folgender Flags, aber mindestens ein Flag muss verwendet werden:
    • Stencil: Löscht den Stencilpuffer auf den Wert der stencil Parameter.

    • Target: Löscht das Renderingziel auf die Farbe der color Parameter.

    • ZBuffer: Löscht den Tiefenpuffer auf den Wert der zdepth Parameter.

  • zdepth
    Typ: System.Single
    Ein neues zdepth-Wert, der diese Methode im Tiefenpuffer speichert.Dieser Parameter kann im Bereich von 0,0 und 1,0 (für Z-basierte oder w-basierte Tiefenpuffer) sein.Der Wert 0,0 stellt den nächstgelegenen Abstand und den Viewer;ein Wert von 1,0 stellt den am weitesten entfernten Abstand dar.
  • stencil
    Typ: System.Int32
    Ein ganzzahliger Wert in jedem Stencilpuffereintrag gespeichert.Dieser Parameter kann im Bereich von 0 bis 2 n1, sein, wobei n die Bittiefe für den Stencilpuffer ist.
  • rectangles
    Typ: array<System.Drawing.Rectangle[]
    Ein Array von Rectangle-Strukturen, die die Rechtecke deaktivieren beschreiben.Legen Sie ein Rechteck auf die Abmessungen des Ziels Rendering fest, um die gesamte Oberfläche zu löschen.Jedes Rechteck verwendet Bildschirmkoordinaten, die Punkte auf der Renderingzieloberfläche entsprechen.Koordinaten werden die Begrenzungen des Viewportrechtecks abgeschnitten.

Ausnahmen

Ausnahme Bedingung
InvalidCallException

Der Methodenaufruf ist ungültig.Beispielsweise kann ein Parameter einen ungültigen Wert enthalten.

Hinweise

Diese Methode schlägt fehl Wenn die ZBuffer oder Stencil Flags angegeben werden, wenn das Renderingziel nicht mit einer angefügten Tiefenpuffer verfügt.Schlägt die Methode entsprechend fehl, wenn das Flag Stencil angegeben Tiefenpuffer Format keine Schablone Puffer Informationen enthält.

.NET Framework-Sicherheit

Plattformen

Windows CE, Windows Mobile für Smartphone, Windows Mobile für Pocket PC

Die .NET Framework und .NET Compact Framework unterstützen nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen für .NET framework.

Versionsinformationen

.NET Compact Framework

Unterstützt in: 3.5, 2.0

Siehe auch

Referenz

Device Klasse

Member Device

Clear-Überladung

Microsoft.WindowsMobile.DirectX.Direct3D-Namespace