Texture.AddDirtyRectangle (Método) (Rectangle)

Artículo
11/26/2008

Actualización: noviembre 2007

Agrega una región obsoleta a un recurso de textura.

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

Sintaxis

'Declaración
Public Sub AddDirtyRectangle ( _
    rect As Rectangle _
)
'Uso
Dim instance As Texture
Dim rect As Rectangle

instance.AddDirtyRectangle(rect)

public void AddDirtyRectangle(
    Rectangle rect
)

public:
void AddDirtyRectangle(
    Rectangle rect
)

public function AddDirtyRectangle(
    rect : Rectangle
)

Parámetros

rect
Tipo: System.Drawing.Rectangle
Estructura Rectangle que especifica la región obsoleta que se va a agregar.

Excepciones

Excepción	Condición
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.

Comentarios

Una región obsoleta es una parte de un búfer que ha sido marcada como obsoleta, es decir, que se debe actualizar antes de mostrarla de nuevo.

Al omitir el parámetro rect, se expande la región obsoleta para que abarque toda la textura.

Por motivos de rendimiento, las regiones obsoletas sólo se registran para el nivel cero de una textura. En los subniveles, se supone que el rectángulo o cuadro correspondiente (con ajuste de escala) también está obsoleto.

Las aplicaciones pueden especificar qué subconjunto de un recurso se copia en una llamada al método UpdateTexture de Device especificando las regiones obsoletas. Se puede utilizar para la optimización.

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.