CWnd::GetUpdateRect

Artikel
02/26/2013

Ruft die Koordinaten des kleinsten Rechtecks ab, das vollständig das UpdatePanel einschließt.

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

Parameter

lpRect
Zeigt auf CRect angewendet oder zu RECT-Struktur ein, die, die Clientkoordinaten des Updates zu empfangen wird, das das UpdatePanel einschließt.

Legen Sie diesen Parameter auf NULL fest, um zu bestimmen, ob ein UpdatePanel innerhalb CWnd vorhanden ist.Wenn lpRectNULL ist, gibt die GetUpdateRect-Memberfunktion Wert ungleich 0 zurück, wenn ein UpdatePanel und 0 vorhanden ist, wenn einer hingegen nicht.Dies bietet eine Möglichkeit, zu bestimmen, ob eine WM_PAINT Meldung von einem ungültigen Bereich resultiert.Legen Sie diesen Parameter nicht zu NULL in Windows-Version 3.0 und früher fest.
bErase
Gibt an, ob der Hintergrund im UpdatePanel gelöscht werden soll.

Rückgabewert

Gibt den Status des UpdatePanel an.Der Wert ist ungleich 0 (null), wenn der UpdatePanel nicht leer ist; 0 andernfalls.

Wenn der lpRect-Parameter zu NULL festgelegt wird, ist der Rückgabewert ungleich 0 (null), wenn ein UpdatePanel vorhanden; 0 andernfalls.

Hinweise

Wenn CWnd mit dem CS_OWNDC Format erstellt wurde und der Zuordnungsmodus nicht MM_TEXT ist, gibt die GetUpdateRect-Memberfunktion das Rechteck in logischen Koordinaten.Andernfalls gibt GetUpdateRect das Rechteck in Clientkoordinaten.Wenn kein UpdatePanel gibt, legt GetUpdateRect das Rechteck fest, um leer sein (alle Sätze von Koordinaten auf 0).

Der bErase-Parameter gibt an, ob GetUpdateRect den Hintergrund des UpdatePanel löschen sollte.Wenn bEraseTRUE ist und das UpdatePanel nicht leer ist, wird der Hintergrund gelöscht.Um den Hintergrund zu löschen, sendet GetUpdateRect die WM_ERASEBKGND Meldung.

Das Updaterechteck, das von der BeginPaint-Memberfunktion abgerufen wird, ist mit dem identisch, das von der GetUpdateRect-Memberfunktion abgerufen wird.

Die BeginPaint-Memberfunktion überprüft automatisch das UpdatePanel, sodass erzielt jeden Aufruf GetUpdateRect, sobald ein Aufruf BeginPaint einen leeren UpdatePanel abruft.