Структура NONCLIENTMETRICSA (winuser.h)

Статья
11/20/2024

Содержит масштабируемые метрики, связанные с неклиентной областью неминимированного окна. Эта структура используется действиями SPI_GETNONCLIENTMETRICS и SPI_SETNONCLIENTMETRICS функции SystemParametersInfo.

Синтаксис

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;

Члены

cbSize

Размер структуры в байтах. Вызывающий объект должен задать значение sizeof(NONCLIENTMETRICS). Сведения о совместимости приложений см. в примечаниях.

iBorderWidth

Толщина границы размера в пикселях. Значение по умолчанию — 1 пиксель.

iScrollWidth

Ширина стандартной вертикальной полосы прокрутки в пикселях.

iScrollHeight

Высота стандартной горизонтальной полосы прокрутки в пикселях.

iCaptionWidth

Ширина кнопок заголовка в пикселях.

iCaptionHeight

Высота кнопок заголовка в пикселях.

lfCaptionFont

Структура LOGFONT, содержащая сведения о шрифте заголовка.

iSmCaptionWidth

Ширина небольших кнопок заголовка в пикселях.

iSmCaptionHeight

Высота небольших подписей в пикселях.

lfSmCaptionFont

Структура logFONT , содержащая сведения о шрифте небольшого заголовка.

iMenuWidth

Ширина кнопок панели меню в пикселях.

iMenuHeight

Высота строки меню в пикселях.

lfMenuFont

Структура LOGFONT , содержащая сведения о шрифте, используемом в строках меню.

lfStatusFont

Структура LOGFONT , содержащая сведения о шрифте, используемом в строках состояния и подсказках.

lfMessageFont

Структура LOGFONT, содержащая сведения о шрифте, используемом в полях сообщений.

iPaddedBorderWidth

Толщина заполненной границы в пикселях. Значение по умолчанию — 4 пикселя. Элементы iPaddedBorderWidth и iBorderWidth объединяются как для изменения размера, так и для неотрезизуемых окон в классическом интерфейсе Windows Aero. Чтобы скомпилировать приложение, использующее этот элемент, определите _WIN32_WINNT как 0x0600 или более поздней версии. Дополнительные сведения см. в разделе "Примечания".

Windows Server 2003 и Windows XP/2000: этот член не поддерживается.

Замечания

Если элемент iPaddedBorderWidth структуры NONCLIENTMETRICS присутствует, эта структура превышает 4 байта, чем для приложения, скомпилированного с _WIN32_WINNT меньше или равно 0x0502. Дополнительные сведения об условной компиляции см. в разделе Использование заголовков Windows.

Windows Server 2003 и Windows XP/2000: Если приложение, скомпилированное для Windows Server 2008 или Windows Vista, также должно работать в Windows Server 2003 или Windows XP/2000, используйте функцию GetVersionEx для проверки версии операционной системы во время выполнения и, если приложение работает в Windows Server 2003 или Windows XP/2000, Вычитает размер элемента iPaddedBorderWidth из элемента cbSize структуры nonCLIENTMETRICS перед вызов ом функции SystemParametersInfo.

Заметка

Заголовок winuser.h определяет NONCLIENTMETRICS как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	winuser.h (включая Windows.h)

См. также

LOGFONT

SystemParametersInfo

Поделиться через