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) |