Freigeben über


SystemParametersInfoA-Funktion (winuser.h)

Wichtig

Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe erheblich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Ruft den Wert eines der systemweiten Parameter ab oder legt den Wert fest. Diese Funktion kann auch das Benutzerprofil beim Festlegen eines Parameters aktualisieren.

Syntax

BOOL SystemParametersInfoA(
  [in]      UINT  uiAction,
  [in]      UINT  uiParam,
  [in, out] PVOID pvParam,
  [in]      UINT  fWinIni
);

Parameter

[in] uiAction

Typ: UINT

Der systemweite Parameter, der abgerufen oder festgelegt werden soll. Die möglichen Werte sind in den folgenden Tabellen verwandter Parameter organisiert:

  • Barrierefreiheitsparameter
  • Desktopparameter
  • Symbolparameter
  • Eingabeparameter
  • Menüparameter
  • Leistungsparameter
  • Bildschirmschonerparameter
  • Timeoutparameter
  • Ui-Effektparameter
  • Fensterparameter

Im Folgenden sind die Barrierefreiheitsparameter aufgeführt.

Barrierefreiheitsparameter Bedeutung
SPI_GETACCESSTIMEOUT
0x003C
Ruft Informationen zum Timeoutzeitraum ab, der den Barrierefreiheitsfeatures zugeordnet ist. Der pvParam-Parameter muss auf eine ACCESSTIMEOUT-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(ACCESSTIMEOUT).
SPI_GETAUDIODESCRIPTION
0x0074
Bestimmt, ob Audiobeschreibungen aktiviert oder deaktiviert sind. Der parameter pvParam ist ein Zeiger auf eine AUDIODESCRIPTION-Struktur . Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(AUDIODESCRIPTION).

Während es für Benutzer mit Sehbehinderungen möglich ist, das Audio in Videoinhalten zu hören, gibt es eine Menge Action im Video, das nicht über entsprechende Audiodaten verfügt. Eine spezifische Audiobeschreibung des Geschehens in einem Video hilft diesen Benutzern, den Inhalt besser zu verstehen. Mit diesem Flag können Sie bestimmen, ob Und in welcher Sprache Audiobeschreibungen aktiviert wurden.

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

SPI_GETCLIENTAREAANIMATION
0x1042
Bestimmt, ob Animationen aktiviert oder deaktiviert sind. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn Animationen aktiviert sind, oder andernfalls FALSE .

Anzeigefunktionen wie Blinken, Blinken, Flackern und Bewegen von Inhalten können bei Benutzern mit fotosensitiver Epilepsie zu Anfällen führen. Mit diesem Flag können Sie ermitteln, ob solche Animationen im Clientbereich deaktiviert wurden.

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

SPI_GETDISABLEOVERLAPPEDCONTENT
0x1040
Bestimmt, ob überlappende Inhalte aktiviert oder deaktiviert sind. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die true empfängt, falls aktiviert, oder FALSE andernfalls FALSE .

Anzeigefeatures wie Hintergrundbilder, strukturierte Hintergründe, Wasserzeichen auf Dokumenten, Alpha-Blending und Transparenz können den Kontrast zwischen Vordergrund und Hintergrund verringern, sodass es für Benutzer mit Sehbeschwerden schwieriger ist, Objekte auf dem Bildschirm zu sehen. Mit diesem Flag können Sie ermitteln, ob solche überlappenden Inhalte deaktiviert wurden.

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

SPI_GETFILTERKEYS
0x0032
Ruft Informationen zum Feature für die Barrierefreiheit von FilterKeys ab. Der parameter pvParam muss auf eine FILTERKEYS-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(FILTERKEYS).
SPI_GETFOCUSBORDERHEIGHT
0x2010
Ruft die Höhe des oberen und unteren Rands des mit DrawFocusRect gezeichneten Fokusrechtecks in Pixel ab. Der pvParam-Parameter muss auf einen UINT-Wert verweisen.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETFOCUSBORDERWIDTH
0x200E
Ruft die Breite des linken und rechten Rands des mit DrawFocusRect gezeichneten Fokusrechtecks in Pixel ab. Der parameter pvParam muss auf einen UINT verweisen.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETHIGHCONTRAST
0x0042
Ruft Informationen zur HighContrast-Barrierefreiheitsfunktion ab. Der pvParam-Parameter muss auf eine HIGHCONTRAST-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(HIGHCONTRAST).

Eine allgemeine Diskussion finden Sie unter Hinweise.

SPI_GETLOGICALDPIOVERRIDE
0x009E
Ruft einen Wert ab, der bestimmt, ob Windows 8 Apps mit dem Standardskalierungsplateau für die Hardware anzeigt oder zum nächsthöheren Plateau wechselt. Dieser Wert basiert auf der aktuellen Einstellung "Alles auf dem Bildschirm vergrößern", die sich im Abschnitt Erleichterte Bedienung der PC-Einstellungen befindet: 1 ist aktiviert, 0 ist deaktiviert.

Apps können Text- und Bildressourcen für jedes der verschiedenen Skalierungsplateaus bereitstellen: 100 %, 140 % und 180 %. Durch die Bereitstellung separater Ressourcen, die für eine bestimmte Skalierung optimiert sind, werden Verzerrungen durch Größenänderungen vermieden. Windows 8 bestimmt das geeignete Skalierungsplateau basierend auf einer Reihe von Faktoren, einschließlich Bildschirmgröße und Pixeldichte. Wenn "Alles auf dem Bildschirm vergrößern" ausgewählt ist (SPI_GETLOGICALDPIOVERRIDE den Wert 1 zurückgibt), verwendet Windows Ressourcen aus dem nächsthöheren Plateau. Im Fall von Hardware, die von Windows bestimmt wird, dass sie eine Skalierung von SCALE_100_PERCENT verwenden soll, führt diese Außerkraftsetzung dazu, dass Windows den SCALE_140_PERCENT Skalierungswert verwendet, vorausgesetzt, dies verstößt nicht gegen andere Einschränkungen.

Hinweis Sie sollten diesen Wert nicht verwenden. In nachfolgenden Versionen von Windows ist sie möglicherweise geändert oder nicht verfügbar. Verwenden Sie stattdessen die GetScaleFactorForDevice-Funktion oder die DisplayProperties-Klasse , um den bevorzugten Skalierungsfaktor abzurufen. Desktopanwendungen sollten logische DPI-Werte für den Desktop anstelle des Skalierungsfaktors verwenden. Logische DESKTOP-DPI-Werte können über die GetDeviceCaps-Funktion abgerufen werden.
 
SPI_GETMESSAGEDURATION
0x2016
Ruft die Uhrzeit ab, zu der Benachrichtigungs-Popups in Sekunden angezeigt werden sollen. Der pvParam-Parameter muss auf eine ULONG verweisen, die die Nachrichtendauer empfängt.

Benutzer mit Sehbehinderungen oder kognitiven Erkrankungen wie ADHS und Legasthenie benötigen möglicherweise eine längere Zeit, um den Text in Benachrichtigungsnachrichten zu lesen. Mit diesem Flag können Sie die Nachrichtendauer abrufen.

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

SPI_GETMOUSECLICKLOCK
0x101E
Ruft den Status des Mouse ClickLock-Features ab. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die bei Aktivierung TRUE oder andernfalls FALSE empfängt . Weitere Informationen finden Sie unter Übersicht über Mauseingaben.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETMOUSECLICKLOCKTIME
0x2008
Ruft die Zeitverzögerung ab, bevor die primäre Maustaste gesperrt wird. Der parameter pvParam muss auf DWORD verweisen, das die Zeitverzögerung in Millisekunden empfängt. Dies ist nur aktiviert, wenn SPI_SETMOUSECLICKLOCK auf TRUE festgelegt ist. Weitere Informationen finden Sie unter Übersicht über Mauseingaben.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETMOUSEKEYS
0x0036
Ruft Informationen zur Barrierefreiheitsfunktion "MouseKeys" ab. Der parameter pvParam muss auf eine MOUSEKEYS-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(MOUSEKEYS).
SPI_GETMOUSESONAR
0x101C
Ruft den Status des Maus-Sonar-Features ab. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn sie aktiviert ist, oder andernfalls FALSE . Weitere Informationen finden Sie unter Übersicht über Mauseingaben.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETMOUSEVANISH
0x1020
Ruft den Status des Maus-Vanish-Features ab. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn sie aktiviert ist, oder andernfalls FALSE . Weitere Informationen finden Sie unter Übersicht über Mauseingaben.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETSCREENREADER
0x0046
Bestimmt, ob ein Bildschirmprüfer-Hilfsprogramm ausgeführt wird. Ein Bildschirmprüfer-Hilfsprogramm leitet Textinformationen an ein Ausgabegerät weiter, z. B. an einen Sprachsynthesizer oder eine Braille-Anzeige. Wenn dieses Flag festgelegt ist, sollte eine Anwendung Textinformationen in Situationen bereitstellen, in denen sie die Informationen andernfalls grafisch darstellen würde.

Der parameter pvParam ist ein Zeiger auf eine BOOL-Variable , die TRUE empfängt, wenn ein Bildschirmprüfer-Hilfsprogramm ausgeführt wird, oder andernfalls FALSE .

Hinweis Die Sprachausgabe, die in Windows enthaltene Sprachausgabe, legt die flags SPI_SETSCREENREADER oder SPI_GETSCREENREADER nicht fest.
 
SPI_GETSERIALKEYS
0x003E
Dieser Parameter wird nicht unterstützt.

Windows Server 2003 und Windows XP/2000: Der Benutzer sollte diese Einstellung über die Systemsteuerung steuern.

SPI_GETSHOWSOUNDS
0x0038
Bestimmt, ob das Barrierefreiheitsflag "Sounds anzeigen" aktiviert oder deaktiviert ist. Wenn sie aktiviert ist, benötigt der Benutzer eine Anwendung, um Informationen visuell in Situationen darzustellen, in denen sie die Informationen andernfalls nur in hörbarer Form darstellen würde. Der parameter pvParam muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn das Feature aktiviert ist, oder FALSE , wenn es deaktiviert ist.

Die Verwendung dieses Werts entspricht dem Aufrufen von GetSystemMetrics mit SM_SHOWSOUNDS. Dies ist der empfohlene Anruf.

SPI_GETSOUNDSENTRY
0x0040
Ruft Informationen zum Barrierefreiheitsfeature von SoundSentry ab. Der parameter pvParam muss auf eine SOUNDSENTRY-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(SOUNDSENTRY).
SPI_GETSTICKYKEYS
0x003A
Ruft Informationen zur StickyKeys-Barrierefreiheitsfunktion ab. Der parameter pvParam muss auf eine STICKYKEYS-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(STICKYKEYS).
SPI_GETTOGGLEKEYS
0x0034
Ruft Informationen zur Barrierefreiheitsfunktion ToggleKeys ab. Der parameter pvParam muss auf eine TOGGLEKEYS-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(TOGGLEKEYS).
SPI_SETACCESSTIMEOUT
0x003D
Legt den Timeoutzeitraum fest, der den Barrierefreiheitsfeatures zugeordnet ist. Der parameter pvParam muss auf eine ACCESSTIMEOUT-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(ACCESSTIMEOUT).
SPI_SETAUDIODESCRIPTION
0x0075
Aktiviert oder deaktiviert das Feature "Audiobeschreibungen". Der parameter pvParam ist ein Zeiger auf eine AUDIODESCRIPTION-Struktur .

Während es für Benutzer mit Sehbehinderung möglich ist, die Audiodaten in Videoinhalten zu hören, gibt es viele Aktionen in Videos, die nicht über entsprechende Audiodaten verfügen. Eine spezifische Audiobeschreibung, was in einem Video geschieht, hilft diesen Benutzern, den Inhalt besser zu verstehen. Mit diesem Flag können Sie Audiobeschreibungen in den Sprachen aktivieren oder deaktivieren, in denen sie bereitgestellt werden.

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

SPI_SETCLIENTAREAANIMATION
0x1043
Aktiviert oder deaktiviert Clientbereichanimationen. Der parameter pvParam ist eine BOOL-Variable . Legen Sie pvParam auf TRUE fest, um Animationen und andere vorübergehende Effekte im Clientbereich zu aktivieren, oder auf FALSE , um sie zu deaktivieren.

Anzeigefunktionen wie Blinken, Blinken, Flackern und Bewegen von Inhalten können bei Benutzern mit fotoempfindlicher Epilepsie zu Anfällen führen. Mit diesem Flag können Sie alle animationen aktivieren oder deaktivieren.

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

