Funzione SystemParametersInfoW (winuser.h)

Importante

Alcune informazioni si riferiscono a un prodotto di versione preliminare che può essere modificato in modo sostanziale prima che venga rilasciato commercialmente. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Recupera o imposta il valore di uno dei parametri a livello di sistema. Questa funzione può anche aggiornare il profilo utente durante l'impostazione di un parametro.

Sintassi

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

Parametri

[in] uiAction

Tipo: UINT

Parametro a livello di sistema da recuperare o impostare. I valori possibili sono organizzati nelle tabelle seguenti di parametri correlati:

  • Parametri di accessibilità
  • Parametri desktop
  • Parametri icona
  • Parametri di input
  • Parametri del menu
  • Parametri di alimentazione
  • Parametri di screen saver
  • Parametri di timeout
  • Parametri degli effetti dell'interfaccia utente
  • Parametri finestra

Di seguito sono riportati i parametri di accessibilità.

Parametro di accessibilità Significato
SPI_GETACCESSTIMEOUT
0x003C
Recupera informazioni sul periodo di timeout associato alle funzionalità di accessibilità. Il parametro pvParam deve puntare a una struttura ACCESSTIMEOUT che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(ACCESSTIMEOUT).
SPI_GETAUDIODESCRIPTION
0x0074
Determina se le descrizioni audio sono abilitate o disabilitate. Il parametro pvParam è un puntatore a una struttura AUDIODESCRIPTION . Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(AUDIODESCRIPTION).

Anche se è possibile che gli utenti che hanno problemi visivi per ascoltare l'audio nel contenuto video, c'è un sacco di azione nel video che non ha audio corrispondente. Descrizione audio specifica di ciò che accade in un video aiuta questi utenti a comprendere meglio il contenuto. Questo flag consente di determinare se le descrizioni audio sono state abilitate e in quale lingua.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETCLIENTAREAANIMATION
0x1042
Determina se le animazioni sono abilitate o disabilitate. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se le animazioni sono abilitate o FALSE in caso contrario.

Visualizzare funzionalità come flashing, blinking, flickering e lo spostamento di contenuti possono causare la crisi negli utenti con l'epilessia sensibile alle foto. Questo flag consente di determinare se tali animazioni sono state disabilitate nell'area client.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETDISABLEOVERLAPPEDCONTENT
0x1040
Determina se il contenuto sovrapposto è abilitato o disabilitato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE in caso contrario.

Visualizzare funzionalità come immagini di sfondo, sfondo tramato, segni d'acqua su documenti, fusione alfa e trasparenza può ridurre il contrasto tra primo piano e sfondo, rendendo più difficile per gli utenti con bassa visione di visualizzare gli oggetti sullo schermo. Questo flag consente di determinare se tale contenuto sovrapposto è stato disabilitato.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETFILTERKEYS
0x0032
Recupera informazioni sulla funzionalità di accessibilità FilterKeys. Il parametro pvParam deve puntare a una struttura FILTERKEYS che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(FILTERKEYS).
SPI_GETFOCUSBORDERHEIGHT
0x2010
Recupera l'altezza, in pixel, dei bordi superiore e inferiore del rettangolo di messa a fuoco disegnato con DrawFocusRect. Il parametro pvParam deve puntare a un valore UINT .

Windows 2000: Questo parametro non è supportato.

SPI_GETFOCUSBORDERWIDTH
0x200E
Recupera la larghezza, in pixel, dei bordi sinistro e destro del rettangolo dello stato attivo disegnato con DrawFocusRect. Il parametro pvParam deve puntare a un oggetto UINT.

Windows 2000: Questo parametro non è supportato.

SPI_GETHIGHCONTRAST
0x0042
Recupera informazioni sulla funzionalità di accessibilità HighContrast. Il parametro pvParam deve puntare a una struttura HIGHCONTRAST che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(HIGHCONTRAST).

Per una discussione generale, vedere Osservazioni.

SPI_GETLOGICALDPIOVERRIDE
0x009E
Recupera un valore che determina se Windows 8 visualizza le app usando l'area di ridimensionamento predefinita per l'hardware o passando al successivo piano superiore. Questo valore si basa sull'impostazione corrente "Rendi tutto più grande sullo schermo", trovata nella sezione Facilità di accesso delle impostazioni del PC: 1 è attiva, 0 è disattivata.

Le app possono fornire risorse di testo e immagine per ogni piano di scalabilità: 100%, 140%e 180%. La fornitura di risorse separate ottimizzate per una determinata scala evita la distorsione a causa del ridimensionamento. Windows 8 determina il ridimensionamento appropriato in base a diversi fattori, tra cui dimensioni dello schermo e densità di pixel. Quando viene selezionato "Crea tutto sullo schermo più grande" (SPI_GETLOGICALDPIOVERRIDE restituisce un valore 1), Windows usa le risorse dall'altopiano superiore successivo. Ad esempio, nel caso di hardware determinato da Windows deve usare una scala di SCALE_100_PERCENT, questo override causa l'uso del valore di scalabilità di Windows SCALE_140_PERCENT, presupponendo che non viola altri vincoli.

Nota Non è consigliabile usare questo valore. Potrebbe essere modificato o non disponibile nelle versioni successive di Windows. Usare invece la funzione GetScaleFactorForDevice o la classe DisplayProperties per recuperare il fattore di ridimensionamento preferito. Le applicazioni desktop devono usare dpi logici desktop anziché fattore di scalabilità. È possibile recuperare dpi logici desktop tramite la funzione GetDeviceCaps .
 
SPI_GETMESSAGEDURATION
0x2016
Recupera l'ora in cui devono essere visualizzati i popup di notifica, in secondi. Il parametro pvParam deve puntare a un ULONG che riceve la durata del messaggio.

Gli utenti con problemi visivi o condizioni cognitive, ad esempio ADHD e dislessia, potrebbero richiedere più tempo per leggere il testo nei messaggi di notifica. Questo flag consente di recuperare la durata del messaggio.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETMOUSECLICKLOCK
0x101E
Recupera lo stato della funzionalità Mouse ClickLock. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE in caso contrario. Per altre informazioni, vedere Panoramica dell'input del mouse.

Windows 2000: Questo parametro non è supportato.

SPI_GETMOUSECLICKLOCKTIME
0x2008
Recupera il ritardo di tempo prima del blocco del pulsante del mouse primario. Il parametro pvParam deve puntare a DWORD che riceve il ritardo di tempo, espresso in millisecondi. Questa opzione è abilitata solo se SPI_SETMOUSECLICKLOCK è impostato su TRUE. Per altre informazioni, vedere Panoramica dell'input del mouse.

Windows 2000: Questo parametro non è supportato.

SPI_GETMOUSEKEYS
0x0036
Recupera informazioni sulla funzionalità di accessibilità MouseKeys. Il parametro pvParam deve puntare a una struttura MOUSEKEYS che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(MOUSEKEYS).
SPI_GETMOUSESONAR
0x101C
Recupera lo stato della funzionalità Sonar del mouse. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE in caso contrario. Per altre informazioni, vedere Panoramica dell'input del mouse.

Windows 2000: Questo parametro non è supportato.

SPI_GETMOUSEVANISH
0x1020
Recupera lo stato della funzionalità Svanire il mouse. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE in caso contrario. Per altre informazioni, vedere Panoramica dell'input del mouse.

Windows 2000: Questo parametro non è supportato.

SPI_GETSCREENREADER
0x0046
Determina se è in esecuzione un'utilità di revisore dello schermo. Un'utilità di revisore dello schermo indirizza le informazioni testuali a un dispositivo di output, ad esempio un sintetizzatore vocale o una visualizzazione Braille. Quando questo flag è impostato, un'applicazione deve fornire informazioni testuali in situazioni in cui altrimenti presenterebbero le informazioni graficamente.

Il parametro pvParam è un puntatore a una variabile BOOL che riceve TRUE se è in esecuzione un'utilità di revisore dello schermo o FALSE in caso contrario.

Nota Assistente vocale, l'utilità per la lettura dello schermo inclusa in Windows, non imposta i flag SPI_SETSCREENREADER o SPI_GETSCREENREADER .
 
SPI_GETSERIALKEYS
0x003E
Questo parametro non è supportato.

Windows Server 2003 e Windows XP/2000: L'utente deve controllare questa impostazione tramite il Pannello di controllo.

SPI_GETSHOWSOUNDS
0x0038
Determina se il flag di accessibilità Mostra suoni è attivato o disattivato. In caso affermativo, l'utente richiede a un'applicazione di presentare visivamente le informazioni in situazioni in cui altrimenti presenterebbe le informazioni solo in forma udibile. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se la funzionalità è attivata o FALSE se è disattivata.

L'uso di questo valore equivale a chiamare GetSystemMetrics con SM_SHOWSOUNDS. Questa è la chiamata consigliata.

SPI_GETSOUNDSENTRY
0x0040
Recupera informazioni sulla funzionalità di accessibilità SoundSentry. Il parametro pvParam deve puntare a una struttura SOUNDSENTRY che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(SOUNDSENTRY).
SPI_GETSTICKYKEYS
0x003A
Recupera informazioni sulla funzionalità di accessibilità StickyKeys. Il parametro pvParam deve puntare a una struttura STICKYKEYS che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(STICKYKEYS).
SPI_GETTOGGLEKEYS
0x0034
Recupera informazioni sulla funzionalità di accessibilità ToggleKeys. Il parametro pvParam deve puntare a una struttura TOGGLEKEYS che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(TOGGLEKEYS).
SPI_SETACCESSTIMEOUT
0x003D
Imposta il periodo di timeout associato alle funzionalità di accessibilità. Il parametro pvParam deve puntare a una struttura ACCESSTIMEOUT che contiene i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(ACCESSTIMEOUT).
SPI_SETAUDIODESCRIPTION
0x0075
Attiva o disattiva la funzionalità descrizioni audio. Il parametro pvParam è un puntatore a una struttura AUDIODESCRIPTION .

Anche se è possibile che gli utenti con problemi di vista sentano l'audio nel contenuto video, c'è un sacco di azione nel video che non ha audio corrispondente. Una descrizione audio specifica di ciò che accade in un video consente agli utenti di comprendere meglio il contenuto. Questo flag consente di abilitare o disabilitare le descrizioni audio nelle lingue in cui sono disponibili.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETCLIENTAREAANIMATION
0x1043
Attiva o disattiva le animazioni dell'area client. Il parametro pvParam è una variabile BOOL . Impostare pvParam su TRUE per abilitare animazioni e altri effetti temporanei nell'area client o FALSE per disabilitarle.

