SelectClipRgn 関数 (wingdi.h)
SelectClipRgn 関数は、指定したデバイス コンテキストの現在のクリッピング領域としてリージョンを選択します。
構文
int SelectClipRgn(
[in] HDC hdc,
[in] HRGN hrgn
);
パラメーター
[in] hdc
デバイス コンテキストへのハンドル。
[in] hrgn
選択するリージョンのハンドル。
戻り値
戻り値は、リージョンの複雑さを指定し、次のいずれかの値を指定できます。
| リターン コード | 説明 |
|---|---|
|
リージョンが空です。 |
|
Region は 1 つの四角形です。 |
|
領域は複数の四角形です。 |
|
エラーが発生しました。 (前のクリッピング領域は影響を受けません。 |
解説
選択したリージョンのコピーのみが使用されます。 リージョン自体は、他の任意の数のデバイス コンテキストに対して選択することも、削除することもできます。
SelectClipRgn 関数は、領域の座標がデバイス単位で指定されていることを前提としています。
デバイス コンテキストのクリッピング領域を削除するには、 NULL 領域ハンドルを指定します。
例
例については、「 クリッピング出力」を参照してください。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | wingdi.h (Windows.h を含む) |
| Library | Gdi32.lib |
| [DLL] | Gdi32.dll |