Sdílet prostřednictvím


CWnd::RedrawWindow

Aktualizuje určeného obdélníku nebo regionu v daném okně klientské oblasti.

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

Parametry

  • lpRectUpdate
    Odkazuje RECT struktura obsahující souřadnice obdélníku aktualizace.Tento parametr je ignorován, pokud prgnUpdate obsahuje oblast platný popisovač.

  • prgnUpdate
    Identifikuje oblasti aktualizace.Pokud oba prgnUpdate a lpRectUpdate jsou NULL, celé oblasti klienta je přidán do oblasti aktualizace.

  • flags
    K znehodnocení v okně se používají následující příznaky:

    • RDW_ERASE způsobí, že okno přijímat WM_ERASEBKGND zpráva je okno překreslit.RDW_INVALIDATE příznak musí být také určen; jinak RDW_ERASE nemá žádný vliv.

    • RDW_FRAME způsobí jakékoli části oblasti nonclient okna, která protíná oblasti aktualizace přijímat WM_NCPAINT zprávy.RDW_INVALIDATE příznak musí být také určen; jinak RDW_FRAME nemá žádný vliv.

    • RDW_INTERNALPAINT způsobí, že WM_PAINT zprávy mají být zaúčtovány do okna bez ohledu na to, zda se okno obsahuje neplatná oblast.

    • RDW_INVALIDATE Invalidate lpRectUpdate nebo prgnUpdate (může být pouze jeden NULL).Pokud jsou obě NULL, je zrušena platnost celého okna.

    Ověřit okna se používají následující příznaky:

    • RDW_NOERASE žádné nevyřízené potlačí WM_ERASEBKGND zprávy.

    • RDW_NOFRAME žádné nevyřízené potlačí WM_NCPAINT zprávy.Tento příznak musí být použit s RDW_VALIDATE a se obvykle používá s RDW_NOCHILDREN.Tato možnost by měla použít opatrně, může zabránit části okna Malování správně.

    • RDW_NOINTERNALPAINT žádné nevyřízené vnitřní potlačí WM_PAINT zprávy.Tento příznak nemá vliv na WM_PAINT zprávy vyplývající z oblasti neplatný.

    • RDW_VALIDATE Validates lpRectUpdate nebo prgnUpdate (může být pouze jeden NULL).Pokud jsou obě NULL, proběhne celé okno.Tento příznak netýká vnitřní WM_PAINT zprávy.

    Řízení příznaky po překreslení dojde.Malování není prováděné RedrawWindow funkce není určena jedna z těchto bitů.

    • RDW_ERASENOW ohrožený systém Windows (zadané RDW_ALLCHILDREN a RDW_NOCHILDREN příznaky) příjem WM_NCPAINT a WM_ERASEBKGND zprávy, v případě potřeby před vrátí.WM_PAINTzprávy jsou odloženo.

    • RDW_UPDATENOW ohrožený systém Windows (zadané RDW_ALLCHILDREN a RDW_NOCHILDREN příznaky) příjem WM_NCPAINT , WM_ERASEBKGND , a WM_PAINT zprávy, v případě potřeby před vrátí.

    Ve výchozím nastavení systému windows ovlivněny RedrawWindow funkce závisí na zda zadané okno má WS_CLIPCHILDREN styl.Podřízených oken z WS_CLIPCHILDREN windows nejsou ovlivněny.Však ty windows nejsou WS_CLIPCHILDREN windows jsou rekurzivně ověřit nebo zrušena až WS_CLIPCHILDREN je zjištěna okno.Následující příznaky ovládací prvek, který se týká systému windows RedrawWindow funkce:

    • RDW_ALLCHILDREN repainting operace v případě, obsahuje podřízených oken.

    • RDW_NOCHILDREN od repainting operace vylučuje podřízených oken.

Vrácená hodnota

Nenulová hodnota, pokud byl úspěšně; překreslování okna jinak 0.

Poznámky

Při RedrawWindow členské funkce slouží ke znehodnocení část plochy okna okno neobdrží WM_PAINT zprávy.Pokud chcete překreslit plochy, používejte aplikaci CWnd::ValidateRgn, CWnd::InvalidateRgn, CWnd::UpdateWindow, nebo RedrawWindow

Požadavky

Záhlaví: afxwin.h

Viz také

Referenční dokumentace

Třída CWnd

Graf hierarchie