Le funzionalità di visualizzazione, ad esempio lampeggiamento, sfarfallio, sfarfallio e spostamento di contenuti possono causare crisi negli utenti con epilessia sensibile alla foto. Questo flag consente di abilitare o disabilitare tutte queste animazioni.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETDISABLEOVERLAPPEDCONTENT
0x1041
Attiva o disattiva il contenuto sovrapposto( ad esempio immagini di sfondo e filigrane). Il parametro pvParam è una variabile BOOL . Impostare pvParam su TRUE per disabilitare il contenuto sovrapposto o FALSE per abilitare il contenuto sovrapposto.

Le funzionalità di visualizzazione, ad esempio immagini di sfondo, sfondi con trama, segni d'acqua su documenti, fusione alfa e trasparenza possono ridurre il contrasto tra il primo piano e lo sfondo, rendendo più difficile per gli utenti con una visione bassa visualizzare gli oggetti sullo schermo. Questo flag consente di abilitare o disabilitare tutto questo contenuto sovrapposto.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETFILTERKEYS
0x0033
Imposta i parametri della funzionalità di accessibilità FilterKeys. Il parametro pvParam deve puntare a una struttura FILTERKEYS che contiene i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(FILTERKEYS).
SPI_SETFOCUSBORDERHEIGHT
0x2011
Imposta l'altezza dei bordi superiore e inferiore del rettangolo di messa a fuoco disegnato con DrawFocusRect sul valore del parametro pvParam .

Windows 2000: Questo parametro non è supportato.

SPI_SETFOCUSBORDERWIDTH
0x200F
Imposta l'altezza dei bordi sinistro e destro del rettangolo di stato attivo disegnato con DrawFocusRect sul valore del parametro pvParam .

Windows 2000: Questo parametro non è supportato.

SPI_SETHIGHCONTRAST
0x0043
Imposta i parametri della funzionalità di accessibilità HighContrast. Il parametro pvParam deve puntare a una struttura HIGHCONTRAST contenente i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(HIGHCONTRAST).
SPI_SETLOGICALDPIOVERRIDE
0x009F
Non usare.
SPI_SETMESSAGEDURATION
0x2017
Imposta l'ora in cui devono essere visualizzati i popup di notifica, in secondi. Il parametro pvParam specifica la durata del messaggio.

Gli utenti con problemi visivi o condizioni cognitive, ad esempio ADHD e dislessia, potrebbero richiedere più tempo per leggere il testo nei messaggi di notifica. Questo flag consente di impostare la durata del messaggio.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETMOUSECLICKLOCK
0x101F
Attiva o disattiva la funzionalità di accessibilità Mouse ClickLock. Questa funzionalità blocca temporaneamente il pulsante del mouse primario quando il pulsante viene fatto clic e premuto per il tempo specificato da SPI_SETMOUSECLICKLOCKTIME. Il parametro pvParam specifica TRUE per on o FALSE per disattivato. Il valore predefinito è off. Per altre informazioni, vedere Osservazioni e Input AboutMouse.

Windows 2000: Questo parametro non è supportato.

SPI_SETMOUSECLICKLOCKTIME
0x2009
Regola il ritardo di tempo prima del blocco del pulsante del mouse primario. Il parametro uiParam deve essere impostato su 0. Il parametro pvParam punta a un DWORD che specifica il ritardo di tempo in millisecondi. Ad esempio, specificare 1000 per un ritardo di 1 secondo. Il valore predefinito è 1200. Per altre informazioni, vedere Panoramica dell'input del mouse.

Windows 2000: Questo parametro non è supportato.

SPI_SETMOUSEKEYS
0x0037
Imposta i parametri della funzionalità di accessibilità MouseKeys. Il parametro pvParam deve puntare a una struttura MOUSEKEYS contenente i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(MOUSEKEYS).
SPI_SETMOUSESONAR
0x101D
Disattiva o disattiva la funzionalità di accessibilità Sonar. Questa funzionalità mostra brevemente diversi cerchi concentrici intorno al puntatore del mouse quando l'utente preme e rilascia il tasto CTRL. Il parametro pvParam specifica TRUE per on e FALSE per off. Il valore predefinito è off. Per altre informazioni, vedere Panoramica dell'input del mouse.

Windows 2000: Questo parametro non è supportato.

SPI_SETMOUSEVANISH
0x1021
Attiva o disattiva la funzionalità Vanish. Questa funzionalità nasconde il puntatore del mouse quando l'utente digita; il puntatore viene visualizzato quando l'utente sposta il mouse. Il parametro pvParam specifica TRUE per on e FALSE per off. Il valore predefinito è off. Per altre informazioni, vedere Panoramica dell'input del mouse.

Windows 2000: Questo parametro non è supportato.

SPI_SETSCREENREADER
0x0047
Determina se è in esecuzione un'utilità di revisione dello schermo. Il parametro uiParam specifica TRUE per on o FALSE per disattivato.
Nota Assistente vocale, l'utilità di lettura dello schermo inclusa in Windows, non imposta i flag di SPI_SETSCREENREADER o di SPI_GETSCREENREADER .
 
SPI_SETSERIALKEYS
0x003F
Questo parametro non è supportato.

Windows Server 2003 e Windows XP/2000: L'utente deve controllare questa impostazione tramite il pannello di controllo.

SPI_SETSHOWSOUNDS
0x0039
Disattiva o disattiva la funzionalità di accessibilità ShowSounds. Il parametro uiParam specifica TRUE per on o FALSE per disattivato.
SPI_SETSOUNDSENTRY
0x0041
Imposta i parametri della funzionalità di accessibilità SoundSentry . Il parametro pvParam deve puntare a una struttura SOUNDSENTRY contenente i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(SOUNDSENTRY).
SPI_SETSTICKYKEYS
0x003B
Imposta i parametri della funzionalità di accessibilità StickyKeys. Il parametro pvParam deve puntare a una struttura STICKYKEYS contenente i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(STICKYKEYS).
SPI_SETTOGGLEKEYS
0x0035
Imposta i parametri della funzionalità di accessibilità ToggleKeys. Il parametro pvParam deve puntare a una struttura TOGGLEKEYS contenente i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(TOGGLEKEYS).
 

Di seguito sono riportati i parametri desktop.

Parametro desktop Significato
SPI_GETCLEARTYPE
0x1048
Determina se ClearType è abilitato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se ClearType è abilitato o FALSE in caso contrario.

ClearType è una tecnologia software che migliora la leggibilità del testo nei monitor LCD (Liquid Crystal Display).

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETDESKWALLPAPER
0x0073
Recupera il percorso completo del file bitmap per lo sfondo desktop. Il parametro pvParam deve puntare a un buffer per ricevere la stringa di percorso con terminazione null. Impostare il parametro uiParam sulle dimensioni, in caratteri, del buffer pvParam . La stringa restituita non supererà MAX_PATH caratteri. Se non esiste uno sfondo desktop, la stringa restituita è vuota.
SPI_GETDROPSHADOW
0x1024
Determina se l'effetto ombreggiatura a discesa è abilitato. Il parametro pvParam deve puntare a una variabile BOOL che restituisce TRUE se abilitata o FALSE se disabilitata.

Windows 2000: Questo parametro non è supportato.

SPI_GETFLATMENU
0x1022
Determina se i menu utente nativi hanno un aspetto del menu flat. Il parametro pvParam deve puntare a una variabile BOOL che restituisce TRUE se l'aspetto del menu flat è impostato o FALSE in caso contrario.

Windows 2000: Questo parametro non è supportato.

SPI_GETFONTSMOOTHING
0x004A
Determina se la funzionalità di smoothing del tipo di carattere è abilitata. Questa funzionalità usa l'antialiasing dei tipi di carattere per rendere le curve dei tipi di carattere più fluide di disegnare pixel a livelli di grigio diversi.

Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se la funzionalità è abilitata o FALSE se non è.

SPI_GETFONTSMOOTHINGCONTRAST
0x200C
Recupera un valore di contrasto utilizzato in ClearType smoothing. Il parametro pvParam deve puntare a un oggetto UINT che riceve le informazioni. I valori di contrasto validi sono compresi tra 1000 e 2200. Il valore predefinito è 1400.

Windows 2000: Questo parametro non è supportato.

SPI_GETFONTSMOOTHINGORIENTATION
0x2012
Recupera l'orientamento di smoothing del tipo di carattere. Il parametro pvParam deve puntare a un oggetto UINT che riceve le informazioni. I valori possibili sono FE_FONTSMOOTHINGORIENTATIONBGR (blu-verde-rosso) e FE_FONTSMOOTHINGORIENTATIONRGB (rosso-verde-blu).

Windows XP/2000: Questo parametro non è supportato fino a quando Windows XP con SP2.

SPI_GETFONTSMOOTHINGTYPE
0x200A
Recupera il tipo di smoothing del tipo di carattere. Il parametro pvParam deve puntare a un oggetto UINT che riceve le informazioni. I valori possibili sono FE_FONTSMOOTHINGSTANDARD e FE_FONTSMOOTHINGCLEARTYPE.

Windows 2000: Questo parametro non è supportato.

SPI_GETWORKAREA
0x0030
Recupera le dimensioni dell'area di lavoro nel monitor di visualizzazione primario. L'area di lavoro è la parte dello schermo non oscurata dalla barra delle applicazioni o dalle barre degli strumenti desktop dell'applicazione. Il parametro pvParam deve puntare a una struttura RECT che riceve le coordinate dell'area di lavoro, espressa in dimensioni del pixel fisico. Qualsiasi modalità di virtualizzazione DPI del chiamante non ha alcun effetto su questo output.

Per ottenere l'area di lavoro di un monitor diverso dal monitor di visualizzazione primario, chiamare la funzione GetMonitorInfo .

SPI_SETCLEARTYPE
0x1049
Attiva o disattiva ClearType. Il parametro pvParam è una variabile BOOL . Impostare pvParam su TRUE per abilitare ClearType o FALSE per disabilitarlo.

ClearType è una tecnologia software che migliora la leggibilità del testo nei monitor LCD.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETCURSORS
0x0057
Ricarica i cursori di sistema. Impostare il parametro uiParam su zero e il parametro pvParam su NULL.
SPI_SETDESKPATTERN
0x0015
Imposta il modello desktop corrente causando a Windows di leggere l'impostazione Pattern= dal file WIN.INI.
SPI_SETDESKWALLPAPER
0x0014
Nota Quando viene usato il flag SPI_SETDESKWALLPAPER , SystemParametersInfo restituisce TRUE a meno che non esista un errore, ad esempio quando il file specificato non esiste.
 
SPI_SETDROPSHADOW
0x1025
Abilita o disabilita l'effetto ombreggiatura a discesa. Impostare pvParam su TRUE per abilitare l'effetto ombreggiatura a discesa o FALSE per disabilitarlo. È anche necessario avere CS_DROPSHADOW nello stile della classe finestra.

