SelectClipPath 関数 (wingdi.h)

SelectClipPath 関数は、デバイスコンテキストのクリッピング領域として現在のパスを選択し、指定したモードを使用して、新しいリージョンと既存のクリッピング領域を組み合わせています。

構文

BOOL SelectClipPath(
  [in] HDC hdc,
  [in] int mode
);

[in] hdc

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

[in] mode

パスを使用する方法。このパラメーターには、次の値のいずれかを指定できます。

値	意味
RGN_AND	新しいクリッピング領域には、現在のクリッピング領域と現在のパスの交差部分 (重なり合う領域) が含まれます。
RGN_COPY	新しいクリッピング領域は現在のパスです。
Rgn_diff	新しいクリッピング領域には、現在のクリッピング領域の領域が含まれますが、現在のパスの領域は除外されます。
RGN_OR	新しいクリッピング領域には、現在のクリッピング領域と現在のパスの和集合 (結合領域) が含まれます。
RGN_XOR	新しいクリッピング領域には、現在のクリッピング領域と現在のパスの和集合が含まれますが、重複する領域はありません。

関数が成功すると、戻り値は 0 以外になります。

関数が失敗した場合は、0 を返します。

hdc パラメーターで識別されるデバイスコンテキストには、閉じたパスが含まれている必要があります。

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

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