CDC::SelectClipRgn
デバイス コンテキストの現在のクリップ領域として特定の領域を選択します。
int SelectClipRgn(
CRgn* pRgn
);
int SelectClipRgn(
CRgn* pRgn,
int nMode
);
パラメーター
pRgn
選択する区分を識別します。この関数の一つ目のバージョンでは、この値が null場合は、クライアント領域全体が選択され、出力は、ウィンドウに表示されます。
この関数の 2 番目のバージョンでは、このハンドルは RGN_COPY モードを指定した場合にのみ null です。
nMode
実行する操作を指定します。次の値の場合があります: 1RGN_AND は、新しいクリップ領域 pRgnによって識別される現在のクリップ領域と地域の領域を結合します。
RGN_COPY は、新しいクリップ領域 pRgnによって識別される領域のコピーです。これは、機能です SelectClipRgnの最初のバージョンと同じものです。pRgn によって識別される領域が null場合は、新しいクリッピング領域は既定のクリッピング領域 (null の領域) になります。
RGN_DIFF は pRgnによって識別される領域から除外これらの領域と新しいクリップ領域現在のクリップ領域を結合します。
RGN_OR は、新しいクリップ領域 pRgnによって識別される現在のクリップ領域と領域を結合します。
RGN_XOR は、新しいクリップ領域 pRgn によって識別される現在のクリップ領域と領域を結合しますが、複製の領域は含まれません。
戻り値
領域の種類。これは、の値です:
COMPLEXREGION の新しいクリップ領域に境界線が重複することがあります。
[エラー] のデバイス コンテキストまたは領域が無効です。
NULLREGION の新しいクリップ領域は空です。
SIMPLEREGION の新しいクリップ領域の境界線に重複はありません。
解説
選択した領域のコピーだけ使用されます。サーフェイス自体は、他のデバイス コンテキストの任意に選択するか、削除できます。
関数は、特定の領域での座標がデバイス単位で指定されていると仮定しています。精度を保持するために出力するグラフィックスより高解像度のプリンター デバイスのサポートのテキスト出力はテキストのメトリックを表現する必要がありました。これらのデバイスにはテキスト単位の高解像度のデバイス単位を、つまり、報告します。これらのデバイスには 1 種類のグラフィカルな単位にのみ、グラフィックスの座標をように、複数の報告されたデバイス単位のマップ スケーリングします。テキスト単位を使用して SelectClipRgn 関数を必ずを呼び出す必要があります。
GDI のグラフィックス オブジェクトのスケーリングを払う必要があるアプリケーションはスケール ファクターを決定するために GETSCALINGFACTOR のプリンターのエスケープを使用できます。このスケール ファクターはクリッピングに影響します。グラフィックスをクリップする領域を使用している場合は、GDI スケール ファクターによって座標を分割します。テキストをクリップする領域を使用している場合は、GDI スケーリングの調整されません。1 スケール ファクターは座標を 2 で割った; 2 種類の原因のスケール ファクター 4 で割った座標; します。
必要条件
ヘッダー: afxwin.h