SPI_SETDISABLEOVERLAPPEDCONTENT
0x1041
Schaltet überlappende Inhalte (z. B. Hintergrundbilder und Wasserzeichen) ein oder aus. Der parameter pvParam ist eine BOOL-Variable . Legen Sie pvParam auf TRUE fest, um überlappende Inhalte zu deaktivieren, oder AUF FALSE , um überlappende Inhalte zu aktivieren.

Anzeigefeatures wie Hintergrundbilder, texturierte Hintergründe, Wasserzeichen auf Dokumenten, Alphamischung und Transparenz können den Kontrast zwischen Vordergrund und Hintergrund verringern, sodass Es für Benutzer mit sehbeschwächerem Sehen schwieriger wird, Objekte auf dem Bildschirm zu sehen. Mit diesem Flag können Sie alle überlappenden Inhalte aktivieren oder deaktivieren.

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

SPI_SETFILTERKEYS
0x0033
Legt die Parameter der FilterKeys-Barrierefreiheitsfunktion fest. Der parameter pvParam muss auf eine FILTERKEYS-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(FILTERKEYS).
SPI_SETFOCUSBORDERHEIGHT
0x2011
Legt die Höhe des oberen und unteren Rands des mit DrawFocusRect gezeichneten Fokusrechtecks auf den Wert des pvParam-Parameters fest.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETFOCUSBORDERWIDTH
0x200F
Legt die Höhe des linken und rechten Rands des mit DrawFocusRect gezeichneten Fokusrechtecks auf den Wert des parameters pvParam fest.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETHIGHCONTRAST
0x0043
Legt die Parameter der HighContrast-Barrierefreiheitsfunktion fest. Der pvParam-Parameter muss auf eine HIGHCONTRAST-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(HIGHCONTRAST).
SPI_SETLOGICALDPIOVERRIDE
0x009F
Nicht verwenden.
SPI_SETMESSAGEDURATION
0x2017
Legt die Uhrzeit fest, zu der Benachrichtigungs-Popups in Sekunden angezeigt werden sollen. Der parameter pvParam gibt die Nachrichtendauer an.

Benutzer mit Sehbehinderungen oder kognitiven Erkrankungen wie ADHS und Legasthenie benötigen möglicherweise eine längere Zeit, um den Text in Benachrichtigungsnachrichten zu lesen. Mit diesem Flag können Sie die Nachrichtendauer festlegen.

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

SPI_SETMOUSECLICKLOCK
0x101F
Aktiviert oder deaktiviert die Barrierefreiheitsfunktion "Mouse ClickLock". Dieses Feature sperrt die primäre Maustaste vorübergehend, wenn diese Schaltfläche für die von SPI_SETMOUSECLICKLOCKTIME angegebene Zeit geklickt und gedrückt gehalten wird. Der pvParam-Parameter gibt TRUE für ein oder FALSE für aus an. Der Standardwert ist off. Weitere Informationen finden Sie unter Hinweise und InfoMouse-Eingabe.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETMOUSECLICKLOCKTIME
0x2009
Passt die Zeitverzögerung an, bevor die primäre Maustaste gesperrt wird. Der uiParam-Parameter sollte auf 0 festgelegt werden. Der parameter pvParam verweist auf ein DWORD , das die Zeitverzögerung in Millisekunden angibt. Geben Sie beispielsweise 1000 für eine Verzögerung von 1 Sekunde an. Der Standardwert ist 1200. Weitere Informationen finden Sie unter Übersicht über Mauseingaben.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETMOUSEKEYS
0x0037
Legt die Parameter des MouseKeys-Barrierefreiheitsfeatures fest. Der pvParam-Parameter muss auf eine MOUSEKEYS-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(MOUSEKEYS).
SPI_SETMOUSESONAR
0x101D
Aktiviert oder deaktiviert die Sonar-Barrierefreiheitsfunktion. Dieses Feature zeigt kurz mehrere konzentrische Kreise um den Mauszeiger an, wenn der Benutzer die STRG-TASTE drückt und loslässt. Der pvParam-Parameter gibt TRUE für ein und FALSE für aus an. Der Standardwert ist off. Weitere Informationen finden Sie unter Übersicht über Mauseingaben.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETMOUSEVANISH
0x1021
Aktiviert oder deaktiviert das Feature "Vanish". Dieses Feature blendet den Mauszeiger aus, wenn der Benutzer eingibt. der Zeiger wird wieder angezeigt, wenn der Benutzer die Maus bewegt. Der pvParam-Parameter gibt TRUE für ein und FALSE für aus an. Der Standardwert ist off. Weitere Informationen finden Sie unter Übersicht über Mauseingaben.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETSCREENREADER
0x0047
Bestimmt, ob ein Hilfsprogramm für die Bildschirmüberprüfung ausgeführt wird. Der uiParam-Parameter gibt TRUE für ein oder FALSE für aus an.
Hinweis Die Sprachausgabe, die in Windows enthaltene Sprachausgabe, legt die SPI_SETSCREENREADER- oder SPI_GETSCREENREADER-Flags nicht fest.
 
SPI_SETSERIALKEYS
0x003F
Dieser Parameter wird nicht unterstützt.

Windows Server 2003 und Windows XP/2000: Der Benutzer sollte diese Einstellung über die Systemsteuerung steuern.

SPI_SETSHOWSOUNDS
0x0039
Aktiviert oder deaktiviert die Barrierefreiheitsfunktion ShowSounds. Der uiParam-Parameter gibt TRUE für ein oder FALSE für aus an.
SPI_SETSOUNDSENTRY
0x0041
Legt die Parameter des Barrierefreiheitsfeatures von SoundSentry fest. Der pvParam-Parameter muss auf eine SOUNDSENTRY-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(SOUNDSENTRY).
SPI_SETSTICKYKEYS
0x003B
Legt die Parameter des StickyKeys-Barrierefreiheitsfeatures fest. Der pvParam-Parameter muss auf eine STICKYKEYS-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(STICKYKEYS).
SPI_SETTOGGLEKEYS
0x0035
Legt die Parameter der Barrierefreiheitsfunktion ToggleKeys fest. Der pvParam-Parameter muss auf eine TOGGLEKEYS-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(TOGGLEKEYS).
 

Im Folgenden sind die Desktopparameter aufgeführt.

Desktopparameter Bedeutung
SPI_GETCLEARTYPE
0x1048
Bestimmt, ob ClearType aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn ClearType aktiviert ist, oder andernfalls FALSE .

ClearType ist eine Softwaretechnologie, die die Lesbarkeit von Text auf LCD-Monitoren (Liquid Crystal Display) verbessert.

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

SPI_GETDESKWALLPAPER
0x0073
Ruft den vollständigen Pfad der Bitmapdatei für das Desktophintergrundbild ab. Der pvParam-Parameter muss auf einen Puffer zeigen, um die null-beendete Pfadzeichenfolge zu empfangen. Legen Sie den uiParam-Parameter auf die Größe des pvParam-Puffers in Zeichen fest. Die zurückgegebene Zeichenfolge überschreitet nicht MAX_PATH Zeichen. Wenn kein Desktophintergrund vorhanden ist, ist die zurückgegebene Zeichenfolge leer.
SPI_GETDROPSHADOW
0x1024
Bestimmt, ob der Fallschatteneffekt aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE zurückgibt, wenn aktiviert oder FALSE , wenn deaktiviert.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETFLATMENU
0x1022
Bestimmt, ob native Benutzermenüs eine flache Menüdarstellung aufweisen. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE zurückgibt, wenn die Darstellung des Flachmenüs festgelegt ist, andernfalls FALSE .

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETFONTSMOOTHING
0x004A
Bestimmt, ob die Schriftartglättungsfunktion aktiviert ist. Dieses Feature verwendet Schriftarten-Antialiasing, um Schriftkurven glatter erscheinen zu lassen, indem Pixel mit unterschiedlichen Graustufen gemalt werden.

Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn das Feature aktiviert ist, oder AUF FALSE , wenn dies nicht der Fall ist.

SPI_GETFONTSMOOTHINGCONTRAST
0x200C
Ruft einen Kontrastwert ab, der in ClearType-Glättung verwendet wird. Der pvParam-Parameter muss auf ein UINT verweisen, das die Informationen empfängt. Gültige Kontrastwerte liegen zwischen 1000 und 2200. Der Standardwert ist 1400.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETFONTSMOOTHINGORIENTATION
0x2012
Ruft die Ausrichtung der Schriftartglättung ab. Der pvParam-Parameter muss auf ein UINT verweisen, das die Informationen empfängt. Mögliche Werte sind FE_FONTSMOOTHINGORIENTATIONBGR (blau-grün-rot) und FE_FONTSMOOTHINGORIENTATIONRGB (rot-grün-blau).

Windows XP/2000: Dieser Parameter wird erst unter Windows XP mit SP2 unterstützt.

SPI_GETFONTSMOOTHINGTYPE
0x200A
Ruft den Typ der Schriftglättung ab. Der pvParam-Parameter muss auf ein UINT verweisen, das die Informationen empfängt. Die möglichen Werte sind FE_FONTSMOOTHINGSTANDARD und FE_FONTSMOOTHINGCLEARTYPE.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETWORKAREA
0x0030
Ruft die Größe des Arbeitsbereichs auf dem primären Anzeigemonitor ab. Der Arbeitsbereich ist der Teil des Bildschirms, der nicht durch die Taskleiste des Systems oder die Symbolleisten des Anwendungsdesktops verdeckt wird. Der parameter pvParam muss auf eine RECT-Struktur verweisen, die die Koordinaten des Arbeitsbereichs empfängt, ausgedrückt in physischer Pixelgröße. Jeder DPI-Virtualisierungsmodus des Aufrufers hat keine Auswirkungen auf diese Ausgabe.

Um den Arbeitsbereich eines anderen Monitors als den primären Anzeigemonitor abzurufen, rufen Sie die GetMonitorInfo-Funktion auf.

SPI_SETCLEARTYPE
0x1049
Aktiviert oder deaktiviert ClearType. Der parameter pvParam ist eine BOOL-Variable . Legen Sie pvParam auf TRUE fest, um ClearType zu aktivieren, oder false , um es zu deaktivieren.

ClearType ist eine Softwaretechnologie, die die Lesbarkeit von Text auf LCD-Monitoren verbessert.

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

SPI_SETCURSORS
0x0057
Lädt die Systemcursor neu. Legen Sie den uiParam-Parameter auf Null und den parameter pvParam auf NULL fest.
SPI_SETDESKPATTERN
0x0015
Legt das aktuelle Desktopmuster fest, indem Windows die Einstellung Pattern= aus der WIN.INI-Datei liest.
SPI_SETDESKWALLPAPER
0x0014
Hinweis Wenn das SPI_SETDESKWALLPAPER-Flag verwendet wird, gibt SystemParametersInfoTRUE zurück, es sei denn, es liegt ein Fehler vor (z. B. wenn die angegebene Datei nicht vorhanden ist).
 
SPI_SETDROPSHADOW
0x1025
Aktiviert oder deaktiviert den Schlagschatteneffekt. Legen Sie pvParam auf TRUE fest, um den Schlagschatteneffekt zu aktivieren, oder false , um ihn zu deaktivieren. Sie müssen auch über CS_DROPSHADOW im Fensterklassenstil verfügen.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETFLATMENU
0x1023
Aktiviert oder deaktiviert die Darstellung des flachen Menüs für native Benutzermenüs. Legen Sie pvParam auf TRUE fest, um die Darstellung im flachen Menü zu aktivieren, oder auf FALSE , um sie zu deaktivieren.

Bei Aktivierung verwendet die Menüleiste COLOR_MENUBAR für den Hintergrund der Menüleiste, COLOR_MENU für den Menü-Popuphintergrund, COLOR_MENUHILIGHT für die Füllung der aktuellen Menüauswahl und COLOR_HILIGHT für die Gliederung der aktuellen Menüauswahl. Wenn sie deaktiviert sind, werden Menüs mit den gleichen Metriken und Farben wie in Windows 2000 gezeichnet.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETFONTSMOOTHING
0x004B
Aktiviert oder deaktiviert die Schriftglättungsfunktion, bei der Schriftarten-Antialiasing verwendet wird, um Schriftkurven glatter erscheinen zu lassen, indem Pixel mit unterschiedlichen Graustufen gemalt werden.

