StretchBlt 関数 (wingdi.h)

[アーティクル]
08/27/2023

StretchBlt 関数は、コピー元の四角形からコピー先の四角形にビットマップをコピーし、必要に応じて、コピー先の四角形の寸法に合わせてビットマップを拡大または圧縮します。システムは、ターゲットデバイスコンテキストで現在設定されているストレッチモードに従って、ビットマップをストレッチまたは圧縮します。

構文

BOOL StretchBlt(
  [in] HDC   hdcDest,
  [in] int   xDest,
  [in] int   yDest,
  [in] int   wDest,
  [in] int   hDest,
  [in] HDC   hdcSrc,
  [in] int   xSrc,
  [in] int   ySrc,
  [in] int   wSrc,
  [in] int   hSrc,
  [in] DWORD rop
);

パラメーター

[in] hdcDest

ターゲットデバイスコンテキストのハンドル。

[in] xDest

コピー先の四角形の左上隅の x 座標を論理単位で指定します。

[in] yDest

コピー先の四角形の左上隅の y 座標を論理単位で指定します。

[in] wDest

ターゲットの四角形の幅 (論理単位)。

[in] hDest

ターゲットの四角形の高さ (論理単位)。

[in] hdcSrc

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

[in] xSrc

ソース四角形の左上隅の x 座標 (論理単位)。

[in] ySrc

ソース四角形の左上隅の y 座標 (論理単位)。

[in] wSrc

ソースの四角形の幅 (論理単位)。

[in] hSrc

ソースの四角形の高さ (論理単位)。

[in] rop

実行するラスター操作。ラスター演算コードは、ブラシ、ソースビットマップ、およびコピー先ビットマップを含む出力操作でシステムが色を結合する方法を定義します。

一般的なラスター演算コード (ROP) の一覧については、「 BitBlt 」を参照してください。通常、CAPTUREBLT ROP はデバイスコンテキストの印刷には使用できないことに注意してください。

戻り値

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

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

注釈

StretchBlt は、メモリ内のソースビットマップをストレッチまたは圧縮し、結果をコピー先の四角形にコピーします。このビットマップには、互換性のあるビットマップ (DDB) または CreateDIBSection からの出力のいずれかを指定できます。パターンピクセルまたはターゲットピクセルのカラーデータは、ストレッチまたは圧縮が行われる後にマージされます。

拡張メタファイルが記録されている場合、ソースデバイスコンテキストが拡張メタファイルデバイスコンテキストを識別すると、エラーが発生 (および関数は FALSE を返します)。

指定したラスター操作でブラシが必要な場合、システムは現在選択されているブラシをターゲットデバイスコンテキストに使用します。

変換先の座標は、ターゲットデバイスコンテキストに対して現在指定されている変換を使用して変換されます。ソース座標は、ソースデバイスコンテキストに対して現在指定されている変換を使用して変換されます。

ソース変換に回転またはせん断がある場合は、エラーが発生します。

変換先ビットマップ、ソースビットマップ、およびパターンビットマップの色形式が同じでない場合、 StretchBlt は変換元ビットマップとパターンビットマップを変換先ビットマップと一致させます。

StretchBlt でモノクロビットマップをカラービットマップに変換する必要がある場合は、白ビット (1) を背景色に、黒ビット (0) を前景色に設定します。カラービットマップをモノクロビットマップに変換するには、背景色に一致するピクセルを白 (1) に設定し、他のすべてのピクセルを黒 (0) に設定します。カラーのデバイスコンテキストの前景色と背景色は使用されます。

StretchBlt は、nWidthSrc パラメーターと nWidthDest パラメーターの符号が異なる場合、または nHeightSrc パラメーターと nHeightDest パラメーターが異なる場合に、ビットマップのミラーイメージを作成します。 nWidthSrc と nWidthDest の符号が異なる場合、関数は x 軸に沿ってビットマップのミラーイメージを作成します。 nHeightSrc と nHeightDest の符号が異なる場合、関数は y 軸に沿ってビットマップのミラーイメージを作成します。

すべてのデバイスで StretchBlt 関数がサポートされているわけではありません。詳細については、「 GetDeviceCaps」を参照してください。

Icm： blit 操作が発生しても、カラー管理は実行されません。

複数のモニターシステムで使用する場合、 hdcSrc と hdcDest の両方が同じデバイスを参照する必要があります。または、関数は失敗します。異なるデバイスの DC 間でデータを転送するには、 GetDIBits を呼び出してメモリビットマップを DIB に変換します。 2 番目のデバイスに DIB を表示するには、 SetDIBits または StretchDIBits を呼び出します。

例

例については、「イメージのスケーリング」を参照してください。

要件

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