GetStretchBltMode 関数 (wingdi.h)

GetStretchBltMode 関数は、現在のストレッチモードを取得します。ストレッチモードでは、 StretchBlt 関数が呼び出されたときに、ストレッチまたは圧縮されるビットマップに対してカラーデータを追加または削除する方法を定義します。

構文

int GetStretchBltMode(
  [in] HDC hdc
);

[in] hdc

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

関数が成功した場合、戻り値は現在のストレッチモードです。これには、次のいずれかの値を指定できます。

値	説明
BLACKONWHITE	削除されたピクセルと既存のピクセルの色値を使用して、ブール値 AND 演算を実行します。ビットマップがモノクロビットマップの場合、このモードでは、白いピクセルを犠牲にして黒いピクセルが保持されます。
COLORONCOLOR	ピクセルを削除します。このモードでは、削除されたすべてのピクセル行が、情報を保持せずに削除されます。
ハーフトーン	ソース四角形のピクセルを、変換先の四角形のピクセルブロックにマップします。ピクセルのターゲットブロックの平均色は、ソースピクセルの色に近似します。
STRETCH_ANDSCANS	BLACKONWHITE と同じです。
STRETCH_DELETESCANS	COLORONCOLOR と同じです。
STRETCH_HALFTONE	ハーフトーンと同じです。
STRETCH_ORSCANS	WHITEONBLACK と同じです。
WHITEONBLACK	削除されたピクセルと既存のピクセルの色値を使用して、ブール値 OR 演算を実行します。ビットマップがモノクロビットマップの場合、このモードでは黒ピクセルを犠牲にして白いピクセルが保持されます。

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

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