Struktur NONCLIENTMETRICSA (winuser.h)

  • Artikel

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)

Lihat juga

LOGFONT

SystemParametersInfo