TextureBrush::TextureBrush(Image*,WrapMode,constRect&) metode (gdiplusbrush.h)

Artikel
01/10/2024

Membuat objek TextureBrush berdasarkan gambar, mode bungkus, dan persegi panjang yang menentukan.

Sintaks

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

Parameter

[in] image

Jenis: Gambar*

Penunjuk ke objek Gambar yang berisi bitmap gambar yang akan digunakan.

[in] wrapMode

Jenis: WrapMode

Elemen enumerasi WrapMode yang menentukan bagaimana salinan gambar berulang digunakan untuk memetakan area ketika dicat dengan kuas tekstur ini.

[in, ref] dstRect

Jenis: const Rect

Referensi ke persegi panjang yang mendefinisikan ukuran kuas tekstur ini dan bagian gambar yang akan digunakan oleh kuas tekstur ini. Jika objek Gambar dibuat dari metafile, kuas menggunakan seluruh gambar, yang diskalakan agar sesuai dengan ukuran kuas.

Nilai kembali

Tidak ada

Keterangan

Lebar dan tinggi kuas tekstur ditentukan oleh lebar dan tinggi persegi panjang dstRect . Kuas tekstur selalu berorientasi pada (0, 0). Titik kiri atas, lebar, dan tinggi persegi panjang menentukan titik awal, lebar, dan tinggi bagian gambar yang akan digunakan oleh kuas tekstur.

Bagaimana konstruktor ini menggunakan persegi panjang dstRect dengan gambar nonmetafile

Jika dimensi persegi panjang dstRect lebih kecil dari gambar di mana kuas didasarkan, gambar kuas dipangkas - itu adalah bagian dari gambar. Jika dimensi persegi panjang dstRect sama dengan gambar, gambar kuas identik dengan gambar. Persegi panjang dstRect tidak boleh menyertakan area di luar dimensi gambar. Melakukannya akan menghasilkan perilaku yang tidak dapat diprediksi atau menghasilkan kesalahan run-time. Misalnya, Anda memiliki gambar 256 ×256 piksel dan Anda membuat objek TextureBrush berdasarkan gambar ini, meneruskan sebagai parameter dstRect . Kuas akan menggunakan bagian kiri bawah gambar. Sudut kiri bawah bagian ini juga merupakan sudut kiri bawah gambar. Sekarang misalkan Anda membuat objek TextureBrush lain berdasarkan gambar yang sama, melewati sebagai parameter dstRect . Perhatikan bahwa persegi panjang ini memiliki koordinat paling atas pada 157, bukan 156. Persegi panjang ini memperluas satu unit di luar tinggi gambar dan kemungkinan besar akan menghasilkan pelanggaran akses.

Bagaimana konstruktor ini menggunakan persegi panjang dstRect dengan gambar metafile

Jika dimensi persegi panjang dstRect berbeda dari gambar, gambar kuas diskalakan lebih kecil atau lebih besar sesuai kebutuhan agar sesuai dengan persegi panjang. Misalnya, Anda memiliki gambar metafile yang 256 ×256 piksel dan Anda membuat objek TextureBrush , meneruskan sebagai parameter dstRect . Gambar kuas akan mencakup semua gambar metafile tetapi akan diskalakan agar pas dengan kuas: Ini akan diluaskan secara vertikal dan direntangkan secara horizontal. Jika dimensi persegi sama dengan dimensi gambar, gambar kuas identik dengan gambar.

Bagaimana konstruktor ini menggunakan mode pembungkusan

Area yang meluas di luar batas kuas diramik dengan salinan kuas berulang. Kuas tekstur mungkin memiliki petak peta alternatif yang terbalik ke arah tertentu, seperti yang ditentukan oleh mode pembungkusan. Membalik memiliki efek membalikkan gambar kuas.

Persyaratan


Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	gdiplusbrush.h (termasuk Gdiplus.h)
Pustaka	Gdiplus.lib
DLL	Gdiplus.dll