Um das Feature zu aktivieren, legen Sie den uiParam-Parameter auf TRUE fest. Um das Feature zu deaktivieren, legen Sie uiParam auf FALSE fest.

SPI_SETFONTSMOOTHINGCONTRAST
0x200D
Legt den in ClearType-Glättung verwendeten Kontrastwert fest. Der parameter pvParam ist der Kontrastwert. Gültige Kontrastwerte liegen zwischen 1000 und 2200. Der Standardwert ist 1400.

SPI_SETFONTSMOOTHINGTYPE muss auch auf FE_FONTSMOOTHINGCLEARTYPE festgelegt werden.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETFONTSMOOTHINGORIENTATION
0x2013
Legt die Ausrichtung der Schriftartglättung fest. Der pvParam-Parameter ist entweder FE_FONTSMOOTHINGORIENTATIONBGR (blau-grün-rot) oder FE_FONTSMOOTHINGORIENTATIONRGB (rot-grün-blau).

Windows XP/2000: Dieser Parameter wird erst unter Windows XP mit SP2 unterstützt.

SPI_SETFONTSMOOTHINGTYPE
0x200B
Legt den Schriftglättungstyp fest. Der pvParam-Parameter ist entweder FE_FONTSMOOTHINGSTANDARD, wenn Standardmäßiges Antialiasing verwendet wird, oder FE_FONTSMOOTHINGCLEARTYPE, wenn ClearType verwendet wird. Der Standardwert ist FE_FONTSMOOTHINGSTANDARD.

SPI_SETFONTSMOOTHING muss ebenfalls festgelegt werden.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETWORKAREA
0x002F
Legt die Größe des Arbeitsbereichs fest. Der Arbeitsbereich ist der Teil des Bildschirms, der nicht durch die Taskleiste des Systems oder die Symbolleisten des Anwendungsdesktops verdeckt wird. Der pvParam-Parameter ist ein Zeiger auf eine RECT-Struktur , die das neue Arbeitsbereichsrechteck angibt, ausgedrückt in virtuellen Bildschirmkoordinaten. In einem System mit mehreren Anzeigemonitoren legt die Funktion den Arbeitsbereich des Monitors fest, der das angegebene Rechteck enthält.
 

Im Folgenden sind die Symbolparameter aufgeführt.

Symbolparameter Bedeutung
SPI_GETICONMETRICS
0x002D
Ruft die Metriken ab, die Symbolen zugeordnet sind. Der parameter pvParam muss auf eine ICONMETRICS-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(ICONMETRICS).
SPI_GETICONTITLELOGFONT
0x001F
Ruft die logischen Schriftartinformationen für die aktuelle Schriftart mit Symboltitel ab. Der uiParam-Parameter gibt die Größe einer LOGFONT-Struktur an, und der pvParam-Parameter muss auf die LOGFONT-Struktur zum Ausfüllen verweisen.
SPI_GETICONTITLEWRAP
0x0019
Bestimmt, ob das Umschließen von Symboltiteln aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die true empfängt, falls aktiviert, oder FALSE andernfalls FALSE .
SPI_ICONHORIZONTALSPACING
0x000D
Legt die Breite einer Symbolzelle in Pixel fest oder ruft sie ab. Das System verwendet dieses Rechteck, um Symbole in der großen Symbolansicht anzuordnen.

Um diesen Wert festzulegen, legen Sie uiParam auf den neuen Wert fest, und legen Sie pvParam auf NULL fest. Sie können diesen Wert nicht auf kleiner als SM_CXICON festlegen.

Um diesen Wert abzurufen, muss pvParam auf eine ganze Zahl zeigen, die den aktuellen Wert empfängt.

SPI_ICONVERTICALSPACING
0x0018
Legt die Höhe einer Symbolzelle in Pixel fest oder ruft sie ab.

Um diesen Wert festzulegen, legen Sie uiParam auf den neuen Wert fest, und legen Sie pvParam auf NULL fest. Sie können diesen Wert nicht auf kleiner als SM_CYICON festlegen.

Um diesen Wert abzurufen, muss pvParam auf eine ganze Zahl zeigen, die den aktuellen Wert empfängt.

SPI_SETICONMETRICS
0x002E
Legt die Metriken fest, die Symbolen zugeordnet sind. Der pvParam-Parameter muss auf eine ICONMETRICS-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(ICONMETRICS).
SPI_SETICONS
0x0058
Lädt die Systemsymbole neu. Legen Sie den uiParam-Parameter auf Null und den parameter pvParam auf NULL fest.
SPI_SETICONTITLELOGFONT
0x0022
Legt die Schriftart fest, die für Symboltitel verwendet wird. Der uiParam-Parameter gibt die Größe einer LOGFONT-Struktur an, und der pvParam-Parameter muss auf eine LOGFONT-Struktur verweisen.
SPI_SETICONTITLEWRAP
0x001A
Aktiviert oder deaktiviert das Umschließen von Symboltiteln. Der uiParam-Parameter gibt TRUE für ein oder FALSE für aus an.
 

Im Folgenden sind die Eingabeparameter aufgeführt. Dazu gehören Parameter im Zusammenhang mit Tastatur, Maus, Touchpad, Stift, Eingabesprache und Warnungs-Beeper.

Eingabeparameter Bedeutung
SPI_GETBEEP
0x0001
Bestimmt, ob der Warnungs-Beeper aktiviert ist.

Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn der Beeper eingeschaltet ist, oder AUF FALSE , wenn er deaktiviert ist.

SPI_GETBLOCKSENDINPUTRESETS
0x1026
Ruft eine BOOL ab, die angibt, ob eine Anwendung den Timer des Bildschirmschoners zurücksetzen kann, indem die SendInput-Funktion aufgerufen wird, um Tastatur- oder Mauseingaben zu simulieren. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn die simulierte Eingabe blockiert wird, oder andernfalls FALSE .
SPI_GETCONTACTVISUALIZATION
0x2018
Ruft die aktuelle Kontaktvisualisierungseinstellung ab. Der parameter pvParam muss auf eine ULONG-Variable verweisen, die die Einstellung empfängt. Weitere Informationen finden Sie unter Kontaktvisualisierung.
SPI_GETDEFAULTINPUTLANG
0x0059
Ruft den Eingabegebietsschemabezeichner für die Systemstandardeingabesprache ab. Der parameter pvParam muss auf eine HKL-Variable verweisen, die diesen Wert empfängt. Weitere Informationen finden Sie unter Sprachen, Gebietsschemas und Tastaturlayouts.
SPI_GETGESTUREVISUALIZATION
0x201A
Ruft die aktuelle Gestenvisualisierungseinstellung ab. Der parameter pvParam muss auf eine ULONG-Variable verweisen, die die Einstellung empfängt. Weitere Informationen finden Sie unter Gestenvisualisierung.
SPI_GETKEYBOARDCUES
0x100A
Bestimmt, ob Menüzugriffsschlüssel immer unterstrichen werden. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn Menüzugriffsschlüssel immer unterstrichen werden, und FALSE , wenn sie nur unterstrichen werden, wenn das Menü durch die Tastatur aktiviert wird.
SPI_GETKEYBOARDDELAY
0x0016
Ruft die Tastaturwiederholungsverzögerungseinstellung ab, die ein Wert im Bereich von 0 (ca. 250 ms Verzögerung) bis 3 (etwa 1 Sekunde Verzögerung) ist. Die tatsächliche Verzögerung, die den einzelnen Werten zugeordnet ist, kann je nach Hardware variieren. Der parameter pvParam muss auf eine ganzzahlige Variable verweisen, die die Einstellung empfängt.
SPI_GETKEYBOARDPREF
0x0044
Bestimmt, ob der Benutzer sich auf die Tastatur statt auf die Maus verlässt, und möchte, dass Anwendungen Tastaturschnittstellen anzeigen, die andernfalls ausgeblendet würden. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn der Benutzer sich auf die Tastatur verlässt. oder andernfalls FALSE .
SPI_GETKEYBOARDSPEED
0x000A
Ruft die Tastaturwiederholgeschwindigkeit ab, die ein Wert im Bereich von 0 (ungefähr 2,5 Wiederholungen pro Sekunde) bis 31 (ungefähr 30 Wiederholungen pro Sekunde) ist. Die tatsächlichen Wiederholungsraten sind hardwareabhängig und können von einer linearen Skalierung um bis zu 20 % abweichen. Der pvParam-Parameter muss auf eine DWORD-Variable verweisen, die die Einstellung empfängt.
SPI_GETMOUSE
0x0003
Ruft die beiden Mausschwellenwerte und die Mausbeschleunigung ab. Der parameter pvParam muss auf ein Array von drei ganzen Zahlen verweisen, das diese Werte empfängt. Weitere Informationen finden Sie unter mouse_event .
SPI_GETMOUSEHOVERHEIGHT
0x0064
Ruft die Höhe des Rechtecks in Pixel ab, in dem der Mauszeiger bleiben muss, damit TrackMouseEvent eine WM_MOUSEHOVER Nachricht generiert. Der pvParam-Parameter muss auf eine UINT-Variable verweisen, die die Höhe empfängt.
SPI_GETMOUSEHOVERTIME
0x0066
Ruft die Zeit in Millisekunden ab, zu der der Mauszeiger im Hover-Rechteck bleiben muss, damit TrackMouseEvent eine WM_MOUSEHOVER Nachricht generiert. Der pvParam-Parameter muss auf eine UINT-Variable verweisen, die die Zeit empfängt.
SPI_GETMOUSEHOVERWIDTH
0x0062
Ruft die Breite des Rechtecks in Pixel ab, in dem der Mauszeiger bleiben muss, damit TrackMouseEvent eine WM_MOUSEHOVER Nachricht generiert. Der pvParam-Parameter muss auf eine UINT-Variable verweisen, die die Breite empfängt.
SPI_GETMOUSESPEED
0x0070
Ruft die aktuelle Mausgeschwindigkeit ab. Die Mausgeschwindigkeit bestimmt, wie weit sich der Zeiger bewegt, basierend auf der Entfernung, die die Maus bewegt. Der pvParam-Parameter muss auf eine ganze Zahl verweisen, die einen Wert empfängt, der zwischen 1 (langsam) und 20 (schnellste) liegt. Der Standardwert ist der Wert 10. Der Wert kann von einem Endbenutzer mit der Maussteuerungsanwendung oder von einer Anwendung mit SPI_SETMOUSESPEED festgelegt werden.
SPI_GETMOUSETRAILS
0x005E
Bestimmt, ob das Feature Mauspfade aktiviert ist. Dieses Feature verbessert die Sichtbarkeit von Mauscursorbewegungen, indem es kurz eine Spur von Cursorn anzeigt und sie schnell löscht.

Der pvParam-Parameter muss auf eine ganzzahlige Variable verweisen, die einen Wert empfängt. wenn der Wert 0 oder 1 ist, ist das Feature deaktiviert. Wenn der Wert größer als 1 ist, ist das Feature aktiviert, und der Wert gibt die Anzahl der im Trail gezeichneten Cursor an. Der uiParam-Parameter wird nicht verwendet.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_GETMOUSEWHEELROUTING
0x201C
Ruft die Routingeinstellung für die Mausradeingabe ab. Die Routingeinstellung bestimmt, ob die Eingabe des Mausrads an die App mit Fokus (Vordergrund) oder an die App unter dem Mauscursor gesendet wird.

Der pvParam-Parameter muss auf eine DWORD-Variable verweisen, die die Routingoption empfängt. Der uiParam-Parameter wird nicht verwendet.

Wenn der Wert null (MOUSEWHEEL_ROUTING_FOCUS) ist, wird die Mausradeingabe mit Fokus an die App übermittelt. Wenn der Wert 1 (MOUSEWHEEL_ROUTING_HYBRID) ist, wird die Eingabe des Mausrads an die App mit Fokus (Desktop-Apps) oder die App unter dem Mauszeiger (Windows Store-Apps) übermittelt.

Ab Windows 10: Wenn der Wert 2 (MOUSEWHEEL_ROUTING_MOUSE_POS) ist, wird die Mausradeingabe an die App unter dem Mauszeiger übermittelt. Dies ist die neue Standardeinstellung, und MOUSEWHEEL_ROUTING_HYBRID ist in den Einstellungen nicht mehr verfügbar.

