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

Membuat objek TextureBrush berdasarkan gambar, persegi panjang yang menentukan, dan sekumpulan properti gambar.

Sintaks

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

Parameter

[in] image

Jenis: Gambar*

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

[in, ref] dstRect

Jenis: 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.

[in] imageAttributes

Jenis: ImageAttributes*

Pilihan. Penunjuk ke objek ImageAttributes yang berisi properti gambar. Nilai defaultnya adalah NULL.

Nilai kembali

Tidak ada

Keterangan

Lebar dan tinggi persegi panjang dstRect menentukan lebar dan tinggi kuas tekstur. 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, meneruskan 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 pas dengan persegi panjang. Misalnya, Anda memiliki gambar metafile 256 ×256 piksel dan Anda membuat objek TextureBrush , meneruskan sebagai parameter dstRect . Gambar kuas akan mencakup semua gambar metafile tetapi akan diskalakan agar sesuai dengan kuas: Akan dilepaskan secara vertikal dan direntangkan secara horizontal. Jika dimensi persegi sama dengan dimensi gambar, gambar kuas identik dengan gambar.

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

Lihat juga

Kuas dan Bentuk Terisi

Mengisi Bentuk dengan Tekstur Gambar

Gambar

ImageAttributes

Rect

TeksturBrush