Freigeben über


CWnd::InvalidateRgn

Löscht den Clientbereich innerhalb des angegebenen Bereichs durch Hinzufügen dieser zum aktuellen UpdatePanel von CWnd ungültig.

void InvalidateRgn( 
   CRgn* pRgn, 
   BOOL bErase = TRUE  
);

Parameter

  • pRgn
    Ein Zeiger auf ein Objekt, das den CRgn identifiziert das UpdatePanel hinzugefügt werden, Bereich. Der Bereich wird angenommen, dass Clientkoordinaten verfügen. Wenn dieser Parameter NULL ist, wird der gesamte Clientbereich zum UpdatePanel hinzugefügt.

  • bErase
    Gibt an, ob der Hintergrund im Updatebereich gelöscht werden soll.

Hinweise

Der ungültige Bereich, zusammen mit allen anderen Bereichen im UpdatePanel, wird zum Zeichnen markiert, wenn die WM_PAINT Meldung als Nächstes gesendet wird. Die ungültigen Bereiche Akkumulation im UpdatePanel, bis der Bereich verarbeitet ist, wenn eine WM_PAINT Meldung als Nächstes gesendet wird, oder bis der Bereich wird von der ValidateRect oder ValidateRgn-Memberfunktion überprüft.

Der bErase-Parameter gibt an, ob der Hintergrund im Updatebereich gelöscht werden soll, wenn der Aktualisierungsbereich verarbeitet wird. Wenn bEraseTRUE ist, wird der Hintergrund gelöscht, wenn die BeginPaint-Memberfunktion aufgerufen wird, wenn bEraseFALSE ist, bleibt der Hintergrund unverändert. Wenn bEraseTRUE für einen Teil des UpdatePanel befindet, wird der Hintergrund im gesamten Bereich, nicht nur im angegebenen Teil, gelöscht.

Windows WM_PAINT sendet eine Meldung, wenn der CWnd UpdatePanel nicht leer ist und keine anderen Meldungen in der Anwendungswarteschlange für dieses Fenster gibt.

Der angegebene Bereich muss durch eine der Bereichsfunktionen zuvor erstellt worden sein.

Anforderungen

Header: afxwin.h

Siehe auch

Referenz

CWnd-Klasse

Hierarchiediagramm

CWnd::BeginPaint

CWnd::ValidateRect

CWnd::ValidateRgn

InvalidateRgn

CWnd::Invalidate

CWnd::InvalidateRect