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

Vedere anche

Riferimenti

Classe CWnd

Grafico della gerarchia