Windows 2000: Questo parametro non è supportato.

SPI_SETFLATMENU
0x1023
Abilita o disabilita l'aspetto del menu flat per i menu utente nativi. Impostare pvParam su TRUE per abilitare l'aspetto del menu flat o FALSE per disabilitarlo.

Se abilitata, la barra dei menu usa COLOR_MENUBAR per lo sfondo della barra dei menu, COLOR_MENU per lo sfondo del menu popup, COLOR_MENUHILIGHT per il riempimento della selezione del menu corrente e COLOR_HILIGHT per la struttura della selezione del menu corrente. Se disabilitato, i menu vengono disegnati usando le stesse metriche e colori di Windows 2000.

Windows 2000: Questo parametro non è supportato.

SPI_SETFONTSMOOTHING
0x004B
Abilita o disabilita la funzionalità di smoothing del tipo di carattere, che usa l'antialiasing dei tipi di carattere per rendere le curve dei tipi di carattere più fluide per disegnare pixel a livelli di grigio diversi.

Per abilitare la funzionalità, impostare il parametro uiParam su TRUE. Per disabilitare la funzionalità, impostare uiParam su FALSE.

SPI_SETFONTSMOOTHINGCONTRAST
0x200D
Imposta il valore di contrasto utilizzato in ClearType smoothing. Il parametro pvParam è il valore di contrasto. I valori di contrasto validi sono compresi tra 1000 e 2200. Il valore predefinito è 1400.

SPI_SETFONTSMOOTHINGTYPE deve essere impostato anche su FE_FONTSMOOTHINGCLEARTYPE.

Windows 2000: Questo parametro non è supportato.

SPI_SETFONTSMOOTHINGORIENTATION
0x2013
Imposta l'orientamento di smoothing del tipo di carattere. Il parametro pvParam è FE_FONTSMOOTHINGORIENTATIONBGR (blu-verde-rosso) o FE_FONTSMOOTHINGORIENTATIONRGB (rosso-verde-blu).

Windows XP/2000: Questo parametro non è supportato fino a quando Windows XP con SP2.

SPI_SETFONTSMOOTHINGTYPE
0x200B
Imposta il tipo di smoothing del tipo di carattere. Il parametro pvParam è FE_FONTSMOOTHINGSTANDARD, se viene usato l'anti-aliasing standard o FE_FONTSMOOTHINGCLEARTYPE, se viene usato ClearType . Il valore predefinito è FE_FONTSMOOTHINGSTANDARD.

SPI_SETFONTSMOOTHING deve essere impostato anche.

Windows 2000: Questo parametro non è supportato.

SPI_SETWORKAREA
0x002F
Imposta le dimensioni dell'area di lavoro. L'area di lavoro è la parte dello schermo non oscurata dalla barra delle applicazioni o dalle barre degli strumenti desktop dell'applicazione. Il parametro pvParam è un puntatore a una struttura RECT che specifica il nuovo rettangolo dell'area di lavoro, espresso nelle coordinate dello schermo virtuale. In un sistema con più monitoraggi dello schermo, la funzione imposta l'area di lavoro del monitor che contiene il rettangolo specificato.
 

Di seguito sono riportati i parametri dell'icona.

Parametro icona Significato
SPI_GETICONMETRICS
0x002D
Recupera le metriche associate alle icone. Il parametro pvParam deve puntare a una struttura ICONMETRICS che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(ICONMETRICS).
SPI_GETICONTITLELOGFONT
0x001F
Recupera le informazioni sul tipo di carattere logico per il tipo di carattere del titolo dell'icona corrente. Il parametro uiParam specifica le dimensioni di una struttura LOGFONT e il parametro pvParam deve puntare alla struttura LOGFONT da compilare.
SPI_GETICONTITLEWRAP
0x0019
Determina se il ritorno a capo del titolo dell'icona è abilitato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE in caso contrario.
SPI_ICONHORIZONTALSPACING
0x000D
Imposta o recupera la larghezza, in pixel, di una cella dell'icona. Il sistema usa questo rettangolo per disporre le icone nella visualizzazione Icone grandi.

Per impostare questo valore, impostare uiParam sul nuovo valore e impostare pvParam su NULL. Non è possibile impostare questo valore su minore di SM_CXICON.

Per recuperare questo valore, pvParam deve puntare a un numero intero che riceve il valore corrente.

SPI_ICONVERTICALSPACING
0x0018
Imposta o recupera l'altezza, in pixel, di una cella dell'icona.

Per impostare questo valore, impostare uiParam sul nuovo valore e impostare pvParam su NULL. Non è possibile impostare questo valore su minore di SM_CYICON.

Per recuperare questo valore, pvParam deve puntare a un numero intero che riceve il valore corrente.

SPI_SETICONMETRICS
0x002E
Imposta le metriche associate alle icone. Il parametro pvParam deve puntare a una struttura ICONMETRICS contenente i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(ICONMETRICS).
SPI_SETICONS
0x0058
Ricarica le icone di sistema. Impostare il parametro uiParam su zero e il parametro pvParam su NULL.
SPI_SETICONTITLELOGFONT
0x0022
Imposta il tipo di carattere utilizzato per i titoli delle icone. Il parametro uiParam specifica le dimensioni di una struttura LOGFONT e il parametro pvParam deve puntare a una struttura LOGFONT .
SPI_SETICONTITLEWRAP
0x001A
Attiva o disattiva la disposizione del titolo dell'icona. Il parametro uiParam specifica TRUE per on o FALSE per off.
 

Di seguito sono riportati i parametri di input. Includono parametri correlati alla tastiera, al mouse, alla penna, alla lingua di input e all'avviso.

Parametro di input Significato
SPI_GETBEEP
0x0001
Determina se l'avviso è attivato.

Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se l'api è attivata o FALSE se è disattivata.

SPI_GETBLOCKSENDINPUTRESETS
0x1026
Recupera un valore BOOL che indica se un'applicazione può reimpostare il timer dello screen screenaver chiamando la funzione SendInput per simulare l'input della tastiera o del mouse. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se l'input simulato verrà bloccato o FALSE in caso contrario.
SPI_GETCONTACTVISUALIZATION
0x2018
Recupera l'impostazione corrente della visualizzazione dei contatti. Il parametro pvParam deve puntare a una variabile ULONG che riceve l'impostazione . Per altre informazioni, vedere Visualizzazione dei contatti.
SPI_GETDEFAULTINPUTLANG
0x0059
Recupera l'identificatore delle impostazioni locali di input per la lingua di input predefinita del sistema. Il parametro pvParam deve puntare a una variabile HKL che riceve questo valore. Per altre informazioni, vedere Lingue, impostazioni locali e layout di tastiera.
SPI_GETGESTUREVISUALIZATION
0x201A
Recupera l'impostazione di visualizzazione dei movimenti corrente. Il parametro pvParam deve puntare a una variabile ULONG che riceve l'impostazione . Per altre informazioni, vedere Visualizzazione movimenti.
SPI_GETKEYBOARDCUES
0x100A
Determina se i tasti di scelta del menu sono sempre sottolineati. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se i tasti di scelta del menu sono sempre sottolineati e FALSE se sono sottolineati solo quando il menu viene attivato dalla tastiera.
SPI_GETKEYBOARDDELAY
0x0016
Recupera l'impostazione del ritardo di ripetizione della tastiera, ovvero un valore compreso nell'intervallo compreso tra 0 (ritardo di circa 250 ms) e 3 (circa 1 secondo ritardo). Il ritardo effettivo associato a ogni valore può variare a seconda dell'hardware. Il parametro pvParam deve puntare a una variabile integer che riceve l'impostazione .
SPI_GETKEYBOARDPREF
0x0044
Determina se l'utente si basa sulla tastiera anziché sul mouse e vuole che le applicazioni visualizzino le interfacce della tastiera che altrimenti sarebbero nascoste. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se l'utente si basa sulla tastiera; o FALSE in caso contrario.
SPI_GETKEYBOARDSPEED
0x000A
Recupera l'impostazione della velocità di ripetizione della tastiera, ovvero un valore compreso nell'intervallo compreso tra 0 (circa 2,5 ripetizioni al secondo) e 31 (circa 30 ripetizioni al secondo). Le frequenze di ripetizione effettive sono dipendenti dall'hardware e possono variare da una scala lineare fino al 20%. Il parametro pvParam deve puntare a una variabile DWORD che riceve l'impostazione .
SPI_GETMOUSE
0x0003
Recupera i due valori di soglia del mouse e l'accelerazione del mouse. Il parametro pvParam deve puntare a una matrice di tre interi che riceve questi valori. Per altre informazioni , vedere mouse_event .
SPI_GETMOUSEHOVERHEIGHT
0x0064
Recupera l'altezza, in pixel, del rettangolo all'interno del quale il puntatore del mouse deve rimanere per TrackMouseEvent per generare un messaggio di WM_MOUSEHOVER . Il parametro pvParam deve puntare a una variabile UINT che riceve l'altezza.
SPI_GETMOUSEHOVERTIME
0x0066
Recupera il tempo, in millisecondi, che il puntatore del mouse deve rimanere nel rettangolo del mouse per TrackMouseEvent per generare un messaggio di WM_MOUSEHOVER . Il parametro pvParam deve puntare a una variabile UINT che riceve l'ora.
SPI_GETMOUSEHOVERWIDTH
0x0062
Recupera la larghezza, in pixel, del rettangolo all'interno del quale il puntatore del mouse deve rimanere per TrackMouseEvent per generare un messaggio di WM_MOUSEHOVER . Il parametro pvParam deve puntare a una variabile UINT che riceve la larghezza.
SPI_GETMOUSESPEED
0x0070
Recupera la velocità corrente del mouse. La velocità del mouse determina la distanza di spostamento del puntatore in base alla distanza in cui si sposta il mouse. Il parametro pvParam deve puntare a un intero che riceve un valore compreso tra 1 (più lento) e 20 (più veloce). Il valore predefinito è 10. Il valore può essere impostato da un utente finale usando l'applicazione del pannello di controllo del mouse o da un'applicazione usando SPI_SETMOUSESPEED.
SPI_GETMOUSETRAILS
0x005E
Determina se la funzionalità Traccia mouse è abilitata. Questa funzionalità migliora la visibilità dei movimenti del cursore del mouse mostrando brevemente una traccia di cursori e cancellandoli rapidamente.

Il parametro pvParam deve puntare a una variabile integer che riceve un valore. se il valore è zero o 1, la funzionalità è disabilitata. Se il valore è maggiore di 1, la funzionalità è abilitata e il valore indica il numero di cursori disegnati nel percorso. Il parametro uiParam non viene usato.

