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

  • Статья

Содержит масштабируемые метрики, связанные с неклиентной областью неминимизированного окна. Эта структура используется действиями 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 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть winuser.h (включая Windows.h)

См. также раздел

LOGFONT

SystemParametersInfo