Compartir a través de


CWnd::InvalidateRgn

Reemplaza el área cliente de la región determinada agregándolo a la región de actualización actual de CWnd.

void InvalidateRgn( 
   CRgn* pRgn, 
   BOOL bErase = TRUE  
);

Parámetros

  • pRgn
    un puntero a un objeto de CRgn que identifica la región que se agregará a la región de actualización. La región se supone para obtener las coordenadas de cliente. si este parámetro es NULL, el área cliente completa se agrega a la región de actualización.

  • bErase
    Especifica si el fondo en la región de actualización es necesario desactivar.

Comentarios

La región invalidada, junto con el resto de las áreas de la región de actualización, se marca para pintar cuando el mensaje de WM_PAINT se envía a. Las áreas invalidadas acumulan en la región de actualización hasta que se procese la región cuando un mensaje de WM_PAINT se envía a, o hasta la región es validado por función miembro de ValidateRect o de ValidateRgn .

El parámetro de bErase especifica si el fondo del área de actualización es necesario desactivar cuando se procesa la región de actualización. Si bErase es TRUE, se borra el fondo cuando se llama a la función miembro de BeginPaint ; si bErase es FALSO, el fondo permanece sin modificar. Si bErase es TRUE para cualquier parte de la región de actualización, el fondo de la región completa, no solo en la parte determinada, se borra.

Windows envía un mensaje de WM_PAINT siempre que la región de actualización de CWnd no está vacía y no hay otros mensajes en la cola de la aplicación para esa ventana.

La región determinada debe haberse creado previamente por una de las funciones de la región.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

CWnd (clase)

Gráfico de jerarquías

CWnd::BeginPaint

CWnd::ValidateRect

CWnd::ValidateRgn

InvalidateRgn

CWnd::Invalidate

CWnd::InvalidateRect