Windows 2000: Questo parametro non è supportato.

SPI_GETMOUSEWHEELROUTING
0x201C
Recupera l'impostazione di routing per l'input del pulsante della rotellina. L'impostazione di routing determina se l'input del pulsante della rotellina viene inviato all'app con lo stato attivo (primo piano) o l'app sotto il cursore del mouse.

Il parametro pvParam deve puntare a una variabile DWORD che riceve l'opzione di routing. Se il valore è zero o MOUSEWHEEL_ROUTING_FOCUS, l'input della rotellina del mouse viene recapitato all'app con lo stato attivo. Se il valore è 1 o MOUSEWHEEL_ROUTING_HYBRID (impostazione predefinita), l'input della rotellina del mouse viene recapitato all'app con lo stato attivo (app desktop) o l'app sotto il cursore del mouse (app di Windows Store). Il parametro uiParam non viene usato.

SPI_GETPENVISUALIZATION
0x201E
Recupera l'impostazione di visualizzazione dei movimenti della penna corrente. Il parametro pvParam deve puntare a una variabile ULONG che riceve l'impostazione. Per altre informazioni, vedere Visualizzazione penna.
SPI_GETSNAPTODEFBUTTON
0x005F
Determina se la funzionalità snap-to-default-button è abilitata. Se abilitato, il cursore del mouse passa automaticamente al pulsante predefinito, ad esempio OK o Applica, di una finestra di dialogo. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se la funzionalità è attiva o FALSE se è disattivata.
SPI_GETSYSTEMLANGUAGEBAR
0x1050
A partire da Windows 8: Determina se la barra della lingua di sistema è abilitata o disabilitata. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se la barra della lingua è abilitata o FALSE in caso contrario.
SPI_GETTHREADLOCALINPUTSETTINGS
0x104E
A partire da Windows 8: Determina se le impostazioni di input attive hanno ambito Local (per thread, TRUE) o Global (session, FALSE). Il parametro pvParam deve puntare a una variabile BOOL .
SPI_GETTOUCHPADPARAMETERS
0x00AE
A partire da Windows 11 versione 24H2: Recupera i dettagli sul Touchpad precisione, incluse le impostazioni utente e le informazioni di sistema correlate al touchpad.

Il parametro pvParam deve puntare a una struttura TOUCHPAD_PARAMETERS .

Il parametro uiParam deve specificare le dimensioni della struttura.

Il valore del campo versionNumber nella struttura TOUCHPAD_PARAMETERS deve essere impostato sul valore appropriato per la versione della struttura usata.

SPI_GETWHEELSCROLLCHARS
0x006C
Recupera il numero di caratteri da scorrere quando viene spostata la rotellina orizzontale del mouse. Il parametro pvParam deve puntare a una variabile UINT che riceve il numero di righe. Il valore predefinito è 3.
SPI_GETWHEELSCROLLLINES
0x0068
Recupera il numero di righe da scorrere quando viene spostata la rotellina verticale del mouse. Il parametro pvParam deve puntare a una variabile UINT che riceve il numero di righe. Il valore predefinito è 3.
SPI_SETBEEP
0x0002
Attiva o disattiva l'avviso. Il parametro uiParam specifica TRUE per on o FALSE per disattivato.
SPI_SETBLOCKSENDINPUTRESETS
0x1027
Determina se un'applicazione può reimpostare il timer dello screenaver chiamando la funzione SendInput per simulare l'input della tastiera o del mouse. Il parametro uiParam specifica TRUE se lo screenaver non verrà disattivato dall'input simulato o FALSE se lo screenaver verrà disattivato dall'input simulato.
SPI_SETCONTACTVISUALIZATION
0x2019
Imposta l'impostazione di visualizzazione contatto corrente. Il parametro pvParam deve puntare a una variabile ULONG che identifica l'impostazione. Per altre informazioni, vedere Visualizzazione contatti.
Nota Se le visualizzazioni dei contatti sono disabilitate, le visualizzazioni dei movimenti non possono essere abilitate.
 
SPI_SETDEFAULTINPUTLANG
0x005A
Imposta il linguaggio di input predefinito per la shell di sistema e le applicazioni. La lingua specificata deve essere visualizzata usando il set di caratteri di sistema corrente. Il parametro pvParam deve puntare a una variabile HKL contenente l'identificatore delle impostazioni locali di input per la lingua predefinita. Per altre informazioni, vedere Lingue, impostazioni locali e layout della tastiera.
SPI_SETDOUBLECLICKTIME
0x0020
Imposta l'ora di doppio clic per il mouse sul valore del parametro uiParam . Se il valore uiParam è maggiore di 5000 millisecondi, il sistema imposta il doppio clic su 5000 millisecondi.

L'ora di doppio clic è il numero massimo di millisecondi che possono verificarsi tra il primo e il secondo clic di un doppio clic. È anche possibile chiamare la funzione SetDoubleClickTime per impostare l'ora di doppio clic. Per ottenere l'ora di doppio clic corrente, chiamare la funzione GetDoubleClickTime .

SPI_SETDOUBLECLKHEIGHT
0x001E
Imposta l'altezza del rettangolo doppio clic sul valore del parametro uiParam .

Il rettangolo a doppio clic è il rettangolo all'interno del quale il secondo clic di un doppio clic deve essere registrato come doppio clic.

Per recuperare l'altezza del rettangolo di doppio clic, chiamare GetSystemMetrics con il flag SM_CYDOUBLECLK .

SPI_SETDOUBLECLKWIDTH
0x001D
Imposta la larghezza del rettangolo di doppio clic sul valore del parametro uiParam .

Il rettangolo di doppio clic è il rettangolo all'interno del quale il secondo clic di un doppio clic deve essere registrato come doppio clic.

Per recuperare la larghezza del rettangolo di doppio clic, chiamare GetSystemMetrics con il flag SM_CXDOUBLECLK .

SPI_SETGESTUREVISUALIZATION
0x201B
Imposta l'impostazione di visualizzazione dei movimenti corrente. Il parametro pvParam deve puntare a una variabile ULONG che identifica l'impostazione. Per altre informazioni, vedere Visualizzazione movimenti.
Nota Se le visualizzazioni dei contatti sono disabilitate, le visualizzazioni dei movimenti non possono essere abilitate.
 
SPI_SETKEYBOARDCUES
0x100B
Imposta la sottolineatura delle lettere chiave di scelta del menu. Il parametro pvParam è una variabile BOOL . Impostare pvParam su TRUE per sottolineare sempre i tasti di scelta del menu oppure FALSE per sottolineare i tasti di scelta del menu solo quando il menu viene attivato dalla tastiera.
SPI_SETKEYBOARDDELAY
0x0017
Imposta l'impostazione del ritardo di ripetizione della tastiera. Il parametro uiParam deve specificare 0, 1, 2 o 3, dove zero imposta il ritardo più breve di circa 250 ms e 3 imposta il ritardo più lungo (circa 1 secondo). Il ritardo effettivo associato a ogni valore può variare a seconda dell'hardware.
SPI_SETKEYBOARDPREF
0x0045
Imposta la preferenza della tastiera. Il parametro uiParam specifica TRUE se l'utente si basa sulla tastiera anziché sul mouse e vuole che le applicazioni visualizzino le interfacce della tastiera altrimenti nascoste; uiParam è FALSE in caso contrario.
SPI_SETKEYBOARDSPEED
0x000B
Imposta l'impostazione della velocità di ripetizione della tastiera. Il parametro uiParam deve specificare un valore compreso nell'intervallo compreso tra 0 (circa 2,5 ripetizioni al secondo) e 31 (circa 30 ripetizioni al secondo). Le frequenze di ripetizione effettive sono dipendenti dall'hardware e possono variare da una scala lineare fino al 20%. Se uiParam è maggiore di 31, il parametro è impostato su 31.
SPI_SETLANGTOGGLE
0x005B
Imposta il set di tasti di scelta rapida per il passaggio tra le lingue di input. I parametri uiParam e pvParam non vengono usati. Il valore imposta i tasti di scelta rapida nelle finestre delle proprietà della tastiera leggendo di nuovo il Registro di sistema. Il Registro di sistema deve essere impostato prima di utilizzare questo flag. il percorso nel Registro di sistema è HKEY_CURRENT_USER\Layout tastiera\Attiva/Disattiva

. I valori validi sono "1" = ALT+MAIUSC, "2" = CTRL+MAIUSC e "3" = none.
SPI_SETMOUSE
0x0004
Imposta i due valori di soglia del mouse e l'accelerazione del mouse. Il parametro pvParam deve puntare a una matrice di tre interi che specifica questi valori. Per altre informazioni , vedere mouse_event .
SPI_SETMOUSEBUTTONSWAP
0x0021
Scambia o ripristina il significato dei pulsanti sinistro e destro del mouse. Il parametro uiParam specifica TRUE per scambiare i significati dei pulsanti o FALSE per ripristinare i significati originali.

Per recuperare l'impostazione corrente, chiamare GetSystemMetrics con il flag SM_SWAPBUTTON .

SPI_SETMOUSEHOVERHEIGHT
0x0065
Imposta l'altezza, in pixel, del rettangolo all'interno del quale il puntatore del mouse deve rimanere per TrackMouseEvent per generare un messaggio WM_MOUSEHOVER . Impostare il parametro uiParam sulla nuova altezza.
SPI_SETMOUSEHOVERTIME
0x0067
Imposta il tempo, in millisecondi, che il puntatore del mouse deve rimanere nel rettangolo di passaggio del mouse per TrackMouseEvent per generare un messaggio di WM_MOUSEHOVER . Viene usato solo se si passa HOVER_DEFAULT nel parametro dwHoverTime nella chiamata a TrackMouseEvent. Impostare il parametro uiParam sulla nuova ora.

L'ora specificata deve essere compresa tra USER_TIMER_MAXIMUM e USER_TIMER_MINIMUM. Se uiParam è minore di USER_TIMER_MINIMUM, la funzione userà USER_TIMER_MINIMUM. Se uiParam è maggiore di USER_TIMER_MAXIMUM, la funzione verrà USER_TIMER_MAXIMUM.

Windows Server 2003 e Windows XP: Il sistema operativo non applica l'uso di USER_TIMER_MAXIMUM e USER_TIMER_MINIMUM fino a Windows Server 2003 con SP1 e Windows XP con SP2.

