NONCLIENTMETRICSA-Struktur (winuser.h)

Enthält die skalierbaren Metriken, die dem Nichtclientbereich eines nichtminimierten Fensters zugeordnet sind. Diese Struktur wird von den aktionen SPI_GETNONCLIENTMETRICS und SPI_SETNONCLIENTMETRICS der SystemParametersInfo-Funktion verwendet.

Syntax

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;

Member

cbSize

Die Größe der Struktur in Bytes. Der Aufrufer muss dies auf sizeof(NONCLIENTMETRICS)festlegen. Informationen zur Anwendungskompatibilität finden Sie unter Hinweise.

iBorderWidth

Die Stärke des Größenrahmens in Pixeln. Der Standardwert ist 1 Pixel.

iScrollWidth

Die Breite einer standardmäßigen vertikalen Bildlaufleiste in Pixel.

iScrollHeight

Die Höhe einer horizontalen Standardlaufleiste in Pixel.

iCaptionWidth

Die Breite Untertitel Schaltflächen in Pixel.

iCaptionHeight

Die Höhe Untertitel Schaltflächen in Pixel.

lfCaptionFont

Eine LOGFONT-Struktur, die Informationen zur Untertitel Schriftart enthält.

iSmCaptionWidth

Die Breite kleiner Untertitel Schaltflächen in Pixel.

iSmCaptionHeight

Die Höhe kleiner Beschriftungen in Pixel.

lfSmCaptionFont

Eine LOGFONT-Struktur, die Informationen über die kleine Untertitel Schriftart enthält.

iMenuWidth

Die Breite von Menüleistenschaltflächen in Pixel.

iMenuHeight

Die Höhe einer Menüleiste in Pixel.

lfMenuFont

Eine LOGFONT-Struktur , die Informationen zur Schriftart enthält, die in Menüleisten verwendet wird.

lfStatusFont

Eine LOGFONT-Struktur, die Informationen zur Schriftart enthält, die in status Balken und QuickInfos verwendet wird.

lfMessageFont

Eine LOGFONT-Struktur , die Informationen zur Schriftart enthält, die in Meldungsfeldern verwendet wird.

iPaddedBorderWidth

Die Stärke des aufgefüllten Rahmens in Pixel. Der Standardwert ist 4 Pixel. Die Elemente iPaddedBorderWidth und iBorderWidth werden sowohl für fensteränderbare als auch für nicht anpassbare Fenster in der Windows Aero-Desktopoberfläche kombiniert. Um eine Anwendung zu kompilieren, die diesen Member verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher. Weitere Informationen finden Sie in den Hinweisen.

Windows Server 2003 und Windows XP/2000: Dieser Member wird nicht unterstützt.

Hinweise

Wenn das iPaddedBorderWidth-Element der NONCLIENTMETRICS-Struktur vorhanden ist, ist diese Struktur 4 Byte größer als für eine Anwendung, die mit _WIN32_WINNT kleiner oder gleich 0x0502 kompiliert wird. Weitere Informationen zur bedingten Kompilierung finden Sie unter Verwenden der Windows-Header.

Windows Server 2003 und Windows XP/2000: Wenn eine Für Windows Server 2008 oder Windows Vista kompilierte Anwendung auch unter Windows Server 2003 oder Windows XP/2000 ausgeführt werden muss, Verwenden Sie die GetVersionEx-Funktion , um die Betriebssystemversion zur Laufzeit zu überprüfen. Wenn die Anwendung unter Windows Server 2003 oder Windows XP/2000 ausgeführt wird, subtrahieren Sie die Größe des iPaddedBorderWidth-Elements vom cbSize-Member der NONCLIENTMETRICS-Struktur , bevor Sie die SystemParametersInfo-Funktion aufrufen.

Hinweis

Der winuser.h-Header definiert NONCLIENTMETRICS als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Kopfzeile	winuser.h (windows.h einschließen)

Weitere Informationen

LOGFONT

SystemParametersInfo