NONCLIENTMETRICSA 구조체(winuser.h)

크기가 지정되지 않은 창의 비클라이언트 영역과 연결된 확장 가능한 메트릭을 포함합니다. 이 구조체는 SystemParametersInfo 함수의 SPI_GETNONCLIENTMETRICS 및 SPI_SETNONCLIENTMETRICS 작업에서 사용됩니다.

통사론

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: 이 멤버는 지원되지 않습니다.

발언

NONCLIENTMETRICS 구조체의 iPaddedBorderWidth 멤버가 있는 경우 이 구조는 0x0502 보다 작거나 같은 _WIN32_WINNT 컴파일된 애플리케이션보다 4바이트 더 큽니다. 조건부 컴파일에 대한 자세한 내용은 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에서 실행되는 경우 SystemParametersInfo 함수를 호출하기 전에 NONCLIENTMETRICS 구조체의 cbSize 멤버에서 iPaddedBorderWidth 멤버의 크기를 뺍니다.

메모

winuser.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 NONCLIENTMETRICS를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
헤더	winuser.h(Windows.h 포함)

참고 항목

LOGFONT

systemParametersInfo