SelectClipRgn 関数 (wingdi.h)

  • [アーティクル]

SelectClipRgn 関数は、指定したデバイス コンテキストの現在のクリッピング領域としてリージョンを選択します。

構文

int SelectClipRgn(
  [in] HDC  hdc,
  [in] HRGN hrgn
);

パラメーター

[in] hdc

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

[in] hrgn

選択するリージョンのハンドル。

戻り値

戻り値は、リージョンの複雑さを指定し、次のいずれかの値を指定できます。

リターン コード 説明
NULLREGION
 リージョンが空です。
SIMPLEREGION
 Region は 1 つの四角形です。
COMPLEXREGION
 領域は複数の四角形です。
ERROR
 エラーが発生しました。 (前のクリッピング領域は影響を受けません。

解説

選択したリージョンのコピーのみが使用されます。 リージョン自体は、他の任意の数のデバイス コンテキストに対して選択することも、削除することもできます。

SelectClipRgn 関数は、領域の座標がデバイス単位で指定されていることを前提としています。

デバイス コンテキストのクリッピング領域を削除するには、 NULL 領域ハンドルを指定します。

例

例については、「 クリッピング出力」を参照してください。

要件

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

関連項目

クリッピング関数

クリッピングの概要

ExtSelectClipRgn