ExcludeClipRect 関数 (wingdi.h)

  • [アーティクル]

ExcludeClipRect 関数は、既存のクリッピング領域から指定された四角形を引いた領域で構成される新しいクリッピング領域を作成します。

構文

int ExcludeClipRect(
  [in] HDC hdc,
  [in] int left,
  [in] int top,
  [in] int right,
  [in] int bottom
);

パラメーター

[in] hdc

デバイス コンテキストへのハンドル。

[in] left

四角形の左上隅の x 座標 (論理単位)。

[in] top

四角形の左上隅の y 座標 (論理単位)。

[in] right

四角形の右下隅の x 座標 (論理単位)。

[in] bottom

四角形の右下隅の y 座標 (論理単位)。

戻り値

戻り値は、新しいクリッピング領域の複雑さを指定します。次のいずれかの値を指定できます。

リターン コード 説明
NULLREGION
 リージョンが空です。
SIMPLEREGION
 Region は 1 つの四角形です。
COMPLEXREGION
 領域は複数の四角形です。
ERROR
 リージョンが作成されませんでした。

解説

指定した四角形の下端と右端は、クリッピング領域から除外されません。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wingdi.h (Windows.h を含む)
Library Gdi32.lib
[DLL] Gdi32.dll

関連項目

クリッピング関数

クリッピングの概要

IntersectClipRect