Struktur NEWTEXTMETRICW (wingdi.h)

Struktur NEWTEXTMETRIC berisi data yang menjelaskan font fisik.

Sintaksis

typedef struct tagNEWTEXTMETRICW {
  LONG  tmHeight;
  LONG  tmAscent;
  LONG  tmDescent;
  LONG  tmInternalLeading;
  LONG  tmExternalLeading;
  LONG  tmAveCharWidth;
  LONG  tmMaxCharWidth;
  LONG  tmWeight;
  LONG  tmOverhang;
  LONG  tmDigitizedAspectX;
  LONG  tmDigitizedAspectY;
  WCHAR tmFirstChar;
  WCHAR tmLastChar;
  WCHAR tmDefaultChar;
  WCHAR tmBreakChar;
  BYTE  tmItalic;
  BYTE  tmUnderlined;
  BYTE  tmStruckOut;
  BYTE  tmPitchAndFamily;
  BYTE  tmCharSet;
  DWORD ntmFlags;
  UINT  ntmSizeEM;
  UINT  ntmCellHeight;
  UINT  ntmAvgWidth;
} NEWTEXTMETRICW, *PNEWTEXTMETRICW, *NPNEWTEXTMETRICW, *LPNEWTEXTMETRICW;

Anggota

tmHeight

Tinggi (naik + turun) karakter.

tmAscent

Pendataan (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 tambahan leading (spasi) yang ditambahkan aplikasi di antara baris. Karena area ini berada di luar font, 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

Berat 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 menggeser string. Dalam kedua kasus, ada overhang melewati string dasar. Untuk string tebal, overhang adalah jarak di mana pengambilan berlebihan diimbangi. Untuk string miring, overhang adalah jumlah bagian atas font dicukur melewati bagian bawah font.

Anggota tmOverhang memungkinkan aplikasi menentukan berapa banyak lebar karakter yang dikembalikan oleh getTextExtentPoint32 panggilan fungsi pada satu karakter adalah lebar karakter aktual dan berapa lebar ekstra per string. Lebar aktual adalah luasnya dikurangi overhang.

tmDigitizedAspectX

Aspek horizontal perangkat tempat font dirancang.

tmDigitizedAspectY

Aspek vertikal perangkat tempat font dirancang. Rasio tmDigitizedAspectX dan tmDigitizedAspectY anggota 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 coretan jika bukan nol.

tmPitchAndFamily

Pitch dan keluarga font terpilih. Bit berurutan rendah (bit 0) menentukan nada font. Jika 1, font adalah pitch variabel (atau proporsional). Jika 0, font adalah pitch tetap (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.

ntmSizeEM

Ukuran persegi em untuk font. Nilai ini berada dalam unit nosional (yaitu, unit yang fontnya dirancang).

ntmCellHeight

Tinggi, dalam unit nosional, dari font. Nilai ini harus dibandingkan dengan nilai anggota ntmSizeEM.

ntmAvgWidth

Lebar rata-rata karakter dalam font, dalam unit nosional. Nilai ini harus dibandingkan dengan nilai anggota ntmSizeEM.

Komentar

Empat anggota terakhir struktur NEWTEXTMETRIC tidak termasuk dalam struktur TEXTMETRIC ; dalam semua hal lain, strukturnya identik.

Ukuran dalam struktur NEWTEXTMETRIC biasanya ditentukan dalam unit logis; artinya, mereka bergantung pada mode pemetaan konteks tampilan saat ini.

Persyaratan

Lihat juga

EnumFontFamilies

Font dan Teks

Font dan Gambaran Umum Teks

getTextExtentPoint32

GetTextMetrics

LOGFONT