Freigeben über


NONCLIENTMETRICSW-Struktur (winuser.h)

Enthält die skalierbaren Metriken, die dem nichtclientfreien Bereich eines nichtminimierten Fensters zugeordnet sind. Diese Struktur wird vom SPI_GETNONCLIENTMETRICS und SPI_SETNONCLIENTMETRICS Aktionen der SystemParametersInfo-Funktion verwendet.

Syntax

typedef struct tagNONCLIENTMETRICSW {
  UINT     cbSize;
  int      iBorderWidth;
  int      iScrollWidth;
  int      iScrollHeight;
  int      iCaptionWidth;
  int      iCaptionHeight;
  LOGFONTW lfCaptionFont;
  int      iSmCaptionWidth;
  int      iSmCaptionHeight;
  LOGFONTW lfSmCaptionFont;
  int      iMenuWidth;
  int      iMenuHeight;
  LOGFONTW lfMenuFont;
  LOGFONTW lfStatusFont;
  LOGFONTW lfMessageFont;
  int      iPaddedBorderWidth;
} NONCLIENTMETRICSW, *PNONCLIENTMETRICSW, *LPNONCLIENTMETRICSW;

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 Dicke des Größenrahmens in Pixel. Der Standardwert ist 1 Pixel.

iScrollWidth

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

iScrollHeight

Die Höhe einer horizontalen Standardlaufleiste in Pixel.

iCaptionWidth

Die Breite Untertitel Schaltflächen in Pixel.

iCaptionHeight

Die Höhe der 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 Untertitel in Pixel.

lfSmCaptionFont

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

iMenuWidth

Die Breite der 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 Dicke des gepolsterten Rahmens in Pixel. Der Standardwert ist 4 Pixel. Die Mitglieder iPaddedBorderWidth und iBorderWidth werden sowohl für veränderbare als auch für nicht anpassbare Fenster in der Windows Aero-Desktopoberfläche kombiniert. Um eine Anwendung zu kompilieren, die dieses 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-Members vom cbSize-Member der NONCLIENTMETRICS-Struktur , bevor Sie die SystemParametersInfo-Funktion aufrufen.

Hinweis

Der winuser.h-Header definiert NONCLIENTMETRICS als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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 (einschließlich Windows.h)

Weitere Informationen

LOGFONT

SystemParametersInfo