IOleInPlaceSiteWindowless::InvalidateRgn-Methode (ocidl.h)

Ermöglicht einem Objekt, einen bestimmten Bereich seines direkten Bildes auf dem Bildschirm ungültig zu machen.

Syntax

HRESULT InvalidateRgn(
  [in] HRGN hRGN,
  [in] BOOL fErase
);

Parameter

[in] hRGN

Die Region, die ungültig werden soll, in Clientkoordinaten des enthaltenden Fensters. Wenn dieser Parameter NULL ist, wird die vollständige Ausdehnung des Objekts ungültig.

[in] fErase

Gibt an, ob der Hintergrund innerhalb der Updateregion gelöscht werden soll, wenn die Region aktualisiert wird. Wenn dieser Parameter TRUE ist, wird der Hintergrund gelöscht. Wenn dieser Parameter FALSE ist, bleibt der Hintergrund unverändert.

Rückgabewert

Diese Methode gibt S_OK bei Erfolg zurück.

Hinweise

Ein Objekt darf nur Pixel ungültig machen, die in seiner eigenen Websiteregion enthalten sind. Jeder Versuch, einen Bereich außerhalb dieser Region zu ungültig zu machen, sollte zu einem No-Op führen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows 2000 Server [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile ocidl.h

Weitere Informationen

IOleInPlaceSiteWindowless