IOleInPlaceSiteWindowless::InvalidateRgn メソッド (ocidl.h)

オブジェクトが画面上のインプレースイメージの指定された領域を無効にできるようにします。

構文

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

[in] hRGN

無効化する領域 (含まれているウィンドウのクライアント座標)。このパラメーターが NULL の場合、オブジェクトのエクステント全体が無効になります。

[in] fErase

更新領域内の背景を、領域が更新されたときに消去するかどうかを指定します。このパラメーターが TRUE の場合、背景は消去されます。このパラメーターが FALSE の場合、背景は変更されません。

このメソッドは、成功したS_OKを返します。

オブジェクトは、独自のサイト領域に含まれるピクセルのみを無効にできます。そのリージョン外の領域を無効にしようとすると、操作が行われません。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	ocidl.h