StretchBlt 函式 (wingdi.h)

發行項
03/09/2024

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

要執行的點陣作業。點陣作業程式代碼會定義系統如何結合輸出作業中涉及筆刷、來源位圖和目的地點陣圖的色彩。

如需一般點陣作業代碼的清單，請參閱 BitBlt (ROP) 。請注意，CAPTUREBLT ROP 通常無法用於列印裝置內容。

傳回值

如果函式成功，則傳回非零的值。

如果此函式失敗，則傳回值為零。

備註

StretchBlt 會延 展或壓縮記憶體中的來源位陣圖，然後將結果複製到目的地矩形。此點陣圖可以是相容的點陣圖 (DDB) 或 CreateDIBSection 的輸出。圖樣或目的地圖元的色彩數據會在延展或壓縮發生之後合併。

記錄增強型元檔時，如果來源裝置內容識別增強型元檔裝置內容，就會 (發生錯誤，且函式會傳回 FALSE) 。

如果指定的點陣作業需要筆刷，系統會使用目前選取的筆刷到目的地裝置內容中。

目的地座標會使用目前為目的地裝置內容指定的轉換來轉換;來源座標會使用目前為來源裝置內容指定的轉換來轉換。

如果來源轉換有旋轉或切割，就會發生錯誤。

如果目的地、來源和圖樣位圖的色彩格式不相同， StretchBlt 會轉換來源和圖樣位圖以符合目的地位圖。

如果 StretchBlt 必須將單色位圖轉換成色彩點陣圖，它會將白色位 (1) 設為背景色彩，並將黑色位 (0) 設為前景色彩。若要將色彩點陣圖轉換成單色位圖，它會將符合背景色彩的像素設定為白色 (1) ，並將所有其他圖元設定為黑色 (0) 。會使用彩色裝置內容的前景和背景色彩。

如果 nWidthSrc 和 nWidthDest 參數的符號或 nHeightSrc 和 nHeightDest 參數不同，StretchBlt 會建立位圖的鏡像影像。如果 nWidthSrc 和 nWidthDest 有不同的符號，函式會沿著 x 軸建立位圖的鏡像影像。如果 nHeightSrc 和 nHeightDest 有不同的符號，此函式會沿著 Y 軸建立位圖的鏡像影像。

並非所有裝置都支援 StretchBlt 函式。如需詳細資訊，請參閱 GetDeviceCaps。

Icm： Blit 作業發生時，不會執行任何色彩管理。

在多個監視器系統中使用時， hdcSrc 和 hdcDest 都必須參考相同的裝置，否則函式將會失敗。若要在不同裝置的 DC 之間傳輸數據，請呼叫 GetDIBits，將記憶體位圖轉換成 DIB。若要向第二個裝置顯示 DIB，請呼叫 SetDIBits 或 StretchDIBits。

範例

如需範例，請參閱調整影像。

規格需求

需求	值
最低支援的用戶端	Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限桌面應用程式]
目標平台	Windows
標頭	wingdi.h (包含 Windows.h)
程式庫	Gdi32.lib
Dll	Gdi32.dll