CWnd::RedrawWindow

BOOL RedrawWindow ( LPCRECT lpRectUpdate = NULL, CRgn * prgnUpdate = NULL, UINT banderas = RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE );

Valor devuelto

Distinto de cero si la ventana se vuelve a dibujar correctamente; caso contrario 0.

Parámetros

lpRectUpdate

Puntos de una estructura RECT que contiene las coordenadas del rectángulo de actualización. Este parámetro se omite si prgnUpdate contiene un identificador de región válida.

prgnUpdate

Identifica la región de actualización. Si prgnUpdate y lpRectUpdate son NULL, toda el área cliente se agrega a la región de actualización.

banderas

Se utilizan los siguientes indicadores para invalidar la ventana:

• RDW_ERASEnbsp;  Hace que la ventana recibir un mensaje WM_ERASEBKGND cuando se actualiza la ventana. También debe especificarse la bandera RDW_INVALIDATE ; de lo contrario no tiene ningún efecto RDW_ERASE.
  
  
• RDW_FRAMEnbsp;  Hace que cualquier parte del área no cliente de la ventana que cruza la región de actualización para recibir un WM_NCPAINT mensaje. También debe especificarse la bandera RDW_INVALIDATE ; de lo contrario no tiene ningún efecto RDW_FRAME.
  
  
• RDW_I&NTERNALPAINTnbsp;  Provoca un mensaje WM_PAINT se contabilice en la ventana independientemente de si la ventana contiene una región no válida.
  
  
• RDW_I&NVALIDATEnbsp;  Invalidar lpRectUpdate o prgnUpdate (sólo uno puede no ser nulo). Si ambos son NULL, se invalida la ventana completa.

  Los siguientes indicadores se utilizan para validar la ventana:

• RDW_&NOERASEnbsp;  Suprime cualquier WM_ERASEBKGND mensajes pendientes.
  
  
• RDW_&NOFRAMEnbsp;  Suprime cualquier WM_NCPAINT mensajes pendientes. Este indicador debe utilizarse con RDW_VALIDATE y normalmente se utiliza con RDW_NOCHILDREN. Esta opción debe utilizarse con cuidado, ya que podría impedir que partes de una ventana de pintar correctamente.
  
  
• RDW_&NOINTERNALPAINTnbsp;  Suprime cualquier pendiente mensajes WM_PAINT internos. Este indicador no afecta a los mensajes WM_PAINT procedentes de zonas no válidas.
  
  
• RDW_VALIDATEnbsp;  Valida lpRectUpdate o prgnUpdate (sólo uno puede no ser nulo). Si ambos son &NULL, se valida la ventana completa. Este indicador no afecta a los mensajes internos de WM_PAINT.

  Se produce el siguiente control de banderas cuando repintado. Pintura no se realiza la función de RedrawWindow , salvo uno de estos bits.

• RDW_ERASE&NOWnbsp;  Hace que las ventanas afectadas (según lo especificado por las banderas RDW_ALLCHILDREN y RDW_NOCHILDREN ) para recibir mensajes WM_NCPAINT y WM_ERASEBKGND , si es necesario, antes de la función devuelve. Se aplazan los mensajes WM_PAINT.
  
  
• RDW_UPDATE&NOWnbsp;  Hace que las ventanas afectadas (según lo especificado por las banderas RDW_ALLCHILDREN y RDW_NOCHILDREN ) para recibir mensajes WM_PAINT , WM_NCPAINTy WM_ERASEBKGND, si es necesario, antes de la función devuelve.

  De forma predeterminada, las ventanas afectadas por la función RedrawWindow dependen de si la ventana especificada tiene el estilo WS_CLIPCHILDREN . Las ventanas secundarias de WS_CLIPCHILDREN windows no se ven afectadas. Sin embargo, aquellos que no son windows WS_CLIPCHILDREN windows son recursivamente validar o invalidar hasta que encuentra una ventana WS_CLIPCHILDREN . Los siguientes indicadores de controlan que windows se ven afectados por la función RedrawWindow:

• RDW_ALLCHILDRE&Nnbsp;  Incluye ventanas secundarias, si los hubiere, en la operación de redibujado.
  
  
• RDW_&NOCHILDRENnbsp;  Excluye ventanas secundarias, si los hubiere, de la operación de redibujado.

Observaciones

Actualiza el rectángulo especificado o región en el área de cliente de la ventana determinada.

Cuando se utiliza la función de miembro de RedrawWindow para invalidar la parte de la ventana del escritorio, la ventana no recibe un mensaje WM_PAINT . Para repintar el escritorio, una aplicación debe utilizar CWnd::ValidateRgn, CWnd::InvalidateRgn, CWnd::UpdateWindow, o :: RedrawWindow

Visión General de CWnd |nbsp; Miembros de clase | Diagrama de jerarquía