Die Community zu .NET und Classic VB.
Menü

SystemParametersInfo

 von 

Deklaration  

Declare Function SystemParametersInfo Lib "User32" _
                 Alias "SystemParametersInfoA" ( _
                 ByVal uAction As Long, _
                 ByVal uParam As Long, _
                 ByVal lpvParam As Any, _
                 ByVal fuWinIni As Long) As Long
Weitere Informationen zur Verwendung dieser Funktion finden sie u.U. auch im Artikel SystemParametersInfo des API-Wikis.

SystemParametersInfo ermöglicht systemweite Parameter abzufragen oder zu setzen. Diese Parameter beschreiben Zugriffsfunktionen, Bildschirmschonerphasen, Tastatur- und Mauseinstellungen, Metrik, Menüausrichtung sowie den aktuellen Sprachtreiber. Diese Funktion kann optional aktualiesierte Informationen in die Registry schreiben.

Parameter
uActionEin Befehl der die betreffenden Systemparameter angibt, ebenso ob sie abgefragt oder gesetzt werden sollen.
uParamGenerischer Parameter, dessen Verwendung von der in uAction angegebenen Aktion abhängig ist. In der untenstehenden Tabelle ist eine Liste der Parameter und der mit ihnen verknüpften Aktionen, zum Setzen als auch zum bloßen Auslesen aufgeführt. Wenn der Parameter uParam nicht angegeben ist, sollte dieser auf Null gesetzt werden.
lpvParamGenerischer Parameter, dessen Verwendung von der in uAction angegebenen Aktion abhängig ist.
fuWinIniUnsigned Int Flag, das feststellt, ob das Anwenderprofil in der Registry aktualisiert werden soll. Die untenstehende Tabelle zeigt die Werte die fuWinIni annehmen kann.

Tabelle 1


