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 |
|---|---|
|
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).
|
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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.
|
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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.
|
|
Dieser Parameter wird nicht unterstützt.
Windows Server 2003 und Windows XP/2000: Der Benutzer sollte diese Einstellung über die Systemsteuerung steuern. |
|
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. |
|
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).
|
|
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).
|
|
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).
|
|
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).
|
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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).
|
|
Nicht verwenden. |
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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.
|
|
Dieser Parameter wird nicht unterstützt.
Windows Server 2003 und Windows XP/2000: Der Benutzer sollte diese Einstellung über die Systemsteuerung steuern. |
|
Aktiviert oder deaktiviert die Barrierefreiheitsfunktion ShowSounds. Der uiParam-Parameter gibt TRUE für ein oder FALSE für aus an. |
|
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).
|
|
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).
|
|
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 |
|---|---|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Lädt die Systemcursor neu. Legen Sie den uiParam-Parameter auf Null und den parameter pvParam auf NULL fest. |
|
Legt das aktuelle Desktopmuster fest, indem Windows die Einstellung Pattern= aus der WIN.INI-Datei liest. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 |
|---|---|
|
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).
|
|
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. |
|
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 . |
|
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. |
|
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. |
|
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).
|
|
Lädt die Systemsymbole neu. Legen Sie den uiParam-Parameter auf Null und den parameter pvParam auf NULL fest. |
|
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. |
|
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 |
|---|---|
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 . |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
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. |
|
Schaltet den Warn-Beeper ein oder aus. Der uiParam-Parameter gibt TRUE für ein oder FALSE für aus an. |
|
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. |
|
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.
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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.
|
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Legt die aktuelle Stiftgestenvisualisierungseinstellung fest. Der parameter pvParam muss auf eine ULONG-Variable verweisen, die die Einstellung identifiziert. Weitere Informationen finden Sie unter Stiftvisualisierung. |
|
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. |
|
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. |
|
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. |
|
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. |
|
Legt die Anzahl der Zeichen fest, die beim Verschieben des horizontalen Mausrads scrollen sollen. Die Anzahl der Zeichen wird über den uiParam-Parameter festgelegt. |
|
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 |
|---|---|
|
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 . |
|
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. |
|
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. |
|
Legt den Ausrichtungswert von Popupmenüs fest. Der uiParam-Parameter gibt TRUE für die rechtsausrichtung und FALSE für die linke Ausrichtung an. |
|
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. |
|
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.
Im Folgenden sind die Bildschirmschonerparameter aufgeführt.
Im Folgenden sind die Timeoutparameter für Anwendungen und Dienste aufgeführt.
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 |
|---|---|
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
Identisch mit SPI_GETKEYBOARDCUES. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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. |
|
Identisch mit SPI_SETKEYBOARDCUES. |
|
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. |
|
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. |
|
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 . |
|
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 |
|---|---|
|
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. |
|
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. |
|
Ruft die Verzögerung der aktiven Fensternachverfolgung in Millisekunden ab. Der pvParam-Parameter muss auf eine DWORD-Variable verweisen, die die Zeit empfängt. |
|
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).
|
|
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. |
|
Ruft die Caretbreite in Bearbeitungssteuerelementen in Pixel ab. Der pvParam-Parameter muss auf eine DWORD-Variable verweisen, die diesen Wert empfängt. |
|
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. |
|
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. |
|
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 . |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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:
|
|
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. |
|
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. |
|
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. |
|
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).
|
|
Legt den Rahmenmultiplikatorfaktor fest, der die Breite des Größenrahmens eines Fensters bestimmt. Der uiParam-Parameter gibt den neuen Wert an. |
|
Legt die Caretbreite in Bearbeitungssteuerelementen fest. Legen Sie pvParam auf die gewünschte Breite in Pixel fest. Der Standardwert und der Mindestwert ist 1. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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. |
|
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).
|
|
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. |
|
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. |
|
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. |
|
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.
|
|
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. |
|
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. |
|
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. |
|
Legt fest, ob das IME-Statusfenster auf Benutzerbasis sichtbar ist. Der uiParam-Parameter gibt TRUE für ein oder FALSE für aus an. |
|
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. |
|
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:
|
[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 |
|---|---|
|
Schreibt die neue systemweite Parametereinstellung in das Benutzerprofil. |
|
Sendet die WM_SETTINGCHANGE Nachricht nach dem Aktualisieren des Benutzerprofils. |
|
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) |