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