Auslese Aktionen
SPI_GETACCESSTIMEOUTErmittelt eine ACCESTIMEOUT Struktur, die die Timeout-Periode von Zugriffsfunktionen beschreibt, womit es möglich wird, Tastenkombinationen in aufeinanderfolgenden Tastenanschlägen auszuführen. Der Parameter lpvParam zeigt auf einen Puffer, der die ACCESTIMEOUT Struktur aufnimmt.
SPI_GETANIMATIONErmittelt eine ANIMATIONINFO Struktur, die die Animationseffekte des aktuellen Anwenders beschreibt. Der Parameter lpvParam zeigt auf einen Puffer, der die ANIMATIONINFO Struktur aufnimmt.
SPI_GETBEEPGibt an, ob ein Warnbeep aktiviert ist. Der Paramter lpvParam zeigt auf einen booleschen Wert, der 1 ist wenn der Beep aktiviert ist anderfalls 0.
SPI_BORDERGibt den Rahmengrößen-Multiplikator an, mit dem die Breite und Höhe größenveränderbarer Rahmen im System verändert wird. Der Parameter lpvParam zeigt auf einen UINT , der auf den Rahmengrößen-Multiplikator gesetzt ist.
SPI_GETDRAGFULLWINDOWSSellt fest, ob das Dragging für Fenster aktiviert ist. Der Parameter lpvParam zeigt auf einen booleschen Wert, der 1 ist, wenn das Dragging aktiviert ist, anderfalls 0.
SPI_GETFASTTASKSWITCHStellt fest ob das schnelle Taskswitching aktiviert ist. Der Parameter lpvParam zeigt auf einen booleschen Wert, der 1 ist, wenn diese Funktionalität aktiviert ist, andernfalls 0.
SPI_GETFILTERKEYSErmittelt eine FILTERKEY Struktur, die den Zugriff auf Filterschlüssel beschreibt. Der Parameter lpvParam zeigt auf einen Puffer, der die FILTERKEYS Struktur aufnimmt.
SPI_GETGRIDGRANULARITYErmittelt den Abstand zwischen den Elementen auf dem Windows-Desktop. Der Parameter lpvParam zeigt auf einen UINT , der die Rasterweite des Desktops enthält.
SPI_GETHIGHCONTRASTErmittelt eine HIGHCONTRAST Struktur, die die Funktionalität hoher Kontraste für sehbehinderte Anwender betreibt. Der Parameter lpvParam zeigt auf einen Puffer, der die HIGHCONTRAST Struktur aufnimmt.
SPI_GETICONMETRICSErmittelt eine ICONMETRICS Struktur, die die Metrik der Icons beschreibt. Der Parameter lpvParam zeigt auf einen Puffer, der die ICONMETRICS Struktur aufnimmt.
SPI_GETICONTITLELOFGONTErmittelt eine LOGFONT Struktur, die die Schrift beschreibt, die ein Icon für die Anzeige des Titeltextes verwendet. Der Parameter lpvParam zeigt auf einen Puffer, der die LOGFONT Struktur aufnimmt.
SPI_GETICONTITLEWRAPStellt fest ob der Titelumbruch aktiviert ist. Der Parameter lpvParam zeigt auf einen booleschen Wert, der 1 ist, wenn der Umbruch aktiviert ist, andernfalls 0.
SPI_GETKEYBORDDELAYErmittelt die Tasten-Wiederholungsverzögerung der Tastatur. Der Parameter lpvParam zeigt auf eine UINT Variable, die die aktuelle Verzögerung aufnimmt.
SPI_GETKEYBOARDPREFStellt fest, ob der Anwender möchte, daß Anwendungen verborgene Tastaturschnittstellen anzeigen, wenn er die Tastatur der Maus vorzieht. Der Parameter lpvParam zeigt auf einen booleschen Wert, der 1 ist wenn diese Bedingung zutrifft, andernfalls 0.
SPI_GETKEYBOARDSPEEDErmittelt die Tastenwiederholgeschwindigkeit der Tastatur. Der Parameter lpvParam zeigt auf eine UINT Variable, die die aktuelle Wiederholgeschwindigkeit der Tastatur aufnimmmt.
SPI_GETLOWPOWERACTIVEStellt fest ob eine stromsparende Bildschirmschonerphase aktiv ist. Das erlaubt Bildschirmschonern ihr Verhalten anzupassen, um wenig Strom zu verbrauchen. Der Parameter lpvParam zeigt auf boolesche Variable die 1 ist, wenn diese Phase aktiv ist, andernfalls 0.
SPI_GETLOWPOWERTIMEOUTErmittelt den Timeoutfaktor der stromsparenden Bildschirmschonerphase. Wenn der Strom knapp ist, kann ein Bildschirmschoner einen anderen Timeout-Faktor verwenden. Der Parameter lpvParam zeigt auf eine UINT Variable, die den aktuellen Timeout-Faktor aufnimmt.
SPI_GETMENUDROPALIGNMENTStellt fest, ob Popup-Menüs recht oder links vom aufrufenden Menülelement dargestellt werden. Der Parameter lpvParam zeigt auf eine boolesche Variable, die 1 ist, wenn die Popup-Menüs rechts ausgerichtet und 0 falls sie linksgerichtet sind.
SPI_GETMINIMIZEDMETRICSErmittelt eine MINIMIZEDMETRICS Struktur, die die Metric minimierter Fenster beschreibt. Der Parameter lpvParam zeigt auf einen Puffer, der die MINIMIZEDMETRICS Struktur aufnimmt.
SPI_GETMOUSEErmittelt die Mausschnelle und -geschwindigkeit. Diese Daten werden in einer MOUSEKEYS Struktur abgelegt. Der Parameter lpvParam zeigt auf einen Puffer, der die MOUSEKEYS Struktur aufnimmt.
SPI_GETNONCLIENTMETRICSErmittelt die Metric für den NonClient- [NC] Bereich nicht minimierter Fenster in einer NONCLIENTMETRICS Struktur. Der Parameter lpvParam zeigt auf einen Puffer, der die NONCLIENTMETRICS Struktur aufnimmt.
SPI_GETPOWEROFFACTIVEErmittelt den Timeout-Wert für die Bildschirmausschaltphase. Der Parameter lpvParam zeigt auf eine UINT Variable die den aktuellen Timeout-Faktor aufnimmt.
SPI_GETSCREENREADERStellt fest, ob eine Utility den Text auf dem Bildschirm auf eine Braille-Anzeige oder einen Sprachsynthesizer umleitet. Die Abfrage dieser Einstellungen ermöglicht es Anwendungen, die Software für sehbehinderte Anwender zu aktivieren, indem grafische Daten als Sprache oder Braille-Code ausgegeben werden. Der Parameter lpvParam zeigt auf einen booleschen Wert, der 1 ist, wenn ein solches Tool installiert ist und 0 ist, falls nicht.
SPI_GETSCREENSAVEACTIVEStellt fest ob der Bildschirmschoner aktiviert ist. Der Parameter lpvParam zeigt auf einen booleschen Wert, der 1 ist, wenn der Screen Saver aktiviert ist, andernfalls 0.
SPI_GETSERIALKEYSErmittelt eine SERIALKEYS Struktur, die beschreibt ob der serielle Tastenzugriff aktiviert ist. Der Parameter lpvParam zeigt auf einen Puffer der die SERIALKEYS Daten aufnimmt.
SPI_GETSHOWSOUNDSStellt fest, ob der Anwender die visuelle Darstellung von Sounds benötigt. Das ermöglicht Anwendungen, Software für gehörlose Anwender zu aktivieren, indem Sounds als grafische Daten ausgegeben werden. Der Parameter lpvParam zeigt auf einen booleschen Wert, der auf 1 gesetzt wird, wenn diese Funktionalität aktiviert ist, andernfalls 0.
SPI_GETSOUNSENTRYErmittelt eine SOUNDSENTRY Struktur, die die Parameter der Sounds-Eintrags-Funktionalität beschreibt. Der Parameter lpvParam zeigt auf einen Puffer, der die SOUNDSENTRY Struktur aufnimmt.
SPI_GETSTICKYKEYSErmittelt eine STICKYKEYS Struktur, die die Parameter der Sticky-Tasten beschreibt. Der Parameter lpvParam zeigt auf einen Puffer, der die STICKYKEYS Struktur aufnimmt.
SPI_GETTOGGLEKEYSErmittelt eine TOGGLEKEY Struktur, die die Parameter der Umschalttasten beschreibt. Dabei wir ein hoher Ton ausgegeben, wenn eine der Modifizier-Tasten gedrückt wird, ein tiefer Ton wenn sie losgelassen wird. Der Parameter lpvParam zeigt auf einen Puffer, der die TOGGLEKEY Struktur aufnimmt.
SPI_GETWORKAREAErmittelt die Größe des Arbeitsbereichs auf dem Desktop. Der Parameter lpvParam zeigt auf die Adresse eines RECT Puffers, der das Ausmaß des Arbeitsbereichs aufnimmt.

