Compartir a través de


CWnd::GetUpdateRect

Recupera las coordenadas del rectángulo menor que agrega completamente la región de actualización.

BOOL GetUpdateRect(
   LPRECT lpRect,
   BOOL bErase = FALSE 
);

Parámetros

  • lpRect
    Señala a un objeto de CRect o estructura de RECT que es recibir las coordenadas de cliente de actualización que agrega la región de actualización.

    Establezca este parámetro en NULL para determinar si una región de actualización existe dentro de CWnd.Si lpRect es NULL, la función miembro de GetUpdateRect devuelve cero si existe una región de actualización y 0 si no lo hace una.Proporciona una manera de determinar si un mensaje de WM_PAINT resultante de un área no válida.No establezca este parámetro en NULL en la versión de Windows 3,0 y versiones anteriores.

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

Valor devuelto

especifica el estado de la región de actualización.El valor es distinto de cero si la región de actualización no está vacía; si no 0.

Si el parámetro de lpRect se establece en NULL, el valor devuelto es distinto de cero si existe una región de actualización; si no 0.

Comentarios

Si CWnd se creó con el estilo de CS_OWNDC y el modo de asignación no tiene MM_TEXT, la función miembro de GetUpdateRect proporciona el rectángulo en coordenadas lógicas.Si no, GetUpdateRect proporciona el rectángulo en coordenadas de cliente.Si no hay ninguna región de actualización, GetUpdateRect establece el rectángulo esté vacío (conjuntos todas las coordenadas a 0).

el parámetro de bErase especifica si GetUpdateRect debe borrar el fondo de la región de actualización.Si bErase es TRUE y la región de actualización no está vacía, se borra el fondo.para borrar el fondo, GetUpdateRect envía el mensaje de WM_ERASEBKGND .

El rectángulo de actualización recuperado por la función miembro de BeginPaint es idéntico al recuperado por la función miembro de GetUpdateRect .

La función miembro de BeginPaint automáticamente valida la región de actualización, por lo que cualquier llamada a GetUpdateRect creó inmediatamente después de una llamada a BeginPaint recupera una región de actualización vacía.

Requisitos

encabezado: afxwin.h

Vea también

Referencia

Clase de CWnd

Gráfico de jerarquía

CWnd::BeginPaint

GetUpdateRect

CWnd::OnPaint

CWnd::RedrawWindow