SPI_GETPENVISUALIZATION
0x201E
Ruft die aktuelle Stiftgestenvisualisierungseinstellung ab. Der parameter pvParam muss auf eine ULONG-Variable verweisen, die die Einstellung empfängt. Weitere Informationen finden Sie unter Stiftvisualisierung.
SPI_GETSNAPTODEFBUTTON
0x005F
Bestimmt, ob das Snap-to-Default-Button-Feature aktiviert ist. Wenn diese Option aktiviert ist, bewegt sich der Mauscursor automatisch zur Standardschaltfläche eines Dialogfelds, z. B. OK oder Anwenden. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn das Feature aktiviert ist, oder FALSE , wenn es deaktiviert ist.
SPI_GETSYSTEMLANGUAGEBAR
0x1050
Ab Windows 8: Bestimmt, ob die Systemsprachleiste aktiviert oder deaktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn die Sprachleiste aktiviert ist, oder andernfalls FALSE .
SPI_GETTHREADLOCALINPUTSETTINGS
0x104E
Ab Windows 8: Bestimmt, ob die aktiven Eingabeeinstellungen den Bereich Lokal (pro Thread, TRUE) oder global (Sitzung, FALSE) aufweisen. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen.
SPI_GETTOUCHPADPARAMETERS
0x00AE
Ab Windows 11, Version 24H2: Ruft Details zum Precision Touchpad ab, einschließlich Benutzereinstellungen und Systeminformationen im Zusammenhang mit dem Touchpad.

Der pvParam-Parameter muss auf eine TOUCHPAD_PARAMETERS Struktur verweisen.

Der uiParam-Parameter muss die Größe der Struktur angeben.

Der Wert des Felds versionNumber in der TOUCHPAD_PARAMETERS-Struktur muss auf den entsprechenden Wert für die Version der verwendeten Struktur festgelegt werden.

SPI_GETWHEELSCROLLCHARS
0x006C
Ruft die Anzahl der Zeichen ab, die beim Verschieben des horizontalen Mausrads zu scrollen sind. Der parameter pvParam muss auf eine UINT-Variable verweisen, die die Anzahl der Zeilen empfängt. Der Standardwert ist 3.
SPI_GETWHEELSCROLLLINES
0x0068
Ruft die Anzahl der Zeilen ab, die beim Verschieben des vertikalen Mausrads zu scrollen sind. Der parameter pvParam muss auf eine UINT-Variable verweisen, die die Anzahl der Zeilen empfängt. Der Standardwert ist 3.
SPI_SETBEEP
0x0002
Schaltet den Warn-Beeper ein oder aus. Der uiParam-Parameter gibt TRUE für ein oder FALSE für aus an.
SPI_SETBLOCKSENDINPUTRESETS
0x1027
Bestimmt, ob eine Anwendung den Timer des Bildschirmschoners zurücksetzen kann, indem sie die SendInput-Funktion aufruft, um Tastatur- oder Mauseingaben zu simulieren. Der uiParam-Parameter gibt TRUE an, wenn der Bildschirmschoner nicht durch simulierte Eingabe deaktiviert wird, oder FALSE , wenn der Bildschirmschoner durch simulierte Eingabe deaktiviert wird.
SPI_SETCONTACTVISUALIZATION
0x2019
Legt die aktuelle Kontaktvisualisierungseinstellung fest. Der parameter pvParam muss auf eine ULONG-Variable verweisen, die die Einstellung identifiziert. Weitere Informationen finden Sie unter Kontaktvisualisierung.
Hinweis Wenn Kontaktvisualisierungen deaktiviert sind, können Gestenvisualisierungen nicht aktiviert werden.
 
SPI_SETDEFAULTINPUTLANG
0x005A
Legt die Standardeingabesprache für die Systemshell und anwendungen fest. Die angegebene Sprache muss mit dem aktuellen Systemzeichensatz angezeigt werden können. Der pvParam-Parameter muss auf eine HKL-Variable verweisen, die den Eingabegebietsschemabezeichner für die Standardsprache enthält. Weitere Informationen finden Sie unter Sprachen, Gebietsschemas und Tastaturlayouts.
SPI_SETDOUBLECLICKTIME
0x0020
Legt die Doppelklickzeit für die Maus auf den Wert des uiParam-Parameters fest. Wenn der uiParam-Wert größer als 5.000 Millisekunden ist, legt das System die Doppelklickzeit auf 5000 Millisekunden fest.

Die Doppelklickzeit ist die maximale Anzahl von Millisekunden, die zwischen dem ersten und zweiten Klick eines Doppelklicks auftreten kann. Sie können auch die SetDoubleClickTime-Funktion aufrufen, um die Zeit für den Doppelklick festzulegen. Um die aktuelle Doppelklickzeit abzurufen, rufen Sie die GetDoubleClickTime-Funktion auf.

SPI_SETDOUBLECLKHEIGHT
0x001E
Legt die Höhe des Doppelklick-Rechtecks auf den Wert des uiParam-Parameters fest.

Das Doppelklickrechteck ist das Rechteck, in dem der zweite Klick eines Doppelklicks fallen muss, damit es als Doppelklick registriert wird.

Um die Höhe des Doppelklick-Rechtecks abzurufen, rufen Sie GetSystemMetrics mit dem flag SM_CYDOUBLECLK auf.

SPI_SETDOUBLECLKWIDTH
0x001D
Legt die Breite des Doppelklick-Rechtecks auf den Wert des uiParam-Parameters fest.

Das Doppelklickrechteck ist das Rechteck, in dem der zweite Klick eines Doppelklicks fallen muss, damit es als Doppelklick registriert wird.

Um die Breite des Doppelklick-Rechtecks abzurufen, rufen Sie GetSystemMetrics mit dem flag SM_CXDOUBLECLK auf.

SPI_SETGESTUREVISUALIZATION
0x201B
Legt die Aktuelle Gestenvisualisierungseinstellung fest. Der parameter pvParam muss auf eine ULONG-Variable verweisen, die die Einstellung identifiziert. Weitere Informationen finden Sie unter Gestenvisualisierung.
Hinweis Wenn Kontaktvisualisierungen deaktiviert sind, können Gestenvisualisierungen nicht aktiviert werden.
 
SPI_SETKEYBOARDCUES
0x100B
Legt die Unterstreichung von Tastenbuchstaben für den Menüzugriff fest. Der parameter pvParam ist eine BOOL-Variable . Legen Sie pvParam auf TRUE fest, um die Menüzugriffstasten immer zu unterstreichen, oder auf FALSE , um die Menüzugriffstasten nur dann zu unterstreichen, wenn das Menü über die Tastatur aktiviert wird.
SPI_SETKEYBOARDDELAY
0x0017
Legt die Tastaturwiederholungsverzögerungseinstellung fest. Der uiParam-Parameter muss 0, 1, 2 oder 3 angeben, wobei null die kürzeste Verzögerung ca. 250 ms und 3 die längste Verzögerung (ca. 1 Sekunde) festlegt. Die tatsächliche Verzögerung, die den einzelnen Werten zugeordnet ist, kann je nach Hardware variieren.
SPI_SETKEYBOARDPREF
0x0045
Legt die Tastatureinstellung fest. Der uiParam-Parameter gibt TRUE an, wenn der Benutzer sich auf die Tastatur und nicht auf die Maus verlässt und anwendungen Tastaturschnittstellen anzeigen sollen, die andernfalls ausgeblendet wären. Andernfalls ist uiParamFALSE .
SPI_SETKEYBOARDSPEED
0x000B
Legt die Einstellung für die Wiederholungsgeschwindigkeit der Tastatur fest. Der uiParam-Parameter muss einen Wert im Bereich von 0 (ca. 2,5 Wiederholungen pro Sekunde) bis 31 (ca. 30 Wiederholungen pro Sekunde) angeben. Die tatsächlichen Wiederholungsraten sind hardwareabhängig und können von einer linearen Skalierung um bis zu 20 % variieren. Wenn uiParam größer als 31 ist, wird der Parameter auf 31 festgelegt.
SPI_SETLANGTOGGLE
0x005B
Legt den Tastenkombinationssatz für den Wechsel zwischen Eingabesprachen fest. Die Parameter uiParam und pvParam werden nicht verwendet. Der Wert legt die Tastenkombinationen in den Tastatureigenschaftenblättern fest, indem die Registrierung erneut gelesen wird. Die Registrierung muss festgelegt werden, bevor dieses Flag verwendet wird. Der Pfad in der Registrierung lautet HKEY_CURRENT_USER\Tastaturlayout\Umschalten

. Gültige Werte sind "1" = ALT+UMSCHALT, "2" = STRG+UMSCHALT und "3" = keine.
SPI_SETMOUSE
0x0004
Legt die beiden Mausschwellenwerte und die Mausbeschleunigung fest. Der parameter pvParam muss auf ein Array von drei ganzen Zahlen verweisen, das diese Werte angibt. Weitere Informationen finden Sie unter mouse_event .
SPI_SETMOUSEBUTTONSWAP
0x0021
Wechselt die Bedeutung der linken und rechten Maustasten oder stellt sie wieder her. Der uiParam-Parameter gibt TRUE an, um die Bedeutungen der Schaltflächen zu tauschen, oder FALSE , um ihre ursprüngliche Bedeutung wiederherzustellen.

Um die aktuelle Einstellung abzurufen, rufen Sie GetSystemMetrics mit dem flag SM_SWAPBUTTON auf.

SPI_SETMOUSEHOVERHEIGHT
0x0065
Legt die Höhe des Rechtecks in Pixel fest, in dem der Mauszeiger verbleiben muss, damit TrackMouseEvent eine WM_MOUSEHOVER Nachricht generiert. Legen Sie den uiParam-Parameter auf die neue Höhe fest.
SPI_SETMOUSEHOVERTIME
0x0067
Legt in Millisekunden fest, wie lange der Mauszeiger im Hoverrechteck verbleiben muss, damit TrackMouseEvent eine WM_MOUSEHOVER Nachricht generiert. Dies wird nur verwendet, wenn Sie im Aufruf von TrackMouseEventHOVER_DEFAULT im dwHoverTime-Parameter übergeben. Legen Sie den uiParam-Parameter auf die neue Uhrzeit fest.

Die angegebene Zeit sollte zwischen USER_TIMER_MAXIMUM und USER_TIMER_MINIMUM sein. Wenn uiParam kleiner als USER_TIMER_MINIMUM ist, verwendet die Funktion USER_TIMER_MINIMUM. Wenn uiParam größer als USER_TIMER_MAXIMUM ist, wird die Funktion USER_TIMER_MAXIMUM.

Windows Server 2003 und Windows XP: Das Betriebssystem erzwingt die Verwendung von USER_TIMER_MAXIMUM und USER_TIMER_MINIMUM erst unter Windows Server 2003 mit SP1 und Windows XP mit SP2.

SPI_SETMOUSEHOVERWIDTH
0x0063
Legt die Breite des Rechtecks in Pixel fest, in dem der Mauszeiger verbleiben muss, damit TrackMouseEvent eine WM_MOUSEHOVER Nachricht generiert. Legen Sie den uiParam-Parameter auf die neue Breite fest.
SPI_SETMOUSESPEED
0x0071
Legt die aktuelle Mausgeschwindigkeit fest. Der parameter pvParam ist eine ganze Zahl zwischen 1 (langsamste) und 20 (schnellste). Der Wert 10 ist der Standardwert. Dieser Wert wird in der Regel mit der Maus-Systemsteuerungsanwendung festgelegt.
SPI_SETMOUSETRAILS
0x005D
Aktiviert oder deaktiviert das Feature "Mauspfade", das die Sichtbarkeit von Mauscursorbewegungen verbessert, indem kurz eine Spur von Cursorn angezeigt und schnell entfernt wird.

Um das Feature zu deaktivieren, legen Sie den uiParam-Parameter auf null oder 1 fest. Um das Feature zu aktivieren, legen Sie uiParam auf einen Wert größer als 1 fest, um die Anzahl der im Trail gezeichneten Cursor anzugeben.

Windows 2000: Dieser Parameter wird nicht unterstützt.

SPI_SETMOUSEWHEELROUTING
0x201D
Legt die Routingeinstellung für die Mausradeingabe fest. Die Routingeinstellung bestimmt, ob die Mausradeingabe an die App mit Fokus (Vordergrund) oder an die App unter dem Mauscursor gesendet wird.

Der parameter pvParam muss auf eine DWORD-Variable verweisen, die die Routingoption empfängt. Legen Sie den uiParam-Parameter auf 0 (null) fest.