SPI_SETMOUSEHOVERWIDTH
0x0063
Imposta la larghezza, in pixel, del rettangolo all'interno del quale il puntatore del mouse deve rimanere per TrackMouseEvent per generare un messaggio di WM_MOUSEHOVER . Impostare il parametro uiParam sulla nuova larghezza.
SPI_SETMOUSESPEED
0x0071
Imposta la velocità corrente del mouse. Il parametro pvParam è un numero intero compreso tra 1 (più lento) e 20 (più veloce). Il valore predefinito è 10. Questo valore viene in genere impostato usando l'applicazione del pannello di controllo del mouse.
SPI_SETMOUSETRAILS
0x005D
Abilita o disabilita la funzionalità Percorsi mouse, che migliora la visibilità dei movimenti del cursore del mouse mostrando brevemente un percorso di cursori e cancellandoli rapidamente.

Per disabilitare la funzionalità, impostare il parametro uiParam su zero o 1. Per abilitare la funzionalità, impostare uiParam su un valore maggiore di 1 per indicare il numero di cursori disegnati nella traccia.

Windows 2000: Questo parametro non è supportato.

SPI_SETMOUSEWHEELROUTING
0x201D
Imposta l'impostazione di routing per l'input del pulsante della rotellina. L'impostazione di routing determina se l'input del pulsante della rotellina viene inviato all'app con lo stato attivo (in primo piano) o l'app sotto il cursore del mouse.

Il parametro pvParam deve puntare a una variabile DWORD che riceve l'opzione di routing. Se il valore è zero o MOUSEWHEEL_ROUTING_FOCUS, l'input della rotellina del mouse viene recapitato all'app con lo stato attivo. Se il valore è 1 o MOUSEWHEEL_ROUTING_HYBRID (impostazione predefinita), l'input della rotellina del mouse viene recapitato all'app con stato attivo (app desktop) o l'app sotto il cursore del mouse (app di Windows Store). Impostare il parametro uiParam su zero.

SPI_SETPENVISUALIZATION
0x201F
Imposta l'impostazione corrente della visualizzazione movimento penna. Il parametro pvParam deve puntare a una variabile ULONG che identifica l'impostazione. Per altre informazioni, vedere Visualizzazione della penna.
SPI_SETSNAPTODEFBUTTON
0x0060
Abilita o disabilita la funzionalità snap-to-default-button. Se abilitato, il cursore del mouse passa automaticamente al pulsante predefinito, ad esempio OK o Applica, di una finestra di dialogo. Impostare il parametro uiParam su TRUE per abilitare la funzionalità o FALSE per disabilitarla. Le applicazioni devono usare la funzione ShowWindow durante la visualizzazione di una finestra di dialogo in modo che il gestore della finestra di dialogo possa posizionare il cursore del mouse.
SPI_SETSYSTEMLANGUAGEBAR
0x1051
A partire da Windows 8: Attiva o disattiva la funzionalità della barra della lingua legacy. Il parametro pvParam è un puntatore a una variabile BOOL . Impostare pvParam su TRUE per abilitare la barra della lingua legacy o FALSE per disabilitarla. Il flag è supportato in Windows 8 in cui la barra della lingua legacy viene sostituita da Input Switcher e quindi disattivata per impostazione predefinita. L'attivazione della barra della lingua legacy viene fornita per motivi di compatibilità e non ha alcun effetto sul commutatore di input.
SPI_SETTHREADLOCALINPUTSETTINGS
0x104F
A partire da Windows 8: Determina se le impostazioni di input attive hanno ambito Locale (per thread, TRUE) o Globale (sessione, FALSE). Il parametro pvParam deve essere una variabile BOOL , di cui viene eseguito il cast da PVOID.
SPI_SETTOUCHPADPARAMETERS
0x00AF
A partire da Windows 11, versione 24H2: Imposta i dettagli sul Touchpad di precisione, incluse le impostazioni utente e le informazioni di sistema correlate al touchpad.

Il parametro pvParam deve puntare a una struttura TOUCHPAD_PARAMETERS .

Il parametro uiParam deve specificare le dimensioni della struttura.

Il valore del campo versionNumber nella struttura TOUCHPAD_PARAMETERS deve essere impostato sul valore appropriato per la versione della struttura in uso.

SPI_SETWHEELSCROLLCHARS
0x006D
Imposta il numero di caratteri da scorrere quando viene spostata la rotellina orizzontale del mouse. Il numero di caratteri viene impostato dal parametro uiParam .
SPI_SETWHEELSCROLLLINES
0x0069
Imposta il numero di righe da scorrere quando viene spostata la rotellina verticale del mouse. Il numero di righe viene impostato dal parametro uiParam .

