NONCLIENTMETRICSA-Struktur (winuser.h)
Enthält die skalierbaren Metriken, die dem Nichtclientbereich eines nichtminimisierten Fensters zugeordnet sind. Diese Struktur wird von den SPI_GETNONCLIENTMETRICS- und SPI_SETNONCLIENTMETRICS Aktionen 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;
Angehörige
cbSize
Die Größe der Struktur in Byte. Der Aufrufer muss dies auf sizeof(NONCLIENTMETRICS)festlegen. Informationen zur Anwendungskompatibilität finden Sie in den Hinweisen.
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 standardmäßigen horizontalen Bildlaufleiste in Pixel.
iCaptionWidth
Die Breite der Beschriftungsschaltflächen in Pixeln.
iCaptionHeight
Die Höhe der Beschriftungsschaltflächen in Pixeln.
lfCaptionFont
Eine LOGFONT- Struktur, die Informationen zur Beschriftungsschriftart enthält.
iSmCaptionWidth
Die Breite kleiner Beschriftungsschaltflächen in Pixeln.
iSmCaptionHeight
Die Höhe kleiner Beschriftungen in Pixeln.
lfSmCaptionFont
Eine LOGFONT- Struktur, die Informationen zur Schriftart für kleine Beschriftungen enthält.
iMenuWidth
Die Breite der Menüleistenschaltflächen in Pixeln.
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 Statusleisten und QuickInfos verwendet wird.
lfMessageFont
Eine LOGFONT- Struktur, die Informationen zur Schriftart enthält, die in Meldungsfeldern verwendet wird.
iPaddedBorderWidth
Die Stärke des gepolsterten Rahmens in Pixeln. Der Standardwert ist 4 Pixel. Die iPaddedBorderWidth und iBorderWidth- Mitglieder werden sowohl für fensterveränderbare als auch für nicht bearbeitbare Fenster in der Windows Aero-Desktopumgebung kombiniert. Um eine Anwendung zu kompilieren, die dieses Element verwendet, definieren Sie _WIN32_WINNT als 0x0600 oder höher. Weitere Informationen finden Sie in den Hinweisen.
Windows Server 2003 und Windows XP/2000: Dieses Mitglied wird nicht unterstützt.
Bemerkungen
Wenn das iPaddedBorderWidth Mitglied 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 und, wenn die Anwendung unter Windows Server 2003 oder Windows XP/2000 ausgeführt wird, Subtrahieren Sie die Größe des iPaddedBorderWidth Members aus dem cbSize Member der NONCLIENTMETRICS Struktur, bevor Sie die SystemParametersInfo Funktion aufrufen.
Anmerkung
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 |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Header- | winuser.h (enthalten Windows.h) |