Wenn der Wert null (MOUSEWHEEL_ROUTING_FOCUS) ist, wird die Mausradeingabe mit Fokus an die App übermittelt. Wenn der Wert 1 (MOUSEWHEEL_ROUTING_HYBRID) ist, wird die Mausradeingabe an die App mit Fokus (Desktop-Apps) oder die App unter dem Mauszeiger (Windows Store-Apps) übermittelt.

Ab Windows 10: Wenn der Wert 2 (MOUSEWHEEL_ROUTING_MOUSE_POS) ist, wird die Mausradeingabe an die App unter dem Mauszeiger übermittelt. Dies ist die neue Standardeinstellung, und MOUSEWHEEL_ROUTING_HYBRID ist in den Einstellungen nicht mehr verfügbar.

SPI_SETPENVISUALIZATION
0x201F
Legt die aktuelle Stiftgestenvisualisierungseinstellung fest. Der parameter pvParam muss auf eine ULONG-Variable verweisen, die die Einstellung identifiziert. Weitere Informationen finden Sie unter Stiftvisualisierung.
SPI_SETSNAPTODEFBUTTON
0x0060
Aktiviert oder deaktiviert das Snap-to-Default-Button-Feature. Wenn aktiviert, wechselt der Mauscursor automatisch zur Standardschaltfläche, z. B. OK oder Anwenden, eines Dialogfelds. Legen Sie den uiParam-Parameter auf TRUE fest, um das Feature zu aktivieren, oder auf FALSE , um es zu deaktivieren. Anwendungen sollten beim Anzeigen eines Dialogfelds die ShowWindow-Funktion verwenden, damit der Dialog-Manager den Mauscursor positionieren kann.
SPI_SETSYSTEMLANGUAGEBAR
0x1051
Ab Windows 8: Aktiviert oder deaktiviert die Legacy-Sprachleistenfunktion. Der parameter pvParam ist ein Zeiger auf eine BOOL-Variable . Legen Sie pvParam auf TRUE fest, um die Ältere Sprachleiste zu aktivieren, oder auf FALSE , um sie zu deaktivieren. Das Flag wird unter Windows 8 unterstützt, wo die Legacy-Sprachleiste durch Eingabeumschalter ersetzt und daher standardmäßig deaktiviert wird. Das Aktivieren der Legacy-Sprachleiste wird aus Kompatibilitätsgründen bereitgestellt und hat keine Auswirkungen auf den Eingabeschalter.
SPI_SETTHREADLOCALINPUTSETTINGS
0x104F
Ab Windows 8: Bestimmt, ob die aktiven Eingabeeinstellungen den Bereich Lokal (pro Thread, TRUE) oder global (Sitzung, FALSE) aufweisen. Der pvParam-Parameter muss eine BOOL-Variable sein, die von PVOID umgewandelt wird.
SPI_SETTOUCHPADPARAMETERS
0x00AF
Ab Windows 11, Version 24H2: Legt Details zum Precision Touchpad fest, einschließlich Benutzereinstellungen und Systeminformationen zum Touchpad.

Der pvParam-Parameter muss auf eine TOUCHPAD_PARAMETERS Struktur verweisen.

Der uiParam-Parameter muss die Größe der Struktur angeben.

Der Wert des Felds versionNumber in der TOUCHPAD_PARAMETERS-Struktur muss auf den entsprechenden Wert für die Version der verwendeten Struktur festgelegt werden.

SPI_SETWHEELSCROLLCHARS
0x006D
Legt die Anzahl der Zeichen fest, die beim Verschieben des horizontalen Mausrads scrollen sollen. Die Anzahl der Zeichen wird über den uiParam-Parameter festgelegt.
SPI_SETWHEELSCROLLLINES
0x0069
Legt die Anzahl der Zeilen fest, die beim Verschieben des vertikalen Mausrads zu scrollen sind. Die Anzahl der Zeilen wird über den uiParam-Parameter festgelegt.

