SwapChain.Present-Methode (Rectangle, Rectangle, Control)

Artikel
11/08/2009

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

Stellt den Inhalt des nächsten Puffers in die Sequenz der Hintergrundpuffer der Swapkette Besitz.

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

Syntax

'Declaration
Public Sub Present ( _
    sourceRectangle As Rectangle, _
    destRectangle As Rectangle, _
    overrideWindow As Control _
)
'Usage
Dim instance As SwapChain
Dim sourceRectangle As Rectangle
Dim destRectangle As Rectangle
Dim overrideWindow As Control

instance.Present(sourceRectangle, destRectangle, _
    overrideWindow)

public void Present(
    Rectangle sourceRectangle,
    Rectangle destRectangle,
    Control overrideWindow
)

public:
void Present(
    Rectangle sourceRectangle, 
    Rectangle destRectangle, 
    Control^ overrideWindow
)

member Present : 
        sourceRectangle:Rectangle * 
        destRectangle:Rectangle * 
        overrideWindow:Control -> unit

Parameter

sourceRectangle
Typ: System.Drawing.Rectangle
Legen Sie auf true , wenn ein Rectangle an den Parameter rectPresent übergeben wirdandernfalls false.

destRectangle
Typ: System.Drawing.Rectangle
Ein Rectangle, das das Zielrechteck in Clientkoordinaten Fenster enthält.Dieser Wert muss weggelassen werden, wenn die Swapkette mit Copy mit einer SwapEffect erstellt wurde.Wenn der Wert ausgelassen wird, wird die gesamte Quelloberfläche dargestellt.Wenn das Rechteck größer als die Quelloberfläche ist, wird es entsprechend abgeschnitten.

overrideWindow
Typ: System.Windows.Forms.Control
Ziel-Fenster, dessen Clientbereich als Ziel für die aktuelle Präsentation verwendet wird.

Ausnahmen

Ausnahme	Bedingung
DriverInternalErrorException	Interner Treiberfehler.Anwendungen sollten im Allgemeinen heruntergefahren, wenn diese Fehlermeldung.
InvalidCallException	Der Methodenaufruf ist ungültig.Beispielsweise kann eine Methode Parameter einen ungültigen Wert enthalten.
OutOfMemoryException	Direct3D konnte nicht genügend Speicher um den Aufruf vollständig auszuführen.

Hinweise

Diese Methode ist eine Verknüpfung zu Present für eine Device.Die Methode Swap Kette wurde aktualisiert, um ein Flag einzuschließen, die ermöglicht der Anwendung anfordern, dass die Methode sofort nach der Treiber meldet, dass Sie eine Präsentation Planen kann nicht zurück.

Falls erforderlich, wird ein Streckvorgang angewendet, um die Pixel im Quellrechteck in das Zielrechteck im Clientbereich des Zielfensters zu übertragen.

Die Present -Methode von einer Device schlägt fehl, wenn Sie zwischenBeginScene und EndScene Paar; aufgerufen wirdWenn das Renderingziel nicht das aktuelle Renderingziel z. B. den Hintergrundpuffer, die durch die Erstellung einer zusätzlichen Swapkette ist.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

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.