SwapChain.Present (Método) (Rectangle, Rectangle, Control)

Artículo
11/26/2008

Actualización: noviembre 2007

Muestra el contenido del siguiente búfer en la secuencia de búferes de reserva que posee la cadena de intercambio.

Espacio de nombres: Microsoft.WindowsMobile.DirectX.Direct3D
Ensamblado: Microsoft.WindowsMobile.DirectX (en Microsoft.WindowsMobile.DirectX.dll)

Sintaxis

'Declaración
Public Sub Present ( _
    sourceRectangle As Rectangle, _
    destRectangle As Rectangle, _
    overrideWindow As Control _
)
'Uso
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
)

public function Present(
    sourceRectangle : Rectangle, 
    destRectangle : Rectangle, 
    overrideWindow : Control
)

Parámetros

sourceRectangle
Tipo: System.Drawing.Rectangle
Se establece en true si se va a pasar Rectangle al parámetro rectPresent; de lo contrario, es false.

destRectangle
Tipo: System.Drawing.Rectangle
Rectangle que contiene el rectángulo de destino en las coordenadas de cliente de la ventana. Este valor se debe omitir a menos que la cadena de intercambio se creara utilizando Copy con SwapEffect. Si se omite el valor, se presenta la superficie de origen completa. Si el rectángulo excede la superficie de origen, se recorta para ajustarlo a ella.

overrideWindow
Tipo: System.Windows.Forms.Control
Ventana de destino cuyo área de cliente se toma como destino de la presentación actual.

Excepciones

Excepción	Condición
DriverInternalErrorException	Error interno del controlador. Las aplicaciones deben, por lo general, cerrarse al recibir este error.
InvalidCallException	La llamada al método no es válida. Por ejemplo, puede que un parámetro del método contenga un valor no válido.
OutOfMemoryException	Direct3D no pudo asignar memoria suficiente para completar la llamada.

Comentarios

Este método es un acceso directo al método Present de Device. El método de la cadena de intercambio se ha actualizado para incluir un indicador que permite a la aplicación solicitar que el método regrese inmediatamente cuando el controlador informe de que no puede programar una presentación.

Si es necesario, se aplica una operación de expansión para transferir los píxeles del interior del rectángulo de origen al rectángulo de destino en el área de cliente de la ventana de destino.

El método Present de Device genera un error si se llama entre su par de métodos BeginScene y EndScene, a menos que el destino de representación no sea el destino de representación actual, como el búfer de reserva que se obtiene de la creación de una cadena de intercambio adicional.

Permisos

Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.

Plataformas

Windows CE, Windows Mobile para Smartphone, Windows Mobile para Pocket PC

.NET Framework y .NET Compact Framework no admiten todas las versiones de cada plataforma. Para obtener una lista de las versiones compatibles, vea Requisitos de sistema de .NET Framework.