Bagikan melalui


Fungsi ExtTextOutWrap

[ExtTextOutWrap tersedia melalui Windows XP dengan Paket Layanan 2 (SP2). Ini mungkin diubah atau tidak tersedia dalam versi berikutnya. Sebaiknya gunakan ExtTextOut secara langsung sebagai gantinya.]

Gambar teks menggunakan font, warna latar belakang, dan warna teks yang saat ini dipilih. Anda dapat secara opsional menyediakan dimensi yang akan digunakan untuk kliping, opasitas, atau keduanya. Fungsi ini membungkus panggilan ke ExtTextOut.

Sintaks

BOOL ExtTextOutWrap(
  _In_       HDC     hdc,
  _In_       int     X,
  _In_       int     Y,
  _In_       UINT    uOptions,
  _In_ const RECT    *lprc,
  _In_       LPCTSTR lpString,
  _In_       UINT    cbCount,
  _In_ const INT     *lpDx
);

Parameter

hdc [in]

Jenis: HDC

Handel ke konteks perangkat.

X [in]

Jenis: int

Koordinat x, dalam koordinat logis, dari titik referensi yang digunakan untuk memosisikan string.

Y [in]

Jenis: int

Koordinat y, dalam koordinat logis, dari titik referensi yang digunakan untuk memosisikan string.

uOptions [in]

Jenis: UINT

Nilai yang menentukan cara menggunakan persegi panjang yang ditentukan aplikasi. Lihat ExtTextOut untuk daftar lengkap opsi.

lprc [in]

Jenis: const RECT*

Penunjuk ke struktur RECT opsional yang menentukan dimensi, dalam koordinat logis, persegi panjang yang digunakan untuk kliping, opasitas, atau keduanya.

lpString [in]

Jenis: LPCTSTR

Penunjuk ke buffer yang berisi teks yang akan digambar. String tidak perlu dihentikan nol, karena cbCount menentukan panjang string.

cbCount [in]

Jenis: UINT

Panjang string, dalam byte, ditujukkan oleh lpString.

lpDx [in]

Jenis: const INT*

Penunjuk ke array nilai opsional yang menunjukkan jarak antara asal sel karakter yang berdekatan. Misalnya, unit logis lpDx[x] memisahkan asal-usul sel karakter x dan sel karakter (x + 1).

Nilai kembali

Jenis: BOOL

Mengembalikan nilai bukan nol jika string berhasil digambar. Namun, jika versi ANSI extTextOut dipanggil dengan ETO_GLYPH_INDEX, fungsi mengembalikan TRUE meskipun fungsi tidak melakukan apa-apa.

Jika fungsi gagal, nilai yang dikembalikan adalah nol.

Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

ExtTextOutWrap tidak diekspor berdasarkan nama atau dideklarasikan dalam file header publik. Untuk menggunakannya, Anda harus menggunakan GetProcAddress dan meminta ordinal 417 dari ComCtl32.dll untuk mendapatkan penunjuk fungsi.

Untuk keterangan tambahan, silakan lihat ExtTextOut.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung
Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung
Windows Server 2003 [hanya aplikasi desktop]
DLL
Comctl32.dll (versi 6.0 atau yang lebih baru)