CWnd::RedrawWindow
Aggiorna il rettangolo o area specificato nell'area client della finestra specificata.
BOOL RedrawWindow(
LPCRECT lpRectUpdate = NULL,
CRgn* prgnUpdate = NULL,
UINT flags = RDW_INVALIDATE | RDW_UPDATENOW | RDW_ERASE
);
Parametri
lpRectUpdate
I punti su RECT struttura contenente le coordinate del rettangolo di aggiornamento.Questo parametro viene ignorato se il prgnUpdate contiene un handle valido dell'area.prgnUpdate
Identifica la regione di aggiornamento.Quando il prgnUpdate che lpRectUpdate sono NULL, l'intera area client verrà aggiunto all'area di aggiornamento.flags
I seguenti flag utilizzati per invalidare la finestra:RDW_ERASE modo la finestra a ricevere un messaggio WM_ERASEBKGND quando la finestra viene aggiornata.Il flag RDW_INVALIDATE deve essere specificato; in caso contrario RDW_ERASE non ha effetto.
RDW_FRAME causa una parte dell'area non client della finestra che interseca la regione di aggiornamento per ricevere un messaggio WM_NCPAINT.Il flag RDW_INVALIDATE deve essere specificato; in caso contrario RDW_FRAME non ha effetto.
RDW_INTERNALPAINT genera un messaggio WM_PAINT a essere inserito nella finestra indipendentemente dalla finestra contiene un'area non valida.
RDW_INVALIDATE invalida lpRectUpdate o il prgnUpdate (solo uno può non essere NULL).Se entrambi sono NULL, l'intera finestra viene invalidata.
I seguenti flag utilizzati per convalidare la finestra:
RDW_NOERASE elimina tutti i messaggi in corso WM_ERASEBKGND.
RDW_NOFRAME elimina tutti i messaggi in corso WM_NCPAINT.Questo flag deve essere utilizzato con RDW_VALIDATE e viene utilizzato in genere con RDW_NOCHILDREN.Questa opzione deve essere utilizzata con cautela, poiché potrebbe ostacolarne le parti di una finestra da disegno correttamente.
RDW_NOINTERNALPAINT elimina tutti i messaggi interni in corso WM_PAINT.Questo flag non influisce sui messaggi WM_PAINT derivazione dalle aree non valide.
RDW_VALIDATE convalida lpRectUpdate o il prgnUpdate (solo uno può non essere NULL).Se entrambi sono NULL, l'intera finestra viene convalidata.Questo flag non influisce sui messaggi interno WM_PAINT.
I seguenti flag determinano quando l'aggiornamento si verifica.La visualizzazione non viene eseguita dalla funzione RedrawWindow a meno che uno di questi bit sia specificato.
RDW_ERASENOW delle finestre interessate (come specificato dai flag RDW_NOCHILDREN e RDW_ALLCHILDREN ) a ricevere WM_NCPAINT e messaggi WM_ERASEBKGND se necessario, prima che la funzione.i messaggi diWM_PAINT vengono rinviati.
RDW_UPDATENOW delle finestre interessate (come specificato dai flag RDW_NOCHILDREN e RDW_ALLCHILDREN ) a ricevere WM_NCPAINT, WM_ERASEBKGNDe messaggi WM_PAINT se necessario, prima della funzione.
Per impostazione predefinita, le finestre interessate dalla funzione RedrawWindow varia se la finestra specificata ha lo stile WS_CLIPCHILDREN.Le finestre figlio delle finestre WS_CLIPCHILDREN non sono interessate.Tuttavia, le finestre non sono finestre WS_CLIPCHILDREN in modo ricorsivo vengono convalidate o invalidate fino al raggiungimento di una finestra WS_CLIPCHILDREN.Il seguente controllo di flag che le finestre sono interessate dalla funzione RedrawWindow :
RDW_ALLCHILDREN include le finestre figlio, se presente, nell'operazione di aggiornamento.
RDW_NOCHILDREN esclude le finestre figlio, se presente, dall'operazione di aggiornamento.
Valore restituito
Diverso da zero se la finestra è ridisegnasse correttamente; in caso contrario 0.
Note
Quando la funzione membro RedrawWindow viene utilizzata per invalidare parte della finestra del desktop, tale finestra non riceve un messaggio WM_PAINT.Per aggiornare il desktop, un'applicazione deve utilizzare CWnd::ValidateRgn, CWnd::InvalidateRgn, CWnd::UpdateWindow, o RedrawWindow
Requisiti
Header: afxwin.h