CWnd::GetUpdateRect

Recupera le coordinate di più piccolo rettangolo con racchiudere la regione di aggiornamento.

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

Parametri

  • lpRect
    Punta a CRect oggetto o struttura RECT che prevede di ricevere le coordinate del client di aggiornamento che include la regione di aggiornamento.

    Impostare questo parametro su NULL per determinare se un'area di aggiornamento esiste in CWnd.Se lpRect è NULL, la funzione membro GetUpdateRect restituisce diverso da zero se un'area di aggiornamento esiste e 0 se una contrario.Ciò consente di determinare se un messaggio WM_PAINT è derivato da un'area non valida.Non impostare questo parametro su NULL nelle versioni di Windows 3,0 e precedenti.

  • bErase
    Specifica se lo sfondo nell'area di aggiornamento devono essere eliminati.

Valore restituito

Specifica lo stato dell'area di aggiornamento.Il valore è diverso da zero se la regione di aggiornamento non è vuota; in caso contrario 0.

Se il parametro lpRect è impostato su NULL, il valore restituito è diverso da zero se un'area di aggiornamento esiste; in caso contrario 0.

Note

Se CWnd è stato creato con lo stile CS_OWNDC e la modalità di mapping non è MM_TEXT, la funzione membro GetUpdateRect fornisce il rettangolo in coordinate logiche.In caso contrario, GetUpdateRect fornisce il rettangolo nelle coordinate del client.Se non esiste una regione di aggiornamento, GetUpdateRect imposta il rettangolo è vuoto (set tutte le coordinate a 0).

Il parametro bErase specifica se GetUpdateRect necessario cancellare i precedenti della regione di aggiornamento.Se bErase è TRUE e la regione di aggiornamento non è vuota, i precedenti vengono cancellati.Per cancellare i precedenti, GetUpdateRect invia il messaggio WM_ERASEBKGND.

Il rettangolo di aggiornamento recuperato dalla funzione membro BeginPaint è identico a quello recuperato dalla funzione membro GetUpdateRect.

La funzione membro BeginPaint convalida automaticamente la regione di aggiornamento, in modo da qualsiasi chiamata a GetUpdateRect ha eseguito immediatamente dopo una chiamata a BeginPaint recupera un'area vuota di aggiornamento.

Requisiti

Header: afxwin.h

Vedere anche

Riferimenti

Classe CWnd

Grafico della gerarchia

CWnd::BeginPaint

GetUpdateRect

CWnd::OnPaint

CWnd::RedrawWindow