Il numero di righe è il numero consigliato di righe da scorrere quando la rotellina del mouse viene ruotata senza usare i tasti di modifica. Se il numero è 0, non deve verificarsi alcun scorrimento. Se il numero di righe da scorrere è maggiore del numero di righe visualizzabili e, in particolare, se è WHEEL_PAGESCROLL (#defined come UINT_MAX), l'operazione di scorrimento deve essere interpretata come clic una volta nell'area di scorrimento verso il basso o la pagina verso l'alto della barra di scorrimento.

 

Di seguito sono riportati i parametri di menu.

Parametro del menu Significato
SPI_GETMENUDROPALIGNMENT
0x001B
Determina se i menu a comparsa sono allineati a sinistra o allineati a destra, rispetto alla voce della barra dei menu corrispondente. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se allineata a destra o FALSE in caso contrario.
SPI_GETMENUFADE
0x1012
Determina se l'animazione di dissolvenza del menu è abilitata. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE quando l'animazione di dissolvenza è abilitata e FALSE quando èdisabled. Se l'animazione dissolvenza è disabilitata, i menu usano l'animazione diapositiva. Questo flag viene ignorato, a meno che l'animazione del menu non sia abilitata, che puoi fare usando il flag SPI_SETMENUANIMATION . Per altre informazioni, vedere AnimateWindow.
SPI_GETMENUSHOWDELAY
0x006A
Recupera il tempo, espresso in millisecondi, che il sistema attende prima di visualizzare un menu di scelta rapida quando il cursore del mouse si trova su un sottomenu. Il parametro pvParam deve puntare a una variabile DWORD che riceve il tempo del ritardo.
SPI_SETMENUDROPALIGNMENT
0x001C
Imposta il valore di allineamento dei menu a comparsa. Il parametro uiParam specifica TRUE per l'allineamento a destra o FALSE per l'allineamento a sinistra.
SPI_SETMENUFADE
0x1013
Abilita o disabilita l'animazione di dissolvenza del menu. Impostare pvParam su TRUE per abilitare l'effetto di dissolvenza del menu o FALSE per disabilitarlo. Se l'animazione dissolvenza è disabilitata, i menu usano l'animazione diapositiva. lui L'effetto dissolvenza del menu è possibile solo se il sistema ha una profondità di colore superiore a 256 colori. Questo flag viene ignorato a meno che non sia impostato anche SPI_MENUANIMATION . Per altre informazioni, vedere AnimateWindow.
SPI_SETMENUSHOWDELAY
0x006B
Imposta uiParam sul tempo, espresso in millisecondi, che il sistema attende prima di visualizzare un menu di scelta rapida quando il cursore del mouse si trova su un elemento di sottomenu.
 

Di seguito sono riportati i parametri di alimentazione.

A partire da Windows Server 2008 e Windows Vista, questi parametri di alimentazione non sono supportati. Per determinare lo stato di alimentazione di visualizzazione corrente, invece, un'applicazione deve registrarsi per le notifiche di GUID_MONITOR_POWER_STATE . Per determinare il timeout dell'alimentazione di visualizzazione corrente, un'applicazione deve registrarsi per notificare le modifiche apportate all'impostazione di risparmio energia GUID_VIDEO_POWERDOWN_TIMEOUT . Per altre informazioni, vedere Registrazione per gli eventi di Power.

Windows Server 2003 e Windows XP/2000: Per determinare lo stato di alimentazione di visualizzazione corrente, usare i parametri di alimentazione seguenti.

Parametro di alimentazione Significato
SPI_GETLOWPOWERACTIVE
0x0053
Questo parametro non è supportato.

Windows Server 2003 e Windows XP/2000: Determina se la fase a basso consumo di salvataggio dello schermo è abilitata. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE se disabilitata. Questo flag è supportato solo per le applicazioni a 32 bit.

SPI_GETLOWPOWERTIMEOUT
0x004F
Questo parametro non è supportato.

Windows Server 2003 e Windows XP/2000: Recupera il valore di timeout per la fase a basso consumo del salvataggio dello schermo. Il parametro pvParam deve puntare a una variabile integer che riceve il valore. Questo flag è supportato solo per le applicazioni a 32 bit.

SPI_GETPOWEROFFACTIVE
0x0054
Questo parametro non è supportato. Quando la fase di spegnimento dello schermo è abilitata, l'impostazione di alimentazione GUID_VIDEO_POWERDOWN_TIMEOUT è maggiore di zero.

Windows Server 2003 e Windows XP/2000: Determina se la fase di spegnimento del salvataggio dello schermo è abilitata. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE se disabilitata. Questo flag è supportato solo per le applicazioni a 32 bit.

SPI_GETPOWEROFFTIMEOUT
0x0050
Questo parametro non è supportato. Controllare invece l'impostazione di risparmio energia GUID_VIDEO_POWERDOWN_TIMEOUT .

Windows Server 2003 e Windows XP/2000: Recupera il valore di timeout per la fase di spegnimento del salvataggio dello schermo. Il parametro pvParam deve puntare a una variabile integer che riceve il valore. Questo flag è supportato solo per le applicazioni a 32 bit.

SPI_SETLOWPOWERACTIVE
0x0055
Questo parametro non è supportato.

Windows Server 2003 e Windows XP/2000: Attiva o disattiva la fase di risparmio di energia dello schermo. Impostare uiParam su 1 per attivare o zero per disattivare. Il parametro pvParam deve essere NULL. Questo flag è supportato solo per le applicazioni a 32 bit.

SPI_SETLOWPOWERTIMEOUT
0x0051
Questo parametro non è supportato.

Windows Server 2003 e Windows XP/2000: Imposta il valore di timeout, in secondi, per la fase di risparmio dello schermo a bassa potenza. Il parametro uiParam specifica il nuovo valore. Il parametro pvParam deve essere NULL. Questo flag è supportato solo per applicazioni a 32 bit.

SPI_SETPOWEROFFACTIVE
0x0056
Questo parametro non è supportato. Impostare invece l'impostazione di alimentazione GUID_VIDEO_POWERDOWN_TIMEOUT .

Windows Server 2003 e Windows XP/2000: Attiva o disattiva la fase di risparmio dello schermo. Impostare uiParam su 1 per attivare o zero per disattivare. Il parametro pvParam deve essere NULL. Questo flag è supportato solo per applicazioni a 32 bit.

SPI_SETPOWEROFFTIMEOUT
0x0052
Questo parametro non è supportato. Impostare invece l'impostazione di alimentazione GUID_VIDEO_POWERDOWN_TIMEOUT su un valore di timeout.

Windows Server 2003 e Windows XP/2000: Imposta il valore di timeout, in secondi, per la fase di risparmio dello schermo. Il parametro uiParam specifica il nuovo valore. Il parametro pvParam deve essere NULL. Questo flag è supportato solo per applicazioni a 32 bit.

 

Di seguito sono riportati i parametri dello screen saver.

Parametro screen saver Significato
SPI_GETSCREENSAVEACTIVE
0x0010
Determina se il salvataggio dello schermo è abilitato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se il salvataggio dello schermo è abilitato o FALSE in caso contrario.

Windows 7, Windows Server 2008 R2 e Windows 2000: La funzione restituisce TRUE anche quando il salvataggio dello schermo non è abilitato.

SPI_GETSCREENSAVERRUNNING
0x0072
Determina se uno screen saver è attualmente in esecuzione nella stazione finestra del processo chiamante. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se uno screen saver è attualmente in esecuzione o FALSE in caso contrario. Si noti che solo la stazione interattiva della finestra, WinSta0, può avere un screen saver in esecuzione.
SPI_GETSCREENSAVESECURE
0x0076
Determina se lo screen saver richiede una password per visualizzare il desktop di Windows. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se lo screen saver richiede una password o FALSE in caso contrario. Il parametro uiParam viene ignorato.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETSCREENSAVETIMEOUT
0x000E
Recupera il valore di timeout dello screen saver, in secondi. Il parametro pvParam deve puntare a una variabile integer che riceve il valore.
SPI_SETSCREENSAVEACTIVE
0x0011
Imposta lo stato dello screen saver. Il parametro uiParam specifica TRUE per attivare il salvataggio dello schermo o FALSE per disattivarlo.

Se il computer ha immesso la modalità di risparmio energia o lo stato di blocco del sistema, si verifica un'eccezione ERROR_OPERATION_IN_PROGRESS.

SPI_SETSCREENSAVESECURE
0x0077
Imposta se lo screen saver richiede all'utente di immettere una password per visualizzare il desktop di Windows. Il parametro uiParam è una variabile BOOL . Il parametro pvParam viene ignorato. Impostare uiParam su TRUE per richiedere una password o FALSE per non richiedere una password.

Se il computer ha immesso la modalità di risparmio energia o lo stato di blocco del sistema, si verifica un'eccezione ERROR_OPERATION_IN_PROGRESS.

Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETSCREENSAVETIMEOUT
0x000F
Imposta il valore di timeout dello screen saver sul valore del parametro uiParam . Questo valore è la quantità di tempo, in secondi, che il sistema deve essere inattiva prima dell'attivazione dello screen saver.

Se il computer ha immesso la modalità di risparmio energia o lo stato di blocco del sistema, si verifica un'eccezione ERROR_OPERATION_IN_PROGRESS.

 

Di seguito sono riportati i parametri di timeout per applicazioni e servizi.

Parametro timeout Significato
SPI_GETHUNGAPPTIMEOUT
0x0078
Recupera il numero di millisecondi che un thread può andare senza inviare un messaggio prima che il sistema lo consideri non risponde. Il parametro pvParam deve puntare a una variabile integer che riceve il valore.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETWAITTOKILLTIMEOUT
0x007A
Recupera il numero di millisecondi che il sistema attende prima di terminare un'applicazione che non risponde a una richiesta di arresto. Il parametro pvParam deve puntare a una variabile integer che riceve il valore.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETWAITTOKILLSERVICETIMEOUT
0x007C
Recupera il numero di millisecondi che la gestione controllo del servizio attende prima di terminare un servizio che non risponde a una richiesta di arresto. Il parametro pvParam deve puntare a una variabile integer che riceve il valore.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETHUNGAPPTIMEOUT
0x0079
Imposta il timeout dell'applicazione sospeso sul valore del parametro uiParam . Questo valore è il numero di millisecondi che un thread può andare senza inviare un messaggio prima che il sistema lo consideri non risponde.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETWAITTOKILLTIMEOUT
0x007B
Imposta il timeout della richiesta di arresto dell'applicazione sul valore del parametro uiParam . Questo valore è il numero di millisecondi che il sistema attende prima di terminare un'applicazione che non risponde a una richiesta di arresto.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETWAITTOKILLSERVICETIMEOUT
0x007D
Imposta il timeout della richiesta di arresto del servizio sul valore del parametro uiParam . Questo valore è il numero di millisecondi che il sistema attende prima di terminare un servizio che non risponde a una richiesta di arresto.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

 

Di seguito sono riportati gli effetti dell'interfaccia utente. Il valore SPI_SETUIEFFECTS viene usato per abilitare o disabilitare tutti gli effetti dell'interfaccia utente contemporaneamente. Questa tabella contiene l'elenco completo dei valori dell'effetto dell'interfaccia utente.

Parametro degli effetti dell'interfaccia utente Significato
SPI_GETCOMBOBOXANIMATION
0x1004
Determina se l'effetto di apertura diapositiva per le caselle combinate è abilitato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE per enabled o FALSE per disabled.
SPI_GETCURSORSHADOW
0x101A
Determina se il cursore ha un'ombreggiatura intorno a essa. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se l'ombreggiatura è abilitata, FALSE se è disabilitata. Questo effetto viene visualizzato solo se il sistema ha una profondità di colore superiore a 256 colori.
SPI_GETGRADIENTCAPTIONS
0x1008
Determina se l'effetto sfumatura per le barre del titolo della finestra è abilitato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE per enabled o FALSE per disabled. Per altre informazioni sull'effetto sfumatura, vedere la funzione GetSysColor .
SPI_GETHOTTRACKING
0x100E
Determina se il rilevamento rapido degli elementi dell'interfaccia utente, ad esempio i nomi dei menu nelle barre dei menu, è abilitato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE per enabled o FALSE per disabled.

Rilevamento rapido indica che quando il cursore si sposta su un elemento, viene evidenziato ma non selezionato. È possibile eseguire una query su questo valore per decidere se usare il rilevamento rapido nell'interfaccia utente dell'applicazione.

SPI_GETLISTBOXSMOOTHSCROLLING
0x1006
Determina se l'effetto di scorrimento uniforme per le caselle di riepilogo è abilitato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE per enabled o FALSE per disabled.
SPI_GETMENUANIMATION
0x1002
Determina se la funzionalità di animazione del menu è abilitata. Questa opzione master deve essere attivata per abilitare gli effetti di animazione del menu. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se l'animazione è abilitata e FALSE se è disabilitata.

Se l'animazione è abilitata, SPI_GETMENUFADE indica se i menu usano l'animazione dissolvenza o la diapositiva.

SPI_GETMENUUNDERLINES
0x100A
Uguale a SPI_GETKEYBOARDCUES.
SPI_GETSELECTIONFADE
0x1014
Determina se l'effetto di dissolvenza della selezione è abilitato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE se disabilitata.

L'effetto dissolvenza della selezione fa sì che la voce di menu selezionata dall'utente rimanga sullo schermo brevemente mentre si dissolve dopo che il menu viene ignorato.

SPI_GETTOOLTIPANIMATION
0x1016
Determina se l'animazione della descrizione comando è abilitata. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE se disabilitata. Se l'animazione della descrizione comando è abilitata, SPI_GETTOOLTIPFADE indica se le descrizioni comandi usano l'animazione dissolvenza o la diapositiva.
SPI_GETTOOLTIPFADE
0x1018
Se SPI_SETTOOLTIPANIMATION è abilitato, SPI_GETTOOLTIPFADE indica se l'animazione della descrizione comando utilizza un effetto dissolvenza o un effetto diapositiva. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE per l'animazione di dissolvenza o FALSE per l'animazione diapositiva. Per altre informazioni sugli effetti di scorrimento e dissolvenza, vedere AnimateWindow.
SPI_GETUIEFFECTS
0x103E
Determina se gli effetti dell'interfaccia utente sono abilitati o disabilitati. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se tutti gli effetti dell'interfaccia utente sono abilitati o FALSE se sono disabilitati.
SPI_SETCOMBOBOXANIMATION
0x1005
Abilita o disabilita l'effetto di apertura diapositiva per le caselle combinate. Impostare il parametro pvParam su TRUE per abilitare l'effetto sfumatura o FALSE per disabilitarlo.
SPI_SETCURSORSHADOW
0x101B
Abilita o disabilita un'ombreggiatura attorno al cursore. Il parametro pvParam è una variabile BOOL . Impostare pvParam su TRUE per abilitare l'ombreggiatura o FALSE per disabilitare l'ombreggiatura. Questo effetto viene visualizzato solo se il sistema ha una profondità di colore superiore a 256 colori.
SPI_SETGRADIENTCAPTIONS
0x1009
Abilita o disabilita l'effetto sfumatura per le barre del titolo della finestra. Impostare il parametro pvParam su TRUE per abilitarlo o FALSE per disabilitarlo. L'effetto sfumatura è possibile solo se il sistema ha una profondità di colore superiore a 256 colori. Per altre informazioni sull'effetto sfumatura, vedere la funzione GetSysColor .
SPI_SETHOTTRACKING
0x100F
Abilita o disabilita il rilevamento rapido degli elementi dell'interfaccia utente, ad esempio i nomi dei menu nelle barre dei menu. Impostare il parametro pvParam su TRUE per abilitarlo o FALSE per disabilitarlo.

Rilevamento rapido indica che quando il cursore si sposta su un elemento, viene evidenziato ma non selezionato.

SPI_SETLISTBOXSMOOTHSCROLLING
0x1007
Abilita o disabilita l'effetto di scorrimento uniforme per le caselle di riepilogo. Impostare il parametro pvParam su TRUE per abilitare l'effetto di scorrimento uniforme o FALSE per disabilitarlo.
SPI_SETMENUANIMATION
0x1003
Abilita o disabilita l'animazione dei menu. Questa opzione master deve essere attivata per qualsiasi animazione di menu. Il parametro pvParam è una variabile BOOL ; impostare pvParam su TRUE per abilitare l'animazione e FALSE per disabilitare l'animazione.

Se l'animazione è abilitata, SPI_GETMENUFADE indica se i menu usano l'animazione dissolvenza o la diapositiva.

SPI_SETMENUUNDERLINES
0x100B
Uguale a SPI_SETKEYBOARDCUES.
SPI_SETSELECTIONFADE
0x1015
Impostare pvParam su TRUE per abilitare l'effetto di dissolvenza della selezione o FALSE per disabilitarlo.

L'effetto dissolvenza della selezione fa sì che la voce di menu selezionata dall'utente rimanga sullo schermo brevemente mentre si dissolve dopo che il menu viene ignorato. L'effetto dissolvenza della selezione è possibile solo se il sistema ha una profondità di colore superiore a 256 colori.

SPI_SETTOOLTIPANIMATION
0x1017
Impostare pvParam su TRUE per abilitare l'animazione della descrizione comando o FALSE per disabilitarla. Se abilitata, puoi usare SPI_SETTOOLTIPFADE per specificare l'animazione di dissolvenza o diapositiva.
SPI_SETTOOLTIPFADE
0x1019
Se il flag SPI_SETTOOLTIPANIMATION è abilitato, usa SPI_SETTOOLTIPFADE per indicare se l'animazione della descrizione comando usa un effetto dissolvenza o un effetto diapositiva. Impostare pvParam su TRUE per l'animazione dissolvenza o FALSE per l'animazione diapositiva. L'effetto di fade della descrizione comando è possibile solo se il sistema ha una profondità di colore superiore a 256 colori. Per altre informazioni sugli effetti diapositiva e dissolvenza, vedere la funzione AnimateWindow .
SPI_SETUIEFFECTS
0x103F
Abilita o disabilita gli effetti dell'interfaccia utente. Impostare il parametro pvParam su TRUE per abilitare tutti gli effetti dell'interfaccia utente o FALSE per disabilitare tutti gli effetti dell'interfaccia utente.
 

Di seguito sono riportati i parametri della finestra.

Parametro finestra Significato
SPI_GETACTIVEWINDOWTRACKING
0x1000
Determina se il rilevamento delle finestre attive (attivazione della finestra sul mouse) è attivo o disattivato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE per on o FALSE per off.
SPI_GETACTIVEWNDTRKZORDER
0x100C
Determina se le finestre attivate tramite il rilevamento delle finestre attive verranno portate all'inizio. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE per on o FALSE per off.
SPI_GETACTIVEWNDTRKTIMEOUT
0x2002
Recupera il ritardo di rilevamento delle finestre attive, in millisecondi. Il parametro pvParam deve puntare a una variabile DWORD che riceve l'ora.
SPI_GETANIMATION
0x0048
Recupera gli effetti di animazione associati alle azioni utente. Il parametro pvParam deve puntare a una struttura ANIMATIONINFO che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(ANIMATIONINFO).
SPI_GETBORDER
0x0005
Recupera il fattore di moltiplicazione del bordo che determina la larghezza del bordo del ridimensionamento di una finestra. Il parametro pvParam deve puntare a una variabile integer che riceve questo valore.
SPI_GETCARETWIDTH
0x2006
Recupera la larghezza del caret nei controlli di modifica, in pixel. Il parametro pvParam deve puntare a una variabile DWORD che riceve questo valore.
SPI_GETDOCKMOVING
0x0090
Determina se una finestra viene ancorata quando viene spostata nei bordi superiore, sinistro o destro di un monitor o di una matrice di monitoraggio. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE in caso contrario.

Usare SPI_GETWINARRANGING per determinare se questo comportamento è abilitato.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETDRAGFROMMAXIMIZE
0x008C
Determina se una finestra ingrandita viene ripristinata quando viene trascinata la barra di didascalia. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE in caso contrario.

Usare SPI_GETWINARRANGING per determinare se questo comportamento è abilitato.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETDRAGFULLWINDOWS
0x0026
Determina se il trascinamento di finestre complete è abilitato. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE in caso contrario.
SPI_GETFOREGROUNDFLASHCOUNT
0x2004
Recupera il numero di volte in cui SetForegroundWindow lampeggia il pulsante della barra delle applicazioni quando si rifiuta una richiesta di commutatore in primo piano. Il parametro pvParam deve puntare a una variabile DWORD che riceve il valore.
SPI_GETFOREGROUNDLOCKTIMEOUT
0x2000
Recupera la quantità di tempo seguente all'input dell'utente, in millisecondi, durante la quale il sistema non consente alle applicazioni di forzarsi in primo piano. Il parametro pvParam deve puntare a una variabile DWORD che riceve l'ora.
SPI_GETMINIMIZEDMETRICS
0x002B
Recupera le metriche associate a finestre ridotte al minimo. Il parametro pvParam deve puntare a una struttura MINIMIZEDMETRICS che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(MINIMIZEDMETRICS).
SPI_GETMOUSEDOCKTHRESHOLD
0x007E
Recupera la soglia in pixel in cui viene attivato il comportamento di ancoraggio usando un mouse per trascinare una finestra sul bordo di un monitor o di una matrice di monitoraggio. La soglia predefinita è 1. Il parametro pvParam deve puntare a una variabile DWORD che riceve il valore.

Usare SPI_GETWINARRANGING per determinare se questo comportamento è abilitato.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETMOUSEDRAGOUTTHRESHOLD
0x0084
Recupera la soglia in pixel in cui il comportamento di scollegamento viene attivato usando un mouse per trascinare una finestra dal bordo di un monitor o una matrice di monitoraggio verso il centro. La soglia predefinita è 20.

Usare SPI_GETWINARRANGING per determinare se questo comportamento è abilitato.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETMOUSESIDEMOVETHRESHOLD
0x0088
Recupera la soglia in pixel dall'inizio di un monitor o una matrice di monitor in cui viene ripristinata una finestra ingrandita verticalmente quando viene trascinata con il mouse. La soglia predefinita è 50.

Usare SPI_GETWINARRANGING per determinare se questo comportamento è abilitato.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETNONCLIENTMETRICS
0x0029
Recupera la metrica associata all'area non client delle finestre non ridotte a icona. Il parametro pvParam deve puntare a una struttura NONCLIENTMETRICS che riceve le informazioni. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(NONCLIENTMETRICS).

Windows Server 2003 e Windows XP/2000: Vedere Osservazioni per NONCLIENTMETRICS.

SPI_GETPENDOCKTHRESHOLD
0x0080
Recupera la soglia in pixel in cui il comportamento di ancoraggio viene attivato usando una penna per trascinare una finestra sul bordo di un monitor o di una matrice di monitoraggio. Il valore predefinito è 30.

Usare SPI_GETWINARRANGING per determinare se questo comportamento è abilitato.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETPENDRAGOUTTHRESHOLD
0x0086
Recupera la soglia in pixel in cui il comportamento di scollegamento viene attivato usando una penna per trascinare una finestra dal bordo di un monitor o una matrice di monitoraggio verso il relativo centro. La soglia predefinita è 30.

Usare SPI_GETWINARRANGING per determinare se questo comportamento è abilitato.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETPENSIDEMOVETHRESHOLD
0x008A
Recupera la soglia in pixel dalla parte superiore di un monitor o una matrice di monitoraggio in cui viene ripristinata una finestra ingrandita verticalmente quando viene trascinata con il mouse. La soglia predefinita è 50.

Usare SPI_GETWINARRANGING per determinare se questo comportamento è abilitato.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETSHOWIMEUI
0x006E
Determina se la finestra di stato IME è visibile (in base all'utente). Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se la finestra di stato è visibile o FALSE in caso contrario.
SPI_GETSNAPSIZING
0x008E
Determina se una finestra è ingrandita verticalmente quando viene ridimensionata nella parte superiore o inferiore di un monitor o di una matrice di monitoraggio. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE in caso contrario.

Usare SPI_GETWINARRANGING per determinare se questo comportamento è abilitato.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_GETWINARRANGING
0x0082
Determina se la disposizione della finestra è abilitata. Il parametro pvParam deve puntare a una variabile BOOL che riceve TRUE se abilitata o FALSE in caso contrario.

La disposizione delle finestre riduce il numero di interazioni tra mouse, penna o tocco necessarie per spostare e ridimensionare le finestre di primo livello semplificando il comportamento predefinito di una finestra quando viene trascinato o ridimensionato.

I parametri seguenti recuperano le singole impostazioni di disposizione delle finestre:

SPI_GETDOCKMOVING
SPI_GETMOUSEDOCKTHRESHOLD
SPI_GETMOUSEDRAGOUTTHRESHOLD
SPI_GETMOUSESIDEMOVETHRESHOLD
SPI_GETPENDOCKTHRESHOLD
SPI_GETPENDRAGOUTTHRESHOLD
SPI_GETPENSIDEMOVETHRESHOLD
SPI_GETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.
SPI_SETACTIVEWINDOWTRACKING
0x1001
Imposta il rilevamento della finestra attiva (attivazione della finestra attivata dal mouse) attivato o disattivato. Impostare pvParam su TRUE per on o FALSE per off.
SPI_SETACTIVEWNDTRKZORDER
0x100D
Determina se le finestre attivate tramite il rilevamento delle finestre attive devono essere portate in alto. Impostare pvParam su TRUE per on o FALSE per off.
SPI_SETACTIVEWNDTRKTIMEOUT
0x2003
Imposta il ritardo di rilevamento della finestra attiva. Impostare pvParam sul numero di millisecondi per ritardare prima di attivare la finestra sotto il puntatore del mouse.
SPI_SETANIMATION
0x0049
Imposta gli effetti di animazione associati alle azioni utente. Il parametro pvParam deve puntare a una struttura ANIMATIONINFO contenente i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(ANIMATIONINFO).
SPI_SETBORDER
0x0006
Imposta il fattore di moltiplicazione del bordo che determina la larghezza del bordo di ridimensionamento di una finestra. Il parametro uiParam specifica il nuovo valore.
SPI_SETCARETWIDTH
0x2007
Imposta la larghezza del cursore nei controlli di modifica. Impostare pvParam sulla larghezza desiderata, in pixel. Il valore predefinito e minimo è 1.
SPI_SETDOCKMOVING
0x0091
Imposta un valore che indica se una finestra è ancorata quando viene spostata nelle destinazioni di ancoraggio superiore, sinistro o destro su un monitor o una matrice di monitoraggio. Impostare pvParam su TRUE per on o FALSE per off.

SPI_GETWINARRANGING deve essere TRUE per abilitare questo comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETDRAGFROMMAXIMIZE
0x008D
Imposta un valore che indica se una finestra ingrandita viene ripristinata quando la barra della didascalia viene trascinata. Impostare pvParam su TRUE per on o FALSE per off.

SPI_GETWINARRANGING deve essere TRUE per abilitare questo comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETDRAGFULLWINDOWS
0x0025
Imposta il trascinamento di finestre complete attiva o disattivata. Il parametro uiParam specifica TRUE per on o FALSE per off.
SPI_SETDRAGHEIGHT
0x004D
Imposta l'altezza, in pixel, del rettangolo utilizzato per rilevare l'inizio di un'operazione di trascinamento. Impostare uiParam sul nuovo valore. Per recuperare l'altezza del trascinamento, chiamare GetSystemMetrics con il flag SM_CYDRAG .
SPI_SETDRAGWIDTH
0x004C
Imposta la larghezza, in pixel, del rettangolo utilizzato per rilevare l'inizio di un'operazione di trascinamento. Impostare uiParam sul nuovo valore. Per recuperare la larghezza del trascinamento, chiamare GetSystemMetrics con il flag SM_CXDRAG .
SPI_SETFOREGROUNDFLASHCOUNT
0x2005
Imposta il numero di volte in cui SetForegroundWindow lampeggia il pulsante della barra delle applicazioni quando rifiuta una richiesta di opzione in primo piano. Impostare pvParam sul numero di volte in cui eseguire il flashing.
SPI_SETFOREGROUNDLOCKTIMEOUT
0x2001
Imposta la quantità di tempo dopo l'input dell'utente, in millisecondi, durante la quale il sistema non consente alle applicazioni di forzarsi in primo piano. Impostare pvParam sul nuovo valore di timeout.

Il thread chiamante deve essere in grado di modificare la finestra in primo piano. In caso contrario, la chiamata non riesce.

SPI_SETMINIMIZEDMETRICS
0x002C
Imposta le metriche associate alle finestre ridotte a icona. Il parametro pvParam deve puntare a una struttura MINIMIZEDMETRICS che contiene i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(MINIMIZEDMETRICS).
SPI_SETMOUSEDOCKTHRESHOLD
0x007F
Imposta la soglia in pixel in cui il comportamento di ancoraggio viene attivato usando un mouse per trascinare una finestra sul bordo di un monitor o di una matrice di monitoraggio. La soglia predefinita è 1. Il parametro pvParam deve puntare a una variabile DWORD contenente il nuovo valore.

SPI_GETWINARRANGING deve essere TRUE per abilitare questo comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETMOUSEDRAGOUTTHRESHOLD
0x0085
Imposta la soglia in pixel in cui il comportamento di dedocking viene attivato usando un mouse per trascinare una finestra dal bordo di un monitor o di una matrice di monitoraggio al centro. La soglia predefinita è 20. Il parametro pvParam deve puntare a una variabile DWORD contenente il nuovo valore.

SPI_GETWINARRANGING deve essere TRUE per abilitare questo comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETMOUSESIDEMOVETHRESHOLD
0x0089
Imposta la soglia in pixel dalla parte superiore del monitor in cui viene ripristinata una finestra ingrandita verticalmente quando viene trascinata con il mouse. La soglia predefinita è 50. Il parametro pvParam deve puntare a una variabile DWORD contenente il nuovo valore.

SPI_GETWINARRANGING deve essere TRUE per abilitare questo comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETNONCLIENTMETRICS
0x002A
Imposta le metriche associate all'area non client di finestre non ridimensionate. Il parametro pvParam deve puntare a una struttura NONCLIENTMETRICS che contiene i nuovi parametri. Impostare il membro cbSize di questa struttura e il parametro uiParam su sizeof(NONCLIENTMETRICS). Inoltre, il membro lfHeight della struttura LOGFONT deve essere un valore negativo.
SPI_SETPENDOCKTHRESHOLD
0x0081
Imposta la soglia in pixel in cui il comportamento di ancoraggio viene attivato usando una penna per trascinare una finestra sul bordo di un monitor o di una matrice di monitoraggio. La soglia predefinita è 30. Il parametro pvParam deve puntare a una variabile DWORD contenente il nuovo valore.

SPI_GETWINARRANGING deve essere TRUE per abilitare questo comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETPENDRAGOUTTHRESHOLD
0x0087
Imposta la soglia in pixel in cui il comportamento di scollegamento viene attivato usando una penna per trascinare una finestra dal bordo di un monitor o di una matrice di monitoraggio al centro. La soglia predefinita è 30. Il parametro pvParam deve puntare a una variabile DWORD contenente il nuovo valore.

SPI_GETWINARRANGING deve essere TRUE per abilitare questo comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETPENSIDEMOVETHRESHOLD
0x008B
Imposta la soglia in pixel dalla parte superiore del monitor in cui viene ripristinata una finestra ingrandita verticalmente quando viene trascinata con una penna. La soglia predefinita è 50. Il parametro pvParam deve puntare a una variabile DWORD contenente il nuovo valore.

SPI_GETWINARRANGING deve essere TRUE per abilitare questo comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETSHOWIMEUI
0x006F
Imposta se la finestra di stato IME è visibile o meno per ogni utente. Il parametro uiParam specifica TRUE per on o FALSE per off.
SPI_SETSNAPSIZING
0x008F
Imposta un valore che indica se una finestra è ingrandita verticalmente quando viene ridimensionata nella parte superiore o inferiore del monitor. Impostare pvParam su TRUE per on o FALSE per off.

SPI_GETWINARRANGING deve essere TRUE per abilitare questo comportamento.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

SPI_SETWINARRANGING
0x0083
Imposta un valore che indica se la disposizione della finestra è abilitata. Impostare pvParam su TRUE per on o FALSE per off.

La disposizione delle finestre riduce il numero di interazioni tra mouse, penna o tocco necessarie per spostare e ridimensionare le finestre di primo livello semplificando il comportamento predefinito di una finestra quando viene trascinato o ridimensionato.

I parametri seguenti impostano le singole impostazioni di disposizione delle finestre:

SPI_SETDOCKMOVING
SPI_SETMOUSEDOCKTHRESHOLD
SPI_SETMOUSEDRAGOUTTHRESHOLD
SPI_SETMOUSESIDEMOVETHRESHOLD
SPI_SETPENDOCKTHRESHOLD
SPI_SETPENDRAGOUTTHRESHOLD
SPI_SETPENSIDEMOVETHRESHOLD
SPI_SETSNAPSIZING
Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP/2000: Questo parametro non è supportato.

[in] uiParam

Tipo: UINT

Un parametro il cui utilizzo e formato dipende dal parametro di sistema su cui vengono eseguite query o impostate. Per altre informazioni sui parametri a livello di sistema, vedere il parametro uiAction . Se non diversamente indicato, è necessario specificare zero per questo parametro.

[in, out] pvParam

Tipo: PVOID

Un parametro il cui utilizzo e formato dipende dal parametro di sistema su cui vengono eseguite query o impostate. Per altre informazioni sui parametri a livello di sistema, vedere il parametro uiAction . Se non diversamente indicato, è necessario specificare NULL per questo parametro. Per informazioni sul tipo di dati PVOID , vedere Tipi di dati Windows.

[in] fWinIni

Tipo: UINT

Se viene impostato un parametro di sistema, specifica se il profilo utente deve essere aggiornato e, in tal caso, se il messaggio di WM_SETTINGCHANGE deve essere trasmesso a tutte le finestre di primo livello per notificarle della modifica.

Questo parametro può essere zero se non si desidera aggiornare il profilo utente o trasmettere il messaggio di WM_SETTINGCHANGE oppure può essere uno o più dei valori seguenti.

Valore Significato
SPIF_UPDATEINIFILE
Scrive la nuova impostazione del parametro a livello di sistema nel profilo utente.
SPIF_SENDCHANGE
Trasmette il messaggio WM_SETTINGCHANGE dopo l'aggiornamento del profilo utente.
SPIF_SENDWININICHANGE
Uguale a SPIF_SENDCHANGE.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Questa funzione è destinata all'uso con le applicazioni che consentono all'utente di personalizzare l'ambiente.

Un nome di layout della tastiera deve essere derivato dal valore esadecimale dell'identificatore di lingua corrispondente al layout. Ad esempio, l'inglese degli Stati Uniti ha un identificatore di lingua 0x0409, quindi il layout inglese primario degli Stati Uniti è denominato "00000409". Le varianti del layout inglese degli Stati Uniti, ad esempio il layout Dvorak, sono denominate "00010409", "00020409" e così via. Per un elenco degli identificatori di lingua primaria e degli identificatori di sottolanguage che costituiscono un identificatore di lingua, vedere la macro MAKELANGID .

Esiste una differenza tra la combinazione di colori a contrasto elevato e la modalità contrasto elevato. La combinazione di colori a contrasto elevato modifica i colori di sistema in colori che hanno un contrasto evidente; si passa a questa combinazione di colori utilizzando le opzioni di visualizzazione nel pannello di controllo. La modalità contrasto elevato, che usa SPI_GETHIGHCONTRAST e SPI_SETHIGHCONTRAST, consiglia alle applicazioni di modificarne l'aspetto per gli utenti con problemi di vista. Implica elementi come gli avvisi acustici per gli utenti e la combinazione di colori personalizzata (usando le opzioni di accessibilità nel pannello di controllo). Per altre informazioni, vedere HIGHCONTRAST. Per altre informazioni sulle funzionalità di accessibilità generali, vedere Accessibilità.

Durante il tempo in cui il pulsante primario viene tenuto premuto per attivare la funzionalità Mouse ClickLock, l'utente può spostare il mouse. Dopo che il pulsante primario è bloccato, il rilascio del pulsante primario non comporta un messaggio di WM_LBUTTONUP . Di conseguenza, apparirà a un'applicazione che il pulsante primario è ancora inattivo. Qualsiasi messaggio pulsante successivo rilascia il pulsante primario, inviando un messaggio di WM_LBUTTONUP all'applicazione, in modo che il pulsante possa essere sbloccato a livello di codice o tramite l'utente facendo clic su qualsiasi pulsante.

Questa API non riconosce i valori DPI e non deve essere usata se il thread chiamante è compatibile con DPI per monitor. Per la versione compatibile con DPI di questa API, vedere SystemParametersInfoForDPI. Per altre informazioni sulla consapevolezza dpi, vedere la documentazione di Windows High DPI.For more information on DPI awareness, see the Windows High DPI documentation.

Esempio

Nell'esempio seguente viene usato SystemParametersInfo per raddoppiare la velocità del mouse.


#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
    }  
}

Nota

L'intestazione winuser.h definisce SystemParametersInfo come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione winuser.h (include Windows.h)
Libreria User32.lib
DLL User32.dll
Set di API ext-ms-win-ntuser-sysparams-ext-l1-1-0 (introdotto in Windows 8)

Vedi anche

ACCESSTIMEOUT

ANIMATIONINFO

AUDIODESCRIPTION

FILTERKEYS

HIGHCONTRAST

ICONMETRICS

LOGFONT

MAKELANGID

RIDUCI AL MINIMO LE DIMENSIONI

MOUSEKEYS

NONCLIENTMETRICS

RECT

SERIALKEYS

SUONIENTRY

STICKYKEYS

SystemParametersInfoForDPI

TOGGLEKEYS

WM_SETTINGCHANGE

Tipi di dati Windows