Die Anzahl der Zeilen ist die empfohlene Anzahl von Zeilen, die beim Rollen des Mausrads ohne Modifizierertasten gescrollt werden sollen. Wenn die Zahl 0 ist, sollte kein Bildlauf erfolgen. Wenn die Anzahl der zu scrollenden Zeilen größer ist als die Anzahl der anzuzeigenden Zeilen und insbesondere, wenn sie WHEEL_PAGESCROLL (#defined als UINT_MAX) ist, sollte der Bildlaufvorgang so interpretiert werden, dass im Bereich der Bildlaufleiste einmal im Bereich nach unten oder nach oben geklickt wird.

 

Im Folgenden sind die Menüparameter aufgeführt.

Menüparameter Bedeutung
SPI_GETMENUDROPALIGNMENT
0x001B
Bestimmt, ob Popupmenüs relativ zum entsprechenden Menüleistenelement linksbündig oder rechtsbündig sind. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn sie rechtsbündig ist, oder auf andere Weise AUF FALSE .
SPI_GETMENUFADE
0x1012
Bestimmt, ob die Menüblendungsanimation aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn die Einblendanimation aktiviert ist, und AUF FALSE , wenn sie nicht zulässig ist. Wenn die Einblendenanimation deaktiviert ist, verwenden Menüs Folienanimation. Dieses Flag wird ignoriert, es sei denn, die Menüanimation ist aktiviert, was Sie mithilfe des SPI_SETMENUANIMATION-Flags tun können. Weitere Informationen finden Sie unter AnimateWindow.
SPI_GETMENUSHOWDELAY
0x006A
Ruft in Millisekunden die Zeit ab, die das System wartet, bevor ein Kontextmenü angezeigt wird, wenn sich der Mauszeiger über einem Untermenüelement befindet. Der pvParam-Parameter muss auf eine DWORD-Variable verweisen, die den Zeitpunkt der Verzögerung empfängt.
SPI_SETMENUDROPALIGNMENT
0x001C
Legt den Ausrichtungswert von Popupmenüs fest. Der uiParam-Parameter gibt TRUE für die rechtsausrichtung und FALSE für die linke Ausrichtung an.
SPI_SETMENUFADE
0x1013
Aktiviert oder deaktiviert die Menüblendungsanimation. Legen Sie pvParam auf TRUE fest, um den Menüeinblendeffekt zu aktivieren, oder false , um ihn zu deaktivieren. Wenn die Einblendenanimation deaktiviert ist, verwenden Menüs Folienanimation. Der Menüblendeneffekt ist nur möglich, wenn das System über eine Farbtiefe von mehr als 256 Farben verfügt. Dieses Flag wird ignoriert, es sei denn , SPI_MENUANIMATION wird ebenfalls festgelegt. Weitere Informationen finden Sie unter AnimateWindow.
SPI_SETMENUSHOWDELAY
0x006B
Legt uiParam auf die Zeit in Millisekunden fest, die das System wartet, bevor ein Kontextmenü angezeigt wird, wenn sich der Mauscursor über einem Untermenüelement befindet.
 

Im Folgenden sind die Leistungsparameter aufgeführt.

Ab Windows Server 2008 und Windows Vista werden diese Energieparameter nicht unterstützt. Um den aktuellen Anzeigeleistungszustand zu bestimmen, sollte sich eine Anwendung stattdessen für GUID_MONITOR_POWER_STATE Benachrichtigungen registrieren. Um das Timeout der aktuellen Anzeige zu bestimmen, sollte sich eine Anwendung registrieren, um änderungen an der GUID_VIDEO_POWERDOWN_TIMEOUT-Energieeinstellung zu benachrichtigen. Weitere Informationen finden Sie unter Registrieren für Power Events.

Windows Server 2003 und Windows XP/2000: Verwenden Sie die folgenden Energieparameter, um den aktuellen Anzeigeleistungszustand zu bestimmen.

Power-Parameter Bedeutung
SPI_GETLOWPOWERACTIVE
0x0053
Dieser Parameter wird nicht unterstützt.

Windows Server 2003 und Windows XP/2000: Bestimmt, ob die Energiesparphase des Bildschirmspeicherns aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn aktiviert, oder FALSE , wenn deaktiviert. Dieses Flag wird nur für 32-Bit-Anwendungen unterstützt.

SPI_GETLOWPOWERTIMEOUT
0x004F
Dieser Parameter wird nicht unterstützt.

Windows Server 2003 und Windows XP/2000: Ruft den Timeoutwert für die Energiesparphase des Bildschirms ab. Der pvParam-Parameter muss auf eine ganzzahlige Variable verweisen, die den Wert empfängt. Dieses Flag wird nur für 32-Bit-Anwendungen unterstützt.

SPI_GETPOWEROFFACTIVE
0x0054
Dieser Parameter wird nicht unterstützt. Wenn die Abschaltungsphase des Bildschirmspeicherns aktiviert ist, ist die GUID_VIDEO_POWERDOWN_TIMEOUT Energieeinstellung größer als 00.

Windows Server 2003 und Windows XP/2000: Bestimmt, ob die Abschaltphase des Bildschirmspeicherns aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn aktiviert, oder FALSE , wenn deaktiviert. Dieses Flag wird nur für 32-Bit-Anwendungen unterstützt.

SPI_GETPOWEROFFTIMEOUT
0x0050
Dieser Parameter wird nicht unterstützt. Überprüfen Sie stattdessen die GUID_VIDEO_POWERDOWN_TIMEOUT-Energieeinstellung.

Windows Server 2003 und Windows XP/2000: Ruft den Timeoutwert für die Abschaltungsphase des Bildschirmspeicherns ab. Der pvParam-Parameter muss auf eine ganzzahlige Variable verweisen, die den Wert empfängt. Dieses Flag wird nur für 32-Bit-Anwendungen unterstützt.

SPI_SETLOWPOWERACTIVE
0x0055
Dieser Parameter wird nicht unterstützt.

Windows Server 2003 und Windows XP/2000: Aktiviert oder deaktiviert die Energiesparphase des Bildschirms. Legen Sie uiParam auf 1 fest, um zu aktivieren, oder null auf deaktivieren. Der pvParam-Parameter muss NULL sein. Dieses Flag wird nur für 32-Bit-Anwendungen unterstützt.

SPI_SETLOWPOWERTIMEOUT
0x0051
Dieser Parameter wird nicht unterstützt.

Windows Server 2003 und Windows XP/2000: Legt den Timeoutwert in Sekunden für die Energiesparphase des Bildschirms fest. Der uiParam-Parameter gibt den neuen Wert an. Der pvParam-Parameter muss NULL sein. Dieses Flag wird nur für 32-Bit-Anwendungen unterstützt.

SPI_SETPOWEROFFACTIVE
0x0056
Dieser Parameter wird nicht unterstützt. Legen Sie stattdessen die GUID_VIDEO_POWERDOWN_TIMEOUT-Energieeinstellung fest.

Windows Server 2003 und Windows XP/2000: Aktiviert oder deaktiviert die Abschaltungsphase des Bildschirmspeicherns. Legen Sie uiParam auf 1 fest, um zu aktivieren, oder null auf deaktivieren. Der pvParam-Parameter muss NULL sein. Dieses Flag wird nur für 32-Bit-Anwendungen unterstützt.

SPI_SETPOWEROFFTIMEOUT
0x0052
Dieser Parameter wird nicht unterstützt. Legen Sie stattdessen die GUID_VIDEO_POWERDOWN_TIMEOUT Energieeinstellung auf einen Timeoutwert fest.

Windows Server 2003 und Windows XP/2000: Legt den Timeoutwert in Sekunden für die Abschaltungsphase des Bildschirmspeicherns fest. Der uiParam-Parameter gibt den neuen Wert an. Der pvParam-Parameter muss NULL sein. Dieses Flag wird nur für 32-Bit-Anwendungen unterstützt.

 

Im Folgenden sind die Bildschirmschonerparameter aufgeführt.

Bildschirmschonerparameter Bedeutung
SPI_GETSCREENSAVEACTIVE
0x0010
Bestimmt, ob die Bildschirmspeicherung aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn der Bildschirmspeicher aktiviert ist, oder andernfalls FALSE .

Windows 7, Windows Server 2008 R2 und Windows 2000: Die Funktion gibt TRUE zurück, auch wenn der Bildschirmspeicher nicht aktiviert ist.

SPI_GETSCREENSAVERRUNNING
0x0072
Bestimmt, ob derzeit ein Bildschirmschoner auf der Fensterstation des aufrufenden Prozesses ausgeführt wird. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn derzeit ein Bildschirmschoner ausgeführt wird, andernfalls FALSE . Beachten Sie, dass nur für die interaktive Fensterstation WinSta0 ein Bildschirmschoner ausgeführt werden kann.
SPI_GETSCREENSAVESECURE
0x0076
Bestimmt, ob für den Bildschirmschoner ein Kennwort zum Anzeigen des Windows-Desktops erforderlich ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn der Bildschirmschoner ein Kennwort erfordert, oder andernfalls FALSE . Der uiParam-Parameter wird ignoriert.

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

SPI_GETSCREENSAVETIMEOUT
0x000E
Ruft den Timeoutwert des Bildschirmschoners in Sekunden ab. Der pvParam-Parameter muss auf eine ganzzahlige Variable verweisen, die den Wert empfängt.
SPI_SETSCREENSAVEACTIVE
0x0011
Legt den Status des Bildschirmschoner fest. Der uiParam-Parameter gibt TRUE an, um den Bildschirmspeicher zu aktivieren, oder FALSE , um ihn zu deaktivieren.

Wenn der Computer in den Energiesparmodus oder Systemsperrzustand versetzt wurde, tritt eine ERROR_OPERATION_IN_PROGRESS Ausnahme auf.

SPI_SETSCREENSAVESECURE
0x0077
Legt fest, ob der Bildschirmschoner erfordert, dass der Benutzer ein Kennwort eingeben muss, um den Windows-Desktop anzuzeigen. Der uiParam-Parameter ist eine BOOL-Variable . Der parameter pvParam wird ignoriert. Legen Sie uiParam auf TRUE fest, um ein Kennwort zu erfordern, oder false , um kein Kennwort zu benötigen.

Wenn der Computer in den Energiesparmodus oder Systemsperrzustand versetzt wurde, tritt eine ERROR_OPERATION_IN_PROGRESS Ausnahme auf.

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

SPI_SETSCREENSAVETIMEOUT
0x000F
Legt den Timeoutwert des Bildschirmschoner auf den Wert des uiParam-Parameters fest. Dieser Wert ist die Zeitspanne in Sekunden, die sich das System im Leerlauf befinden muss, bevor der Bildschirmschoner aktiviert wird.

Wenn der Computer in den Energiesparmodus oder Systemsperrzustand versetzt wurde, tritt eine ERROR_OPERATION_IN_PROGRESS Ausnahme auf.

 

Im Folgenden sind die Timeoutparameter für Anwendungen und Dienste aufgeführt.

Timeoutparameter Bedeutung
SPI_GETHUNGAPPTIMEOUT
0x0078
Ruft die Anzahl von Millisekunden ab, die ein Thread durchlaufen kann, ohne eine Nachricht zu senden, bevor das System ihn für nicht reagiert. Der pvParam-Parameter muss auf eine ganzzahlige Variable verweisen, die den Wert empfängt.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETWAITTOKILLTIMEOUT
0x007A
Ruft die Anzahl von Millisekunden ab, die das System wartet, bevor eine Anwendung beendet wird, die nicht auf eine Herunterfahrensanforderung antwortet. Der pvParam-Parameter muss auf eine ganzzahlige Variable verweisen, die den Wert empfängt.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETWAITTOKILLSERVICETIMEOUT
0x007C
Ruft die Anzahl von Millisekunden ab, die der Dienststeuerungs-Manager wartet, bevor ein Dienst beendet wird, der nicht auf eine Herunterfahrensanforderung antwortet. Der pvParam-Parameter muss auf eine ganzzahlige Variable verweisen, die den Wert empfängt.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETHUNGAPPTIMEOUT
0x0079
Legt das Timeout der hängenden Anwendung auf den Wert des uiParam-Parameters fest. Dieser Wert ist die Anzahl von Millisekunden, die ein Thread durchlaufen kann, ohne eine Nachricht zu senden, bevor das System ihn für nicht reagiert.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETWAITTOKILLTIMEOUT
0x007B
Legt das Timeout der Anwendungsabschaltungsanforderung auf den Wert des uiParam-Parameters fest. Dieser Wert ist die Anzahl von Millisekunden, die das System wartet, bevor eine Anwendung beendet wird, die nicht auf eine Herunterfahranforderung antwortet.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETWAITTOKILLSERVICETIMEOUT
0x007D
Legt das Timeout der Dienstabschaltungsanforderung auf den Wert des uiParam-Parameters fest. Dieser Wert ist die Anzahl von Millisekunden, die das System wartet, bevor ein Dienst beendet wird, der nicht auf eine Herunterfahrensanforderung antwortet.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

 

Im Folgenden sind die Ui-Effekte aufgeführt. Der SPI_SETUIEFFECTS Wert wird verwendet, um alle Benutzeroberflächeneffekte gleichzeitig zu aktivieren oder zu deaktivieren. Diese Tabelle enthält die vollständige Liste der Benutzeroberflächeneffektwerte.

Parameter für Benutzeroberflächeneffekte Bedeutung
SPI_GETCOMBOBOXANIMATION
0x1004
Bestimmt, ob der Folieneffekt für Kombinationsfelde aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE für aktiviert oder FALSE für deaktiviert empfängt.
SPI_GETCURSORSHADOW
0x101A
Bestimmt, ob der Cursor einen Schatten um ihn herum hat. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn der Schatten aktiviert ist, FALSE , wenn er deaktiviert ist. Dieser Effekt tritt nur auf, wenn das System über eine Farbtiefe von mehr als 256 Farben verfügt.
SPI_GETGRADIENTCAPTIONS
0x1008
Bestimmt, ob der Farbverlaufseffekt für Fenstertitelleisten aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE für aktiviert oder FALSE für deaktiviert empfängt. Weitere Informationen zum Farbverlaufseffekt finden Sie in der GetSysColor-Funktion .
SPI_GETHOTTRACKING
0x100E
Bestimmt, ob die Hot-Tracking von Elementen der Benutzeroberfläche, z. B. Menünamen in Menüleisten, aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE für aktiviert oder FALSE für deaktiviert empfängt.

Hot Tracking bedeutet, dass der Cursor, wenn er sich über ein Element bewegt, hervorgehoben, aber nicht ausgewählt wird. Sie können diesen Wert abfragen, um zu entscheiden, ob Sie hot tracking auf der Benutzeroberfläche Ihrer Anwendung verwenden möchten.

SPI_GETLISTBOXSMOOTHSCROLLING
0x1006
Bestimmt, ob der Smooth-Scrolling-Effekt für Listenfelder aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE für aktiviert oder FALSE für deaktiviert empfängt.
SPI_GETMENUANIMATION
0x1002
Bestimmt, ob die Menüanimationsfunktion aktiviert ist. Dieser Masterschalter muss aktiviert sein, um Menüanimationseffekte zu aktivieren. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn die Animation aktiviert ist, und FALSE , wenn sie deaktiviert ist.

Wenn die Animation aktiviert ist, gibt SPI_GETMENUFADE an, ob Menüs Einblend- oder Folienanimation verwenden.

SPI_GETMENUUNDERLINES
0x100A
Identisch mit SPI_GETKEYBOARDCUES.
SPI_GETSELECTIONFADE
0x1014
Bestimmt, ob der Auswahlblendeffekt aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn aktiviert oder FALSE , wenn deaktiviert.

Der Effekt der Auswahlblendung bewirkt, dass das vom Benutzer ausgewählte Menüelement kurz auf dem Bildschirm verbleibt und nach dem Schließen des Menüs ausgeblendet wird.

SPI_GETTOOLTIPANIMATION
0x1016
Bestimmt, ob die QuickInfo-Animation aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn aktiviert oder FALSE , wenn deaktiviert. Wenn die QuickInfo-Animation aktiviert ist, gibt SPI_GETTOOLTIPFADE an, ob QuickInfos Einblend- oder Folienanimation verwenden.
SPI_GETTOOLTIPFADE
0x1018
Wenn SPI_SETTOOLTIPANIMATION aktiviert ist, gibt SPI_GETTOOLTIPFADE an, ob die QuickInfo-Animation einen Einblendeffekt oder einen Folieneffekt verwendet. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE für die Einblendanimation oder FALSE für Folienanimation empfängt. Weitere Informationen zu Folien- und Einblendeffekten finden Sie unter AnimateWindow.
SPI_GETUIEFFECTS
0x103E
Bestimmt, ob Benutzeroberflächeneffekte aktiviert oder deaktiviert sind. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn alle UI-Effekte aktiviert sind, oder AUF FALSE , wenn sie deaktiviert sind.
SPI_SETCOMBOBOXANIMATION
0x1005
Aktiviert oder deaktiviert den Effekt zum Öffnen der Folie für Kombinationsfelder. Legen Sie den pvParam-Parameter auf TRUE fest, um den Farbverlaufseffekt zu aktivieren, oder auf FALSE , um ihn zu deaktivieren.
SPI_SETCURSORSHADOW
0x101B
Aktiviert oder deaktiviert einen Schatten um den Cursor. Der parameter pvParam ist eine BOOL-Variable . Legen Sie pvParam auf TRUE fest, um den Schatten zu aktivieren, oder FALSE , um den Schatten zu deaktivieren. Dieser Effekt tritt nur auf, wenn das System über eine Farbtiefe von mehr als 256 Farben verfügt.
SPI_SETGRADIENTCAPTIONS
0x1009
Aktiviert oder deaktiviert den Farbverlaufseffekt für Fenstertitelleisten. Legen Sie den pvParam-Parameter auf TRUE fest, um ihn zu aktivieren, oder auf FALSE , um ihn zu deaktivieren. Der Farbverlaufseffekt ist nur möglich, wenn das System über eine Farbtiefe von mehr als 256 Farben verfügt. Weitere Informationen zum Farbverlaufseffekt finden Sie in der GetSysColor-Funktion .
SPI_SETHOTTRACKING
0x100F
Aktiviert oder deaktiviert die Hot-Tracking von Elementen der Benutzeroberfläche, z. B. Menünamen in Menüleisten. Legen Sie den pvParam-Parameter auf TRUE fest, um ihn zu aktivieren, oder auf FALSE , um ihn zu deaktivieren.

Hot-Tracking bedeutet, dass der Cursor, wenn er sich über ein Element bewegt, hervorgehoben, aber nicht ausgewählt wird.

SPI_SETLISTBOXSMOOTHSCROLLING
0x1007
Aktiviert oder deaktiviert den Smooth-Scrolling-Effekt für Listenfelder. Legen Sie den pvParam-Parameter auf TRUE fest, um den Effekt für den reibungslosen Bildlauf zu aktivieren, oder auf FALSE , um ihn zu deaktivieren.
SPI_SETMENUANIMATION
0x1003
Aktiviert oder deaktiviert die Menüanimation. Dieser Masterschalter muss aktiviert sein, damit eine Menüanimation ausgeführt werden kann. Der parameter pvParam ist eine BOOL-Variable . Legen Sie pvParam auf TRUE fest, um die Animation zu aktivieren, und false zum Deaktivieren der Animation.

Wenn die Animation aktiviert ist, gibt SPI_GETMENUFADE an, ob Menüs Einblend- oder Folienanimation verwenden.

SPI_SETMENUUNDERLINES
0x100B
Identisch mit SPI_SETKEYBOARDCUES.
SPI_SETSELECTIONFADE
0x1015
Legen Sie pvParam auf TRUE fest, um den Auswahleinblendeffekt zu aktivieren, oder auf FALSE , um ihn zu deaktivieren.

Der Effekt der Auswahlblendung bewirkt, dass das vom Benutzer ausgewählte Menüelement kurz auf dem Bildschirm verbleibt und nach dem Schließen des Menüs ausgeblendet wird. Der Effekt der Auswahlblendung ist nur möglich, wenn das System über eine Farbtiefe von mehr als 256 Farben verfügt.

SPI_SETTOOLTIPANIMATION
0x1017
Legen Sie pvParam auf TRUE fest, um die QuickInfo-Animation zu aktivieren, oder false , um sie zu deaktivieren. Wenn diese Option aktiviert ist, können Sie SPI_SETTOOLTIPFADE verwenden, um Einblend- oder Folienanimation anzugeben.
SPI_SETTOOLTIPFADE
0x1019
Wenn das flag SPI_SETTOOLTIPANIMATION aktiviert ist, verwenden Sie SPI_SETTOOLTIPFADE , um anzugeben, ob die QuickInfo-Animation einen Einblendeneffekt oder einen Folieneffekt verwendet. Legen Sie pvParam für die Einblendanimation auf TRUE oder AUF FALSE für Folienanimation fest. Der QuickInfo-Fade-Effekt ist nur möglich, wenn das System über eine Farbtiefe von mehr als 256 Farben verfügt. Weitere Informationen zu den Folien- und Einblendeffekten finden Sie in der Funktion AnimateWindow .
SPI_SETUIEFFECTS
0x103F
Aktiviert oder deaktiviert Benutzeroberflächeneffekte. Legen Sie den pvParam-Parameter auf TRUE fest, um alle UI-Effekte zu aktivieren, oder false , um alle UI-Effekte zu deaktivieren.
 

Im Folgenden sind die Fensterparameter aufgeführt.

Fensterparameter Bedeutung
SPI_GETACTIVEWINDOWTRACKING
0x1000
Bestimmt, ob die aktive Fensternachverfolgung (aktivierung des Fensters, in dem sich die Maus befindet) aktiviert oder deaktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE für ein oder FALSE für aus empfängt.
SPI_GETACTIVEWNDTRKZORDER
0x100C
Bestimmt, ob durch aktive Fensternachverfolgung aktivierte Fenster nach oben gebracht werden. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die TRUE für ein oder FALSE für aus empfängt.
SPI_GETACTIVEWNDTRKTIMEOUT
0x2002
Ruft die Verzögerung der aktiven Fensternachverfolgung in Millisekunden ab. Der pvParam-Parameter muss auf eine DWORD-Variable verweisen, die die Zeit empfängt.
SPI_GETANIMATION
0x0048
Ruft die Mit Benutzeraktionen verknüpften Animationseffekte ab. Der parameter pvParam muss auf eine ANIMATIONINFO-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(ANIMATIONINFO).
SPI_GETBORDER
0x0005
Ruft den Rahmenmultiplikatorfaktor ab, der die Breite des Größenrahmens eines Fensters bestimmt. Der parameter pvParam muss auf eine ganzzahlige Variable verweisen, die diesen Wert empfängt.
SPI_GETCARETWIDTH
0x2006
Ruft die Caretbreite in Bearbeitungssteuerelementen in Pixel ab. Der pvParam-Parameter muss auf eine DWORD-Variable verweisen, die diesen Wert empfängt.
SPI_GETDOCKMOVING
0x0090
Bestimmt, ob ein Fenster angedockt wird, wenn es an den oberen, linken oder rechten Rand eines Monitor- oder Monitorarrays verschoben wird. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die true empfängt, falls aktiviert, oder FALSE andernfalls FALSE .

Verwenden Sie SPI_GETWINARRANGING , um zu bestimmen, ob dieses Verhalten aktiviert ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETDRAGFROMMAXIMIZE
0x008C
Bestimmt, ob ein maximiertes Fenster wiederhergestellt wird, wenn die Beschriftungsleiste gezogen wird. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die true empfängt, falls aktiviert, oder FALSE andernfalls FALSE .

Verwenden Sie SPI_GETWINARRANGING , um zu bestimmen, ob dieses Verhalten aktiviert ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETDRAGFULLWINDOWS
0x0026
Bestimmt, ob das Ziehen von vollständigen Fenstern aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die true empfängt, falls aktiviert, oder FALSE andernfalls FALSE .
SPI_GETFOREGROUNDFLASHCOUNT
0x2004
Ruft ab, wie oft SetForegroundWindow die Taskleistenschaltfläche blinkt, wenn eine Anforderung für einen Vordergrundschalter abgelehnt wird. Der pvParam-Parameter muss auf eine DWORD-Variable verweisen, die den Wert empfängt.
SPI_GETFOREGROUNDLOCKTIMEOUT
0x2000
Ruft die Zeit nach der Benutzereingabe in Millisekunden ab, in der das System es nicht zulässt, dass Anwendungen sich in den Vordergrund zwingen. Der pvParam-Parameter muss auf eine DWORD-Variable verweisen, die die Zeit empfängt.
SPI_GETMINIMIZEDMETRICS
0x002B
Ruft die Metriken ab, die minimierten Fenstern zugeordnet sind. Der pvParam-Parameter muss auf eine MINIMIZEDMETRICS-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(MINIMIZEDMETRICS).
SPI_GETMOUSEDOCKTHRESHOLD
0x007E
Ruft den Schwellenwert in Pixel ab, bei dem das Andockverhalten ausgelöst wird, indem ein Fenster mithilfe einer Maus an den Rand eines Monitor- oder Monitorarrays gezogen wird. Der Standardschwellenwert ist 1. Der pvParam-Parameter muss auf eine DWORD-Variable verweisen, die den Wert empfängt.

Verwenden Sie SPI_GETWINARRANGING , um zu bestimmen, ob dieses Verhalten aktiviert ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETMOUSEDRAGOUTTHRESHOLD
0x0084
Ruft den Schwellenwert in Pixel ab, bei dem das Ausdockenverhalten ausgelöst wird, indem ein Fenster mit der Maus vom Rand eines Monitors oder eines Monitorarrays in die Mitte gezogen wird. Der Standardschwellenwert ist 20.

Verwenden Sie SPI_GETWINARRANGING , um zu bestimmen, ob dieses Verhalten aktiviert ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETMOUSESIDEMOVETHRESHOLD
0x0088
Ruft den Schwellenwert in Pixel vom oberen Rand eines Monitors oder eines Monitorarrays ab, bei dem ein vertikal maximiertes Fenster wiederhergestellt wird, wenn es mit der Maus gezogen wird. Der Standardwert ist 50.

Verwenden Sie SPI_GETWINARRANGING , um zu bestimmen, ob dieses Verhalten aktiviert ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETNONCLIENTMETRICS
0x0029
Ruft die Metriken ab, die dem Nichtclientbereich von nicht minimierten Fenstern zugeordnet sind. Der pvParam-Parameter muss auf eine NONCLIENTMETRICS-Struktur verweisen, die die Informationen empfängt. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(NONCLIENTMETRICS).

Windows Server 2003 und Windows XP/2000: Weitere Informationen finden Sie unter Hinweise zu NONCLIENTMETRICS.

SPI_GETPENDOCKTHRESHOLD
0x0080
Ruft den Schwellenwert in Pixel ab, bei dem das Andockverhalten ausgelöst wird, indem ein Stift verwendet wird, um ein Fenster an den Rand eines Monitor- oder Monitorarrays zu ziehen. Der Standardwert ist 30.

Verwenden Sie SPI_GETWINARRANGING , um zu bestimmen, ob dieses Verhalten aktiviert ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETPENDRAGOUTTHRESHOLD
0x0086
Ruft den Schwellenwert in Pixel ab, bei dem das Abdockenverhalten ausgelöst wird, indem ein Fenster mithilfe eines Stifts vom Rand eines Monitors oder Monitorarrays in die Mitte gezogen wird. Der Standardschwellenwert ist 30.

Verwenden Sie SPI_GETWINARRANGING , um zu bestimmen, ob dieses Verhalten aktiviert ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETPENSIDEMOVETHRESHOLD
0x008A
Ruft den Schwellenwert in Pixeln vom oberen Rand eines Monitors oder Monitorarrays ab, bei dem ein vertikal maximiertes Fenster wiederhergestellt wird, wenn es mit der Maus gezogen wird. Der Standardschwellenwert ist 50.

Verwenden Sie SPI_GETWINARRANGING , um zu bestimmen, ob dieses Verhalten aktiviert ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETSHOWIMEUI
0x006E
Bestimmt, ob das IME-Statusfenster (auf Benutzerbasis) sichtbar ist. Der parameter pvParam muss auf eine BOOL-Variable verweisen, die TRUE empfängt, wenn das Statusfenster sichtbar ist, oder FALSE , wenn dies nicht der Fall ist.
SPI_GETSNAPSIZING
0x008E
Bestimmt, ob ein Fenster vertikal maximiert wird, wenn es am oberen oder unteren Rand eines Monitors oder Monitorarrays ausgerichtet ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die bei Aktivierung TRUE oder andernfalls FALSE empfängt .

Verwenden Sie SPI_GETWINARRANGING , um zu bestimmen, ob dieses Verhalten aktiviert ist.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_GETWINARRANGING
0x0082
Bestimmt, ob die Fensteranordnung aktiviert ist. Der pvParam-Parameter muss auf eine BOOL-Variable verweisen, die bei Aktivierung TRUE oder andernfalls FALSE empfängt .

Die Fensteranordnung reduziert die Anzahl von Maus-, Stift- oder Touchinteraktionen, die zum Verschieben und Vergrößern von Fenstern auf oberster Ebene erforderlich sind, indem das Standardverhalten eines Fensters vereinfacht wird, wenn es gezogen oder vergrößert wird.

Die folgenden Parameter rufen einzelne Fensteranordnungseinstellungen ab:

SPI_GETDOCKMOVING
SPI_GETMOUSEDOCKTHRESHOLD
SPI_GETMOUSEDRAGOUTTHRESHOLD
SPI_GETMOUSESIDEMOVETHRESHOLD
SPI_GETPENDOCKTHRESHOLD
SPI_GETPENDRAGOUTTHRESHOLD
SPI_GETPENSIDEMOVETHRESHOLD
SPI_GETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.
SPI_SETACTIVEWINDOWTRACKING
0x1001
Legt die aktive Fensternachverfolgung (aktivierung des Fensters, an dem die Maus ist) entweder ein oder aus fest. Legen Sie pvParam für ein auf TRUE oder FALSE für aus fest.
SPI_SETACTIVEWNDTRKZORDER
0x100D
Bestimmt, ob Fenster, die über die Nachverfolgung aktiver Fenster aktiviert wurden, nach oben gebracht werden sollen. Legen Sie pvParam für ein auf TRUE oder FALSE für aus fest.
SPI_SETACTIVEWNDTRKTIMEOUT
0x2003
Legt die Verzögerung der aktiven Fensternachverfolgung fest. Legen Sie pvParam auf die Anzahl von Millisekunden fest, die verzögert werden soll, bevor das Fenster unter dem Mauszeiger aktiviert wird.
SPI_SETANIMATION
0x0049
Legt die Animationseffekte fest, die Benutzeraktionen zugeordnet sind. Der parameter pvParam muss auf eine ANIMATIONINFO-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(ANIMATIONINFO).
SPI_SETBORDER
0x0006
Legt den Rahmenmultiplikatorfaktor fest, der die Breite des Größenrahmens eines Fensters bestimmt. Der uiParam-Parameter gibt den neuen Wert an.
SPI_SETCARETWIDTH
0x2007
Legt die Caretbreite in Bearbeitungssteuerelementen fest. Legen Sie pvParam auf die gewünschte Breite in Pixel fest. Der Standardwert und der Mindestwert ist 1.
SPI_SETDOCKMOVING
0x0091
Legt fest, ob ein Fenster angedockt wird, wenn es an die oberen, linken oder rechten Andockziele auf einem Monitor oder Monitorarray verschoben wird. Legen Sie pvParam für ein auf TRUE oder FALSE für aus fest.

SPI_GETWINARRANGING muss TRUE sein, um dieses Verhalten zu aktivieren.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETDRAGFROMMAXIMIZE
0x008D
Legt fest, ob ein maximiertes Fenster wiederhergestellt wird, wenn die Beschriftungsleiste gezogen wird. Legen Sie pvParam für ein auf TRUE oder FALSE für aus fest.

SPI_GETWINARRANGING muss TRUE sein, um dieses Verhalten zu aktivieren.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETDRAGFULLWINDOWS
0x0025
Legt das Ziehen von vollständigen Fenstern entweder ein oder aus fest. Der uiParam-Parameter gibt TRUE für ein oder FALSE für aus an.
SPI_SETDRAGHEIGHT
0x004D
Legt die Höhe des Rechtecks in Pixel fest, mit dem der Start eines Ziehvorgangs erkannt wird. Legen Sie uiParam auf den neuen Wert fest. Um die Ziehhöhe abzurufen, rufen Sie GetSystemMetrics mit dem flag SM_CYDRAG auf.
SPI_SETDRAGWIDTH
0x004C
Legt die Breite des Rechtecks in Pixel fest, mit dem der Start eines Ziehvorgangs erkannt wird. Legen Sie uiParam auf den neuen Wert fest. Um die Ziehbreite abzurufen, rufen Sie GetSystemMetrics mit dem flag SM_CXDRAG auf.
SPI_SETFOREGROUNDFLASHCOUNT
0x2005
Legt fest, wie oft SetForegroundWindow die Taskleistenschaltfläche blinkt, wenn eine Anforderung zum Wechseln im Vordergrund abgelehnt wird. Legen Sie pvParam auf die Anzahl der Flash-Meldungen fest.
SPI_SETFOREGROUNDLOCKTIMEOUT
0x2001
Legt die Zeit nach der Benutzereingabe in Millisekunden fest, während der das System anwendungen nicht erlaubt, sich in den Vordergrund zu zwingen. Legen Sie pvParam auf den neuen Timeoutwert fest.

Der aufrufende Thread muss das Vordergrundfenster ändern können, andernfalls schlägt der Aufruf fehl.

SPI_SETMINIMIZEDMETRICS
0x002C
Legt die Metriken fest, die minimierten Fenstern zugeordnet sind. Der parameter pvParam muss auf eine MINIMIZEDMETRICS-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(MINIMIZEDMETRICS).
SPI_SETMOUSEDOCKTHRESHOLD
0x007F
Legt den Schwellenwert in Pixel fest, bei dem das Andockverhalten ausgelöst wird, indem ein Fenster mit der Maus an den Rand eines Monitors oder Monitorarrays gezogen wird. Der Standardschwellenwert ist 1. Der parameter pvParam muss auf eine DWORD-Variable verweisen, die den neuen Wert enthält.

SPI_GETWINARRANGING muss TRUE sein, um dieses Verhalten zu aktivieren.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETMOUSEDRAGOUTTHRESHOLD
0x0085
Legt den Schwellenwert in Pixel fest, bei dem das Abdockenverhalten ausgelöst wird, indem ein Fenster mit einer Maus vom Rand eines Monitors oder Monitorarrays in die Mitte gezogen wird. Der Standardschwellenwert ist 20. Der parameter pvParam muss auf eine DWORD-Variable verweisen, die den neuen Wert enthält.

SPI_GETWINARRANGING muss TRUE sein, um dieses Verhalten zu aktivieren.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETMOUSESIDEMOVETHRESHOLD
0x0089
Legt den Schwellenwert in Pixel vom oberen Rand des Monitors fest, bei dem ein vertikal maximiertes Fenster wiederhergestellt wird, wenn es mit der Maus gezogen wird. Der Standardschwellenwert ist 50. Der parameter pvParam muss auf eine DWORD-Variable verweisen, die den neuen Wert enthält.

SPI_GETWINARRANGING muss TRUE sein, um dieses Verhalten zu aktivieren.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETNONCLIENTMETRICS
0x002A
Legt die Metriken fest, die dem Nichtclientbereich von nichtminimierten Fenstern zugeordnet sind. Der parameter pvParam muss auf eine NONCLIENTMETRICS-Struktur verweisen, die die neuen Parameter enthält. Legen Sie den cbSize-Member dieser Struktur und den uiParam-Parameter auf fest sizeof(NONCLIENTMETRICS). Außerdem muss der lfHeight-Member der LOGFONT-Struktur ein negativer Wert sein.
SPI_SETPENDOCKTHRESHOLD
0x0081
Legt den Schwellenwert in Pixel fest, bei dem das Andockverhalten ausgelöst wird, indem ein Fenster mithilfe eines Stifts an den Rand eines Monitors oder Monitorarrays gezogen wird. Der Standardschwellenwert ist 30. Der parameter pvParam muss auf eine DWORD-Variable verweisen, die den neuen Wert enthält.

SPI_GETWINARRANGING muss TRUE sein, um dieses Verhalten zu aktivieren.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETPENDRAGOUTTHRESHOLD
0x0087
Legt den Schwellenwert in Pixel fest, bei dem das Abdockenverhalten ausgelöst wird, indem ein Fenster mithilfe eines Stifts vom Rand eines Monitors oder Monitorarrays in die Mitte gezogen wird. Der Standardschwellenwert ist 30. Der parameter pvParam muss auf eine DWORD-Variable verweisen, die den neuen Wert enthält.

SPI_GETWINARRANGING muss TRUE sein, um dieses Verhalten zu aktivieren.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETPENSIDEMOVETHRESHOLD
0x008B
Legt den Schwellenwert in Pixel vom oberen Rand des Monitors fest, bei dem ein vertikal maximiertes Fenster wiederhergestellt wird, wenn es mit einem Stift gezogen wird. Der Standardschwellenwert ist 50. Der parameter pvParam muss auf eine DWORD-Variable verweisen, die den neuen Wert enthält.

SPI_GETWINARRANGING muss TRUE sein, um dieses Verhalten zu aktivieren.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETSHOWIMEUI
0x006F
Legt fest, ob das IME-Statusfenster auf Benutzerbasis sichtbar ist. Der uiParam-Parameter gibt TRUE für ein oder FALSE für aus an.
SPI_SETSNAPSIZING
0x008F
Legt fest, ob ein Fenster vertikal maximiert wird, wenn es am oberen oder unteren Rand des Monitors ausgerichtet ist. Legen Sie pvParam für ein auf TRUE oder FALSE für aus fest.

SPI_GETWINARRANGING muss TRUE sein, um dieses Verhalten zu aktivieren.

Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

SPI_SETWINARRANGING
0x0083
Legt fest, ob die Fensteranordnung aktiviert ist. Legen Sie pvParam für ein auf TRUE oder FALSE für aus fest.

Die Fensteranordnung reduziert die Anzahl von Maus-, Stift- oder Touchinteraktionen, die zum Verschieben und Vergrößern von Fenstern auf oberster Ebene erforderlich sind, indem das Standardverhalten eines Fensters vereinfacht wird, wenn es gezogen oder vergrößert wird.

Die folgenden Parameter legen individuelle Fensteranordnungseinstellungen fest:

SPI_SETDOCKMOVING
SPI_SETMOUSEDOCKTHRESHOLD
SPI_SETMOUSEDRAGOUTTHRESHOLD
SPI_SETMOUSESIDEMOVETHRESHOLD
SPI_SETPENDOCKTHRESHOLD
SPI_SETPENDRAGOUTTHRESHOLD
SPI_SETPENSIDEMOVETHRESHOLD
SPI_SETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 und Windows XP/2000: Dieser Parameter wird nicht unterstützt.

[in] uiParam

Typ: UINT

Ein Parameter, dessen Verwendung und Format vom abgefragten oder festgelegten Systemparameter abhängt. Weitere Informationen zu systemweiten Parametern finden Sie im UiAction-Parameter . Wenn nicht anders angegeben, müssen Sie null für diesen Parameter angeben.

[in, out] pvParam

Typ: PVOID

Ein Parameter, dessen Verwendung und Format vom abgefragten oder festgelegten Systemparameter abhängt. Weitere Informationen zu systemweiten Parametern finden Sie im UiAction-Parameter . Wenn nicht anders angegeben, müssen Sie null für diesen Parameter angeben. Informationen zum PVOID-Datentyp finden Sie unter Windows-Datentypen.

[in] fWinIni

Typ: UINT

Wenn ein Systemparameter festgelegt wird, gibt an, ob das Benutzerprofil aktualisiert werden soll, und wenn ja, ob die WM_SETTINGCHANGE Nachricht an alle Fenster der obersten Ebene übertragen werden soll, um sie über die Änderung zu informieren.

Dieser Parameter kann null sein, wenn Sie das Benutzerprofil nicht aktualisieren oder die WM_SETTINGCHANGE Nachricht übertragen möchten, oder es kann sich um einen oder mehrere der folgenden Werte handeln.

Wert Bedeutung
SPIF_UPDATEINIFILE
Schreibt die neue systemweite Parametereinstellung in das Benutzerprofil.
SPIF_SENDCHANGE
Sendet die WM_SETTINGCHANGE Nachricht nach dem Aktualisieren des Benutzerprofils.
SPIF_SENDWININICHANGE
Identisch mit SPIF_SENDCHANGE.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Wert ungleich null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Diese Funktion ist für die Verwendung mit Anwendungen vorgesehen, die es dem Benutzer ermöglichen, die Umgebung anzupassen.

Ein Tastaturlayoutname sollte vom Hexadezimalwert des Sprachbezeichners abgeleitet werden, der dem Layout entspricht. Beispielsweise weist US-Englisch den Sprachbezeichner 0x0409 auf, sodass das primäre us-englische Layout "00000409" heißt. Varianten des us-englischen Layouts, wie z. B. das Dvorak-Layout, heißen "00010409", "00020409" usw. Eine Liste der primären Sprachbezeichner und Untersprachebezeichner, aus denen ein Sprachbezeichner besteht, finden Sie im MAKELANGID-Makro .

Es gibt einen Unterschied zwischen dem Farbschema für hohen Kontrast und dem Modus für hohen Kontrast. Das Farbschema Hoher Kontrast ändert die Systemfarben in Farben, die einen offensichtlichen Kontrast aufweisen. Sie wechseln zu diesem Farbschema, indem Sie die Anzeigeoptionen in der Systemsteuerung verwenden. Der Modus mit hohem Kontrast, der SPI_GETHIGHCONTRAST und SPI_SETHIGHCONTRAST verwendet, empfiehlt Anwendungen, ihr Erscheinungsbild für sehbehinderte Benutzer zu ändern. Dies umfasst z. B. akustische Warnungen für Benutzer und ein angepasstes Farbschema (unter Verwendung der Barrierefreiheitsoptionen in der Systemsteuerung). Weitere Informationen finden Sie unter HIGHCONTRAST. Weitere Informationen zu allgemeinen Barrierefreiheitsfeatures finden Sie unter Barrierefreiheit.

Während der Zeit, in der die primäre Schaltfläche gedrückt gehalten wird, um das Mouse ClickLock-Feature zu aktivieren, kann der Benutzer die Maus bewegen. Nachdem die primäre Schaltfläche gesperrt wurde, führt das Loslassen der primären Schaltfläche nicht zu einer WM_LBUTTONUP Meldung. Daher wird es für eine Anwendung angezeigt, dass die primäre Schaltfläche immer noch ausgefallen ist. Jede nachfolgende Schaltflächenmeldung gibt die primäre Schaltfläche frei und sendet eine WM_LBUTTONUP Nachricht an die Anwendung, sodass die Schaltfläche programmgesteuert entsperrt werden kann oder der Benutzer auf eine beliebige Schaltfläche klickt.

Diese API ist nicht DPI-fähig und sollte nicht verwendet werden, wenn der aufrufende Thread pro Monitor DPI-fähig ist. Die DPI-fähige Version dieser API finden Sie unter SystemParametersInfoForDPI. Weitere Informationen zur DPI-Erkennung finden Sie in der Dokumentation zu Windows High DPI.

Beispiele

Im folgenden Beispiel wird systemParametersInfo verwendet, um die Mausgeschwindigkeit zu verdoppeln.


#include <windows.h>
#include <stdio.h>
#pragma comment(lib, "user32.lib")    

void main()  
{     
    BOOL fResult;
    int aMouseInfo[3];    // Array for mouse information
    
    // Get the current mouse speed.         
    fResult = SystemParametersInfo(SPI_GETMOUSE,   // Get mouse information
                                   0,              // Not used
                                   &aMouseInfo,    // Holds mouse information
                                   0);             // Not used           
                                   
    // Double it.         
    if( fResult )     
    {
        aMouseInfo[2] = 2 * aMouseInfo[2];
        
        // Change the mouse speed to the new value.
        SystemParametersInfo(SPI_SETMOUSE,      // Set mouse information
                             0,                 // Not used
                             aMouseInfo,        // Mouse information
                             SPIF_SENDCHANGE);  // Update Win.ini
    }  
}

Hinweis

Der winuser.h-Header definiert SystemParametersInfo 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]
Zielplattform Windows
Kopfzeile winuser.h (windows.h einschließen)
Bibliothek User32.lib
DLL User32.dll
APIs ext-ms-win-ntuser-sysparams-ext-l1-1-0 (eingeführt in Windows 8)

Weitere Informationen

ACCESSTIMEOUT

ANIMATIONINFO

AUDIODESCRIPTION

FILTERKEYS

HIGHCONTRAST

ICONMETRICS

LOGFONT

MAKELANGID

MINIMIERTE METRIKEN

MOUSEKEYS

NICHTCLIENTMETRICS

RECT

SERIALKEYS

SOUNDSENTRY

STICKYKEYS

SystemParametersInfoForDPI

UMSCHALTTASTEN

WM_SETTINGCHANGE

Windows-Datentypen