Tabelle 2


Setz Aktionen
SPI_ICONHORIZONTALSPACINGÄndert die horizontalen Abstände der ICONS. Der Parameter uParam wird auf die Anzahl der Pixel für diesen Abstand gesetzt.
SPI_ICONVERTIKALSPACINGÄndert die vertikalen Abstände der ICONS. Der Parameter uParam wird auf die Anzahl der Pixel für diesen Abstand gesetzt.
SPI_LANGDRIVERErmittelt den Namen des Sprachtreibers . Der Paramter lpvParam muß auf den Puffer gesetzt werden, der den Namen des Sprachtreibers aufnehmen soll.
SPI_SETACCESTIMEOUTSetzt eine ACCESSTIMEOUT Struktur, der die Timeout-Periode von Zugriffsfunktionnen beschreibt. Der Paramter lpvParam muß auf die zu setztende ACCESSTIMEOUT Struktur zeigen.
SPI_SETANIMATIONSetzt eine ANIMATIONINFO Sruktur, die die Animationseffekte des aktuellen Anwenders beschreibt. Der Paramter lpvParam muß auf die zu setzende ANIMATIONINFO Struktur verweisen.
SPI_SETBEEPSchaltet den Warnbeep an oder aus. Der Parameter uParam wird als boolescher Wert genutzt. Ist er auf 1, ist der Warnbeep an, andernfalls ist er aus.
SPI_SETBORDERSetzt den Rahmengrößen-Multiplikator
SPI_SETDESKPATTERNSetzt das hintergrundmuster für den Desktop auf den aktuellen Wert des Patternschlüssels der WIN.INI. Setzt das Desktop-Muster auf das aktuell selektierte Muster [aus der WIN.INI]. Diese Option hat keine Parameter.
SPI_SETDESKWALLPAPERSetzt die Tapete für den Desktop-Hintergrund. Der Paramter lpvParam muß die dafür herangezogene Datei enthalten.
SPI_SETDOUBLECLICKTIMESetzt das Intervall zwischen zwei Klicks in Millisekunden, die als Doppelklick zu interpretieren sind.
SPI_SETDOUBLECLKHEIGHTSetzt den horizontalen Abstand, der Interpretation eines zweiten Klicks als Doppelklick zuläßt.
SPI_SETDOUBLECLKWIDTHSetzt den vertikalen Abstand, der Interpretation eines zweiten Klicks als Doppelklick zuläßt.
SPI_SETDRAGFULLWINDOWSchaltet das Dragging von Fenstern ab.
SPI_SETFASTTASKSWITCHSchaltet das schnelle Taskswitching an oder aus.
SPI_SETFILTERKEYSSetzt die Daten für den Zugriff auf Filtertasten. Der Parameter lpvParam muß auf die Struktur der zu setzenden FILTERKEY Struktur zeigen.
SPI_SETGRIDGRANULARITYSetzt die Abstände zwischen den platzierten Elementen.
SPI_SETHIGHCONTRASTSetzt die Zugriffsparameter für hohen Kontrast. Der Parameter lpvParam muß auf die Struktur der zu setzenden HIGHCONTRAST Struktur zeigen.
SPI_SETICONMETRICSErlaubt daß die Metrik für die Icons geändert wird. Der Parameter lpvParam muß auf die Struktur der zu setzenden ICONMETRICS Struktur zeigen.
SPI_SETICONTITLELOGFONTSetzt die Schrift für den Titeltext von Icons. Der Parameter lpvParam muß auf die Struktur der zu setzenden LOGFONT Struktur zeigen.
SPI_SETICONTITLEWRAPSchaltet den Umbruch für den ICON-Titel an oder aus. Der Parameter uParam wird als boolescher Wert verwendet der den Umbruch mit 1 an- und durch 0 ausschaltet.
SPI_SETKEYBOARDDELAYSetzt die Tastenwiederholverzögerung. Der Parameter uParam wird auf die Anzahl der Millisekunden gesetzt, die vor der ersten Widerholung verstreichen sollen.
SPI_SETKEYBOARDPREFBestimmt, daß die verborgenen Tastaturschnittstellen angezeigt werden, die die Mausschnittstelle ersetzen. Der Parameter uParam wird auf 1 gesetzt, um die Option zu aktivieren, auf 0 um die normale Darstellung zu realisieren.
SPI_SETKEYBOARDSPEEDSetzt die Wiederholgeschwindigkeit der Tastatur. Der Parameter uParam wird auf die Anzahl der Millisekunden zwischen den einzelnen Widerholungen gesetzt.
SPI_SETLOWPOWERACTIVEAktivier die stromsparende Bildschirmschonerphase. Der Parameter uParam speichert den Timeout-Faktor, angegeben in Sekunden.
SPI_SETMENUDROPALIGNMENTSetzt die Ausrichtung von DropDown-Menüs. Wenn uParam gleich 1 ist, werden die Popup-Menüs links ausgerichtet, ist er gleich 0, werden sie rechts ausgerichtet.
SPI_SETMINIMIZEDMETRICSSetzt die Metrik von minimierten Fenstern. Der Parameter lpvParam zeigt auf ein Array der drei UINT Werte. Diese Werte stellen die x- und y-Schwelle sowie die Mausgeschwindigkeit dar.
SPI_SETMOUSEBUTTONSSWAPSchaltet die Bedeutung der und der rechten Maustaste um, falls uParam 1 ist. Ist uParam gleich 0, wird der ursprüngliche Zustand wiederhergestellt.
SPI_SETMOUSEKEYSSetzt die optionalen Daten für den Maustastenzugriff. Der Parameter lpvParam muß auf die zu setzende MOUSEKEYS Struktur gesetzt werden.
SPI_SETNONCLIENTMETRICSSetzt die Metrik für den NonClient [NC] Bereich nicht minimierter Fenster.
SPI_SETPENWINDOWSGibt an, daß die Pen-Fenster, für uParam gleich 1, geladen oder für uParam gleich 0 entladen werden.
SPI_SETPOWEROFFACTIVESetzt die Stromabschaltphasen des Bildschirmschoners. Wenn uParam gleich 1 ist und diese Funktion aufgerufen wird, wird die Stromabschaltphase initiiert.
SPI_SETPOWEROFFTIMEOUTSetzt den Timeout-Wert für die Stromabschaltphase des Bildschirmschoners. Der Parameter uParam wird auf die Sekundenzahl der Idle-Zeit, die vertreichen muß, bevor die Stromabschaltpahse initiiert wird.
SPI_SETSCREENREADERGibt an, daß ein Sreen-Reader ausgeführt wird, wenn uParam auf 1 gesetzt ist.
SPI_SETSCREENSAVEACTIVEAktiviert für uParam gleich 1 oder deaktiviert für uParam gleich 0 den Bildschirmschoner.
SPI_SETSERIALKEYSSetzt die optionsdaten für den seriellen Tastenzugriff. Der Paramter lpvParam muß auf die Adresse der zu setzenden SERIALKEYS Struktur gesetzt werden.
SPI_SETSHOWSOUNDSAktiviert für uParam gleich 1 oder deaktiviert für uParam gleich 0 den Sound-Anzeigemodus.
SPI_SETSOUNDSENTRYOptionsdaten für den Soundeintragszugriff. Der Parameter lpvParam muß auf die Adresse der zu setzenden SOUNDSENTRY Struktur verweisen.
SPI_SETSTICKYKEYSSetzt die Optionsdaten für die Verfügbarkeit von Sticky-Tasten. Der Paramter lpvParam muß auf die Adresse der zu setzenden STICKYKEYS Struktur verweisen.
SPI_SETTOGGLEKEYSSetzt die Togglekeys-Daten. Der Parameter lpvParam muß auf die Adresse der zu setzenden TOGGLEKEYS Struktur verweisen.

Tabelle 3


Optionen für fuWinIni
SPIF_UPDATEINIFILESchreibt die Änderungen in die Registry.
SPIF_SENDCHANGEÜberträgt die WM_WININICHANGE , nachdem das Anwenderprofil geändert wurde.

Tabelle 4


Rückgabewerte
1Die Funktion wurde erfolgreich ausgeführt.
0Es lag ein Fehler vor.

Tabelle 5


Unterstützte Betriebssysteme
Win32s, Windows 95, Windows 98, Windows NT

Verwandte API-Funktionen
GetLastError, GetSystemMetrics, mouse_event

Zugehörige Tipps

Zugehörige Microsoft Knowledge Base Artikel