Struktur NONCLIENTMETRICSA (winuser.h)
Berisi metrik yang dapat diskalakan yang terkait dengan area nonkelola dari jendela yang tidak diminimalkan. Struktur ini digunakan oleh tindakan SPI_GETNONCLIENTMETRICS dan SPI_SETNONCLIENTMETRICS fungsi SystemParametersInfo .
Sintaks
typedef struct tagNONCLIENTMETRICSA {
UINT cbSize;
int iBorderWidth;
int iScrollWidth;
int iScrollHeight;
int iCaptionWidth;
int iCaptionHeight;
LOGFONTA lfCaptionFont;
int iSmCaptionWidth;
int iSmCaptionHeight;
LOGFONTA lfSmCaptionFont;
int iMenuWidth;
int iMenuHeight;
LOGFONTA lfMenuFont;
LOGFONTA lfStatusFont;
LOGFONTA lfMessageFont;
int iPaddedBorderWidth;
} NONCLIENTMETRICSA, *PNONCLIENTMETRICSA, *LPNONCLIENTMETRICSA;
Anggota
cbSize
Ukuran struktur, dalam byte. Penelepon harus mengatur ini ke sizeof(NONCLIENTMETRICS). Untuk informasi tentang kompatibilitas aplikasi, lihat Keterangan.
iBorderWidth
Ketebalan batas ukuran, dalam piksel. Defaultnya adalah 1 piksel.
iScrollWidth
Lebar bilah gulir vertikal standar, dalam piksel.
iScrollHeight
Tinggi bilah gulir horizontal standar, dalam piksel.
iCaptionWidth
Lebar tombol caption, dalam piksel.
iCaptionHeight
Tinggi tombol caption, dalam piksel.
lfCaptionFont
Struktur LOGFONT yang berisi informasi tentang font caption.
iSmCaptionWidth
Lebar tombol caption kecil, dalam piksel.
iSmCaptionHeight
Tinggi keterangan kecil, dalam piksel.
lfSmCaptionFont
Struktur LOGFONT yang berisi informasi tentang font caption kecil.
iMenuWidth
Lebar tombol bilah menu, dalam piksel.
iMenuHeight
Tinggi bilah menu, dalam piksel.
lfMenuFont
Struktur LOGFONT yang berisi informasi tentang font yang digunakan dalam bilah menu.
lfStatusFont
Struktur LOGFONT yang berisi informasi tentang font yang digunakan dalam bilah status dan tipsalat.
lfMessageFont
Struktur LOGFONT yang berisi informasi tentang font yang digunakan dalam kotak pesan.
iPaddedBorderWidth
Ketebalan batas berlapis, dalam piksel. Nilai defaultnya adalah 4 piksel. Anggota iPaddedBorderWidth dan iBorderWidth digabungkan untuk jendela yang dapat diubah dan tidak dapat diubah dalam pengalaman desktop Windows Aero. Untuk mengkompilasi aplikasi yang menggunakan anggota ini, tentukan _WIN32_WINNT sebagai 0x0600 atau yang lebih baru. Untuk informasi selengkapnya, lihat Keterangan.
Windows Server 2003 dan Windows XP/2000: Anggota ini tidak didukung.
Keterangan
Jika anggota iPaddedBorderWidth dari struktur NONCLIENTMETRICS ada, struktur ini 4 byte lebih besar dari untuk aplikasi yang dikompilasi dengan _WIN32_WINNT kurang dari atau sama dengan 0x0502. Untuk informasi selengkapnya tentang kompilasi bersyarah, lihat Menggunakan Header Windows.
Windows Server 2003 dan Windows XP/2000: Jika aplikasi yang dikompilasi untuk Windows Server 2008 atau Windows Vista juga harus berjalan pada Windows Server 2003 atau Windows XP/2000, gunakan fungsi GetVersionEx untuk memeriksa versi sistem operasi pada durasi dan, jika aplikasi berjalan pada Windows Server 2003 atau Windows XP/2000, kurangi ukuran anggota iPaddedBorderWidth dari anggota cbSize struktur NONCLIENTMETRICS sebelum memanggil fungsi SystemParametersInfo .
Catatan
Header winuser.h mendefinisikan NONCLIENTMETRICS 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
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Header | winuser.h (termasuk Windows.h) |