Struktur NEWTEXTMETRICA (wingdi.h)
Struktur NEWTEXTMETRIC berisi data yang menjelaskan font fisik.
Sintaks
typedef struct tagNEWTEXTMETRICA {
LONG tmHeight;
LONG tmAscent;
LONG tmDescent;
LONG tmInternalLeading;
LONG tmExternalLeading;
LONG tmAveCharWidth;
LONG tmMaxCharWidth;
LONG tmWeight;
LONG tmOverhang;
LONG tmDigitizedAspectX;
LONG tmDigitizedAspectY;
BYTE tmFirstChar;
BYTE tmLastChar;
BYTE tmDefaultChar;
BYTE tmBreakChar;
BYTE tmItalic;
BYTE tmUnderlined;
BYTE tmStruckOut;
BYTE tmPitchAndFamily;
BYTE tmCharSet;
DWORD ntmFlags;
UINT ntmSizeEM;
UINT ntmCellHeight;
UINT ntmAvgWidth;
} NEWTEXTMETRICA, *PNEWTEXTMETRICA, *NPNEWTEXTMETRICA, *LPNEWTEXTMETRICA;
Anggota
tmHeight
Tinggi (naik + turun) karakter.
tmAscent
Ascent (unit di atas garis dasar) karakter.
tmDescent
Turunan (unit di bawah garis dasar) karakter.
tmInternalLeading
Jumlah leading (spasi) di dalam batas yang ditetapkan oleh anggota tmHeight . Tanda aksen dan karakter diakritik lainnya mungkin terjadi di area ini. Perancang dapat mengatur anggota ini ke nol.
tmExternalLeading
Jumlah leading tambahan (spasi) yang ditambahkan aplikasi di antara baris. Karena area ini berada di luar font, area ini tidak berisi tanda dan tidak diubah oleh panggilan output teks dalam mode OPAQUE atau TRANSPARAN. Perancang dapat mengatur anggota ini ke nol.
tmAveCharWidth
Lebar rata-rata karakter dalam font (umumnya didefinisikan sebagai lebar huruf x). Nilai ini tidak termasuk overhang yang diperlukan untuk karakter tebal atau miring.
tmMaxCharWidth
Lebar karakter terluas dalam font.
tmWeight
Bobot font.
tmOverhang
Lebar ekstra per string yang dapat ditambahkan ke beberapa font yang disintesis. Saat mensintesis beberapa atribut, seperti tebal atau miring, antarmuka perangkat grafis (GDI) atau perangkat mungkin harus menambahkan lebar ke string berdasarkan per karakter dan per string. Misalnya, GDI membuat string tebal dengan memperluas penspasian setiap karakter dan mengambil alih oleh nilai offset; italicizes font dengan mencukur string. Dalam kedua kasus, ada overhang melewati string dasar. Untuk string tebal, overhang adalah jarak di mana overstrike diimbangi. Untuk string miring, overhang adalah jumlah bagian atas font yang dicukur melewati bagian bawah font.
Anggota tmOverhang memungkinkan aplikasi menentukan berapa banyak lebar karakter yang dikembalikan oleh panggilan fungsi GetTextExtentPoint32 pada satu karakter adalah lebar karakter aktual dan berapa lebar ekstra per string. Lebar aktual adalah sejauh dikurangi overhang.
tmDigitizedAspectX
Aspek horizontal perangkat tempat font dirancang.
tmDigitizedAspectY
Aspek vertikal perangkat tempat font dirancang. Rasio anggota tmDigitizedAspectX dan tmDigitizedAspectY adalah rasio aspek perangkat tempat font dirancang.
tmFirstChar
Nilai karakter pertama yang ditentukan dalam font.
tmLastChar
Nilai karakter terakhir yang ditentukan dalam font.
tmDefaultChar
Nilai karakter yang akan diganti dengan karakter yang tidak ada dalam font.
tmBreakChar
Nilai karakter yang akan digunakan untuk menentukan pemisah kata untuk pembenaran teks.
tmItalic
Font miring jika bukan nol.
tmUnderlined
Font bergaris bawah jika bukan nol.
tmStruckOut
Font strikeout jika bukan nol.
tmPitchAndFamily
Pitch dan keluarga font yang dipilih. Bit berurutan rendah (bit 0) menentukan nada font. Jika 1, font adalah pitch variabel (atau proporsional). Jika 0, font tetap pitch (atau monospace). Bit 1 dan 2 menentukan jenis font. Jika kedua bit adalah 0, font adalah font raster; jika bit 1 adalah 1 dan bit 2 adalah 0, font adalah font vektor; jika bit 1 adalah 0 dan bit 2 diatur, atau jika kedua bit adalah 1, font adalah beberapa jenis lain. Bit 3 adalah 1 jika font adalah font perangkat; jika tidak, itu adalah 0.
Empat bit berurutan tinggi menunjuk keluarga font. Anggota tmPitchAndFamily dapat dikombinasikan dengan nilai heksadesimal 0xF0 dengan menggunakan operator AND bitwise dan kemudian dapat dibandingkan dengan nama keluarga font untuk kecocokan yang identik. Untuk informasi selengkapnya tentang keluarga font, lihat LOGFONT.
tmCharSet
Kumpulan karakter font.
ntmFlags
Menentukan apakah font miring, garis bawah, diuraikan, tebal, dan sebagainya. Mungkin kombinasi yang wajar dari nilai berikut.
| Bit | Nama | Makna |
|---|---|---|
| 0 | NTM_ITALIC | Miring |
| 5 | NTM_BOLD | Bold |
| 8 | NTM_REGULAR | Biasa |
| 16 | NTM_NONNEGATIVE_AC | tidak ada glyph dalam font pada ukuran apa pun yang memiliki spasi A atau C negatif. |
| 17 | NTM_PS_OPENTYPE | Font PostScript OpenType |
| 18 | NTM_TT_OPENTYPE | Font TrueType OpenType |
| 19 | NTM_MULTIPLEMASTER | beberapa font master |
| 20 | NTM_TYPE1 | Font Tipe 1 |
| 21 | NTM_DSIG | font dengan tanda tangan digital. Ini memungkinkan keterlacakan dan memastikan bahwa font telah diuji dan tidak rusak |
ntmSizeEM
Ukuran persegi em untuk font. Nilai ini berada dalam unit nosional (yaitu, unit tempat font dirancang).
ntmCellHeight
Tinggi, dalam unit nosional, dari font. Nilai ini harus dibandingkan dengan nilai anggota ntmSizeEM .
ntmAvgWidth
Lebar rata-rata karakter dalam font, dalam satuan nol. Nilai ini harus dibandingkan dengan nilai anggota ntmSizeEM .
Keterangan
Empat anggota terakhir dari struktur NEWTEXTMETRIC tidak disertakan dalam struktur TEXTMETRIC ; dalam semua hal lain, strukturnya identik.
Ukuran dalam struktur NEWTEXTMETRIC biasanya ditentukan dalam unit logis; artinya, mereka bergantung pada mode pemetaan saat ini dari konteks tampilan.
Catatan
Header wingdi.h mendefinisikan NEWTEXTMETRIC sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | wingdi.h (sertakan Windows.h) |