TextureBrush：：TextureBrush (Image，constRect&，constImageAttributes) 方法 (gdiplusbrush.h)

發行項
01/10/2024

根據影像、定義矩形和一組影像屬性，建立 TextureBrush 物件。

語法

void TextureBrush(
  [in]      Image                 *image,
  [in, ref] const Rect &          dstRect,
  [in]      const ImageAttributes *imageAttributes
);

參數

[in] image

類型：影像*

Image 物件的指標，其中包含要使用的影像位圖。

[in, ref] dstRect

類型： Rect

定義這個紋理筆刷大小以及這個紋理筆刷所要使用的影像部分的矩形參考。如果 Image 對像是從元檔建立的，筆刷會使用整個影像來調整以符合筆刷的大小。

[in] imageAttributes

類型： ImageAttributes*

選擇性。 ImageAttributes 物件的指標，其中包含影像的屬性。預設值是 NULL。

傳回值

無

備註

dstRect 矩形的寬度和高度會定義紋理筆刷的寬度和高度。紋理筆刷一律會導向 (0,0) 。矩形的左上方點、寬度和高度會指定紋理筆刷所要使用的影像部分的起點、寬度和高度。

此建構函式如何使用具有非metafile 影像的 dstRect 矩形

如果 dstRect 矩形的維度小於筆刷所根據影像的維度，則會裁剪筆刷的影像，它是影像的一部分。如果 dstRect 矩形的維度等於影像的維度，筆刷的影像與影像相同。 dstRect 矩形不得包含影像維度以外的區域。這樣做會產生無法預期的行為，或產生運行時錯誤。例如，假設您有 256 個×256 像素的影像，並根據此影像建立 TextureBrush 物件，並傳遞為 dstRect 參數。筆刷會使用影像的左下部分。這個部分的左下角也是影像的左下角。現在假設您根據相同的影像建立另一個 TextureBrush 物件，並傳遞為 dstRect 參數。請注意，此矩形的上層座標位於 157，而不是 156。這個矩形會將一個單位延伸到影像的高度之外，而且最有可能產生存取違規。

此建構函式如何使用具有元檔影像的 dstRect 矩形

如果 dstRect 矩形的維度與影像的維度不同，筆刷的影像會視需要相應縮小或更大，以符合矩形。例如，假設您有 256 個×256 像素的元檔影像，而且您建立 TextureBrush 物件，並傳遞為 dstRect 參數。筆刷的影像會包含所有元檔影像，但會縮放以符合筆刷：它會垂直和水平縮放。如果矩形的維度等於影像的維度，筆刷的影像會與影像相同。

規格需求


最低支援的用戶端	Windows XP、Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	gdiplusbrush.h (包含 Gdiplus.h)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll