SystemParametersInfoW 函式 (winuser.h)
重要
有些資訊與發行前版本產品有關,在正式發行前可能會大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
擷取或設定其中一個全系統參數的值。 此函式也可以在設定參數時更新使用者配置檔。
語法
BOOL SystemParametersInfoW(
[in] UINT uiAction,
[in] UINT uiParam,
[in, out] PVOID pvParam,
[in] UINT fWinIni
);
參數
[in] uiAction
類型: UINT
要擷取或設定的系統範圍參數。 可能的值會組織在下列相關參數的數據表中:
- 輔助功能參數
- 桌面參數
- 圖示參數
- 輸入參數
- 功能表參數
- 電源參數
- 屏幕保護參數
- 逾時參數
- UI 效果參數
- 窗口參數
以下是輔助功能參數。
輔助功能參數 | 意義 |
---|---|
|
擷取與輔助功能功能相關聯逾時期間的相關信息。
pvParam 參數必須指向接收資訊的 ACCESSTIMEOUT 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(ACCESSTIMEOUT) 。
|
|
判斷是否啟用或停用音訊描述。
pvParam 參數是 AUDIODESCRIPTION 結構的指標。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(AUDIODESCRIPTION) 。
雖然有視覺障礙的使用者可以在視訊內容中聽到音訊,但影片中有許多動作沒有對應的音訊。 影片中發生狀況的特定音訊描述可協助這些使用者更了解內容。 此旗標可讓您判斷是否已啟用音訊描述,以及該語言的哪個語言。 Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
判斷是否啟用或停用動畫。
pvParam 參數必須指向BOOL變數,如果啟用動畫則為TRUE,否則為 FALSE。
顯示功能,例如閃爍、閃爍、閃爍和移動內容,可能會造成具有相片敏感性癥狀的使用者。 此旗標可讓您判斷是否已在工作區中停用這類動畫。 Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
判斷是否啟用或停用重疊的內容。
pvParam 參數必須指向BOOL變數,如果啟用則為TRUE,否則為 FALSE。
顯示背景影像、紋理背景、檔上的浮水印、Alpha 混合和透明度等功能,可以降低前景和背景之間的對比,讓使用者難以在畫面上看到物件。 此旗標可讓您判斷是否已停用這類重疊的內容。 Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
擷取 FilterKeys 輔助功能功能的相關信息。
pvParam 參數必須指向接收資訊的 FILTERKEYS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(FILTERKEYS) 。
|
|
擷取以 DrawFocusRect 繪製之焦點矩形上邊緣和下邊緣的高度,以像素為單位。
pvParam 參數必須指向UINT值。
Windows 2000: 不支援此參數。 |
|
擷取以 DrawFocusRect 繪製之焦點矩形的左右邊緣的寬度,以像素為單位。
pvParam 參數必須指向UINT。
Windows 2000: 不支援此參數。 |
|
擷取 HighContrast 輔助功能功能的相關信息。
pvParam 參數必須指向接收資訊的 HIGHCONTRAST 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(HIGHCONTRAST) 。
如需一般討論,請參閱。 |
|
擷取值,這個值會決定 Windows 8 是否使用硬體的預設縮放平臺來顯示應用程式,或前往下一個較高的穩定時間。 此值是以目前「讓螢幕上的所有專案變大」設定為基礎,可在計算機設定的 [輕鬆存取] 區段中找到:1 為開啟,0 為關閉。
應用程式可以為數個縮放比例各提供文字和影像資源:100%、140% 和 180%。 提供針對特定規模優化的個別資源,可避免因重設大小而扭曲。 Windows 8 會根據許多因素來決定適當的縮放比例,包括螢幕大小和圖元密度。 選取 [讓螢幕上的所有專案變大] 時, (SPI_GETLOGICALDPIOVERRIDE 傳回值 1) ,Windows 會使用來自下一個較高平台的資源。 例如,在 Windows 判斷的硬體應該使用 SCALE_100_PERCENT小數位數的情況下,此覆寫會讓 Windows 使用 SCALE_140_PERCENT 小數位數值,假設它不會違反其他條件約束。
注意 您不應該使用此值。 後續版本的 Windows 可能會變更或無法使用。 請改用 GetScaleFactorForDevice 函式或 DisplayProperties 類別來擷取慣用的縮放比例。 傳統型應用程式應該使用桌面邏輯 DPI,而不是縮放比例。 桌面邏輯 DPI 可以透過 GetDeviceCaps 函式擷取。
|
|
擷取應該以秒為單位顯示通知快顯的時間。
pvParam 參數必須指向接收訊息持續時間的 ULONG。
具有視覺障礙或認知條件的使用者,例如 ADHD 和障礙可能需要較長的時間才能讀取通知訊息中的文字。 此旗標可讓您擷取訊息持續時間。 Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
擷取滑鼠 ClickLock 功能的狀態。
pvParam 參數必須指向BOOL變數,如果啟用則為TRUE,否則為 FALSE。 如需詳細資訊,請參閱 滑鼠輸入概觀。
Windows 2000: 不支援此參數。 |
|
擷取鎖定主要滑鼠按鈕之前的時間延遲。
pvParam 參數必須指向接收時間延遲的 DWORD,以毫秒為單位。 只有在 SPI_SETMOUSECLICKLOCK 設定為 TRUE 時,才會啟用此設定。 如需詳細資訊,請參閱 滑鼠輸入概觀。
Windows 2000: 不支援此參數。 |
|
擷取 MouseKeys 輔助功能功能的相關信息。
pvParam 參數必須指向接收資訊的 MOUSEKEYS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(MOUSEKEYS) 。
|
|
擷取 Mouse Sonar 功能的狀態。
pvParam 參數必須指向BOOL變數,如果啟用或 FALSE,則會收到TRUE。 如需詳細資訊,請參閱 滑鼠輸入概觀。
Windows 2000: 不支援此參數。 |
|
擷取滑鼠消失功能的狀態。
pvParam 參數必須指向BOOL變數,如果啟用或 FALSE,則會收到TRUE。 如需詳細資訊,請參閱 滑鼠輸入概觀。
Windows 2000: 不支援此參數。 |
|
判斷螢幕檢閱者公用程式是否正在執行。 螢幕檢閱者公用程式會將文字資訊導向輸出裝置,例如語音合成器或 Braille 顯示器。 設定此旗標時,應用程式應該在圖形化呈現信息的情況下提供文字資訊。
pvParam 參數是 BOOL 變數的指標,如果螢幕檢閱者公用程式正在執行,則會收到 TRUE,否則為 FALSE。
注意 朗讀程式是 Windows 隨附的螢幕助讀程式,不會設定 SPI_SETSCREENREADER 或 SPI_GETSCREENREADER 旗標。
|
|
不支援此參數。
Windows Server 2003 和 Windows XP/2000: 用戶應該透過 [控制面板] 來控制此設定。 |
|
判斷 [顯示音效] 輔助功能旗標是否開啟或關閉。 如果開啟,使用者需要應用程式以可視化方式呈現資訊,否則只會以可聽見的形式呈現資訊。
pvParam 參數必須指向BOOL變數,如果功能已開啟,則為 FALSE。
使用此值相當於使用 SM_SHOWSOUNDS呼叫 GetSystemMetrics。 這是建議的呼叫。 |
|
擷取 SoundSentry 輔助功能功能的相關信息。
pvParam 參數必須指向接收資訊的 SOUNDSENTRY 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(SOUNDSENTRY) 。
|
|
擷取 StickyKeys 輔助功能功能的相關信息。
pvParam 參數必須指向接收資訊的 STICKYKEYS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(STICKYKEYS) 。
|
|
擷取 ToggleKeys 輔助功能功能的相關信息。
pvParam 參數必須指向接收資訊的 TOGGLEKEYS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(TOGGLEKEYS) 。
|
|
設定與輔助功能功能相關聯的逾時期間。
pvParam 參數必須指向包含新參數的 ACCESSTIMEOUT 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(ACCESSTIMEOUT) 。
|
|
開啟或關閉音訊描述功能。
pvParam 參數是 AUDIODESCRIPTION 結構的指標。
雖然視覺受損的使用者可以在視訊內容中聽到音訊,但視訊中有許多沒有對應音訊的動作。 影片中發生狀況的特定音訊描述可協助這些使用者更了解內容。 此旗標可讓您以所提供的語言啟用或停用音訊描述。 Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
開啟或關閉工作區動畫。
pvParam 參數是BOOL變數。 將 pvParam 設定為 TRUE ,以在工作區中啟用動畫和其他暫時性效果,或 將 FALSE 設為停用 它們。
顯示功能,例如閃爍、閃爍、閃爍和移動內容,可能會造成具有相片敏感性癥狀的使用者。 此旗標可讓您啟用或停用所有這類動畫。 Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
開啟或關閉重疊的內容 (,例如背景影像和浮浮浮浮水印) 。
pvParam 參數是BOOL變數。 將 pvParam 設定為 TRUE 以停用重疊的內容,或 將 FALSE 設定為啟用重疊的內容。
顯示背景影像、紋理背景、檔上的浮水印、Alpha 混合和透明度等功能,可以降低前景和背景之間的對比,讓使用者難以在畫面上看到物件。 此旗標可讓您啟用或停用所有這類重疊的內容。 Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
設定 FilterKeys 輔助功能功能的參數。
pvParam 參數必須指向包含新參數的 FILTERKEYS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(FILTERKEYS) 。
|
|
將 使用 DrawFocusRect 繪製之焦點矩形的上邊緣和下邊緣的高度設定為 pvParam 參數的值。
Windows 2000: 不支援此參數。 |
|
將 使用 DrawFocusRect 繪製之焦點矩形的左邊緣和右邊緣的高度設定為 pvParam 參數的值。
Windows 2000: 不支援此參數。 |
|
設定 HighContrast 輔助功能功能的參數。
pvParam 參數必須指向包含新參數的 HIGHCONTRAST 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(HIGHCONTRAST) 。
|
|
請勿使用。 |
|
設定應該以秒為單位顯示通知快顯的時間。
pvParam 參數會指定訊息持續時間。
具有視覺障礙或認知條件的使用者,例如 ADHD 和障礙可能需要較長的時間才能讀取通知訊息中的文字。 此旗標可讓您設定訊息持續時間。 Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
開啟或關閉滑鼠 ClickLock 輔助功能功能。 當按下該按鈕並按住 SPI_SETMOUSECLICKLOCKTIME所指定的時間時,此功能會暫時鎖定主要滑鼠按鈕。
pvParam 參數會針對 on 指定 TRUE,或針對 off 指定 FALSE。 預設值是 off。 For more information, see Remarks and AboutMouse Input.
Windows 2000: 不支援此參數。 |
|
調整鎖定主要滑鼠按鈕之前的時間延遲。
uiParam 參數應該設定為 0。
pvParam 參數會指向 DWORD,以毫秒為單位指定時間延遲。 例如,針對 1 秒延遲指定 1000。 預設值為 1200。 如需詳細資訊,請參閱 滑鼠輸入概觀。
Windows 2000: 不支援此參數。 |
|
設定 MouseKeys 輔助功能功能的參數。
pvParam 參數必須指向包含新參數的 MOUSEKEYS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(MOUSEKEYS) 。
|
|
開啟或關閉 Sonar 輔助功能功能。 當使用者按下並放開 CTRL 鍵時,此功能會簡短地顯示滑鼠指標周圍的數個同心圓。
pvParam 參數會針對 on 指定 TRUE,並針對 off 指定 FALSE。 預設值是 off。 如需詳細資訊,請參閱 滑鼠輸入概觀。
Windows 2000: 不支援此參數。 |
|
開啟或關閉 [消失] 功能。 當使用者輸入時,此功能會隱藏滑鼠指標;當用戶移動滑鼠時,指標會重新出現。
pvParam 參數會針對 on 指定 TRUE,並針對 off 指定 FALSE。 預設值是 off。 如需詳細資訊,請參閱 滑鼠輸入概觀。
Windows 2000: 不支援此參數。 |
|
判斷螢幕檢閱公用程式是否正在執行。
uiParam 參數會針對 on 指定 TRUE,或針對 off 指定 FALSE。
注意 朗讀程式是 Windows 隨附的螢幕助讀程式,不會設定 SPI_SETSCREENREADER 或 SPI_GETSCREENREADER 旗標。
|
|
不支援此參數。
Windows Server 2003 和 Windows XP/2000: 用戶應該透過 [控制面板] 來控制此設定。 |
|
開啟或關閉 ShowSounds 輔助功能功能。 uiParam 參數會針對 on 指定 TRUE,或針對 off 指定 FALSE。 |
|
設定 SoundSentry 輔助功能功能的參數。
pvParam 參數必須指向包含新參數的 SOUNDSENTRY 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(SOUNDSENTRY) 。
|
|
設定 StickyKeys 輔助功能功能的參數。
pvParam 參數必須指向包含新參數的 STICKYKEYS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(STICKYKEYS) 。
|
|
設定 ToggleKeys 輔助功能功能的參數。
pvParam 參數必須指向包含新參數的 TOGGLEKEYS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(TOGGLEKEYS) 。
|
以下是桌面參數。
桌面參數 | 意義 |
---|---|
|
判斷是否啟用 ClearType。
pvParam 參數必須指向BOOL變數,如果已啟用 ClearType,則為TRUE,否則為 FALSE。
ClearType 是一種軟體技術,可改善在 () 監視器 (LIQUID 玻璃顯示器上的文字可讀性。 Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
擷取桌面桌布之點陣圖檔案的完整路徑。 pvParam 參數必須指向緩衝區,才能接收以 Null 終止的路徑字串。 將 uiParam 參數設定為 pvParam 緩衝區的大小,以字元為單位。 傳回的字串不會超過 MAX_PATH 個字元。 如果沒有桌面桌布,則傳回的字串是空的。 |
|
判斷是否啟用陰影效果。
pvParam 參數必須指向BOOL變數,如果啟用則傳回TRUE,如果停用則傳回 FALSE。
Windows 2000: 不支援此參數。 |
|
判斷原生用戶功能表是否具有一般功能表外觀。
pvParam 參數必須指向BOOL變數,如果已設定一般功能表外觀,則傳回TRUE,否則為FALSE。
Windows 2000: 不支援此參數。 |
|
判斷是否啟用字型平滑處理功能。 這項功能會使用字型反鋸齒來讓字型曲線在不同的灰階上繪製圖元,讓字型曲線看起來更平滑。
pvParam 參數必須指向BOOL變數,如果啟用此功能,則為 FALSE。 |
|
擷取 ClearType 平滑處理中使用的對比值。
pvParam 參數必須指向接收資訊的 UINT。 有效的對比值是從 1000 到 2200。 預設值為 1400。
Windows 2000: 不支援此參數。 |
|
擷取字型平滑方向。
pvParam 參數必須指向接收資訊的 UINT。 可能的值為 FE_FONTSMOOTHINGORIENTATIONBGR ( 藍色-綠色-紅色) 和 FE_FONTSMOOTHINGORIENTATIONRGB (紅色-綠色-藍色) 。
Windows XP/2000: 在 Windows XP 搭配 SP2 之前,不支援此參數。 |
|
擷取字型平滑處理的類型。
pvParam 參數必須指向接收資訊的 UINT。 可能的值為 FE_FONTSMOOTHINGSTANDARD 和 FE_FONTSMOOTHINGCLEARTYPE。
Windows 2000: 不支援此參數。 |
|
擷取主要顯示監視器上工作區的大小。 工作區是由系統任務列或應用程式桌面工具列所遮蔽的畫面部分。
pvParam 參數必須指向可接收工作區座標的 RECT 結構,以實體圖元大小表示。 呼叫端的任何 DPI 虛擬化模式都不會影響此輸出。
若要取得主要顯示監視器以外的監視器工作區域,請呼叫 GetMonitorInfo 函式。 |
|
開啟或關閉 ClearType。
pvParam 參數是BOOL變數。 將 pvParam 設定為 TRUE 以啟用 ClearType 或 FALSE 以停用它。
ClearType 是一種軟體技術,可改善在文本框中的文字可讀性。 Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
重載系統數據指標。 將 uiParam 參數設定為零, 並將 pvParam 參數設定為 NULL。 |
|
從 WIN.INI 檔案讀取 Pattern= 設定,以設定目前的桌面模式。 |
|
注意 使用 SPI_SETDESKWALLPAPER 旗標時,除非指定的檔案不存在時發生錯誤 (,否則 SystemParametersInfo 會傳回 TRUE ,例如指定的檔案不存在時) 。
|
|
啟用或停用陰影效果。 將 pvParam 設定為 TRUE 以啟用陰影效果或 FALSE 以停用它。 您也必須在視窗類別樣式中 CS_DROPSHADOW 。
Windows 2000: 不支援此參數。 |
|
啟用或停用原生使用者功能表的一般功能表外觀。 將 pvParam 設定為 TRUE 以啟用一般功能表外觀或 FALSE 以停用它。
啟用時,功能表欄會針對功能表欄背景使用 COLOR_MENUBAR 、 COLOR_MENU 功能表快顯背景、 COLOR_MENUHILIGHT 填滿目前功能表選取範圍的填滿,以及目前功能表選取範圍的大綱 COLOR_HILIGHT 。 如果停用,則會使用與 Windows 2000 相同的計量和色彩來繪製功能表。 Windows 2000: 不支援此參數。 |
|
啟用或停用字型平滑功能,其使用字型反鋸齒讓字型曲線在不同的灰階上繪製圖元來呈現更平滑。
若要啟用此功能,請將 uiParam 參數設定為 TRUE。 若要停用此功能,請將 uiParam 設定為 FALSE。 |
|
設定 ClearType 平滑處理中使用的對比值。
pvParam 參數是對比值。 有效的對比值是從 1000 到 2200。 預設值為 1400。
SPI_SETFONTSMOOTHINGTYPE 也必須設定為 FE_FONTSMOOTHINGCLEARTYPE。 Windows 2000: 不支援此參數。 |
|
設定字型平滑方向。
pvParam 參數FE_FONTSMOOTHINGORIENTATIONBGR ( 藍色-綠色-紅色) 或FE_FONTSMOOTHINGORIENTATIONRGB ( 紅色-綠色-藍色) 。
Windows XP/2000: 在 Windows XP 搭配 SP2 之前,不支援此參數。 |
|
設定字型平滑處理類型。 如果使用標準反別名,則 pvParam 參數為 FE_FONTSMOOTHINGSTANDARD,如果使用 ClearType,則為 FE_FONTSMOOTHINGCLEARTYPE。 預設值為 FE_FONTSMOOTHINGSTANDARD。
也必須設定SPI_SETFONTSMOOTHING。 Windows 2000: 不支援此參數。 |
|
設定工作區域的大小。 工作區是由系統任務列或應用程式桌面工具列所遮蔽的畫面部分。 pvParam 參數是 RECT 結構的指標,指定以虛擬螢幕座標表示的新工作區矩形。 在具有多個顯示監視器的系統中,函式會設定包含指定矩形之監視器的工作區域。 |
以下是圖示參數。
圖示參數 | 意義 |
---|---|
|
擷取與圖示相關聯的計量。
pvParam 參數必須指向接收資訊的 ICONMETRICS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(ICONMETRICS) 。
|
|
擷取目前圖示標題字型的邏輯字型資訊。 uiParam 參數會指定LOGFONT結構的大小,pvParam 參數必須指向要填入的LOGFONT結構。 |
|
判斷是否啟用圖示標題換行。 pvParam 參數必須指向在啟用時接收 TRUE 的 BOOL 變數,否則為 FALSE。 |
|
會設定或擷取圖示單元格的寬度,以像素為單位。 系統使用這個矩形,在大型圖示檢視中排列圖示。
若要設定此值,請將 uiParam 設定為新的值,並將 pvParam 設定為 NULL。 您無法將此值設定為小於 SM_CXICON。 若要擷取此值, pvParam 必須指向接收目前值的整數。 |
|
設定或擷取圖示單元格的高度,以像素為單位。
若要設定此值,請將 uiParam 設定為新的值,並將 pvParam 設定為 NULL。 您無法將此值設定為小於 SM_CYICON。 若要擷取此值, pvParam 必須指向接收目前值的整數。 |
|
設定與圖示相關聯的計量。
pvParam 參數必須指向包含新參數的 ICONMETRICS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(ICONMETRICS) 。
|
|
重載系統圖示。 將 uiParam 參數設定為零, 並將 pvParam 參數設定為 NULL。 |
|
設定用於圖示標題的字型。 uiParam 參數會指定LOGFONT結構的大小,pvParam 參數必須指向LOGFONT結構。 |
|
開啟或關閉圖示標題換行。 uiParam 參數會針對 on 指定 TRUE,或為 off 指定 FALSE。 |
以下是輸入參數。 它們包含與鍵盤、滑鼠、手寫筆、輸入語言和警告擷取器相關的參數。
輸入參數 | 意義 |
---|---|
|
判斷警告 Beeper 是否開啟。
pvParam 參數必須指向BOOL變數,如果 Beeper 為開啟,則為 FALSE。 |
|
擷取 BOOL ,指出應用程式是否可以藉由呼叫 SendInput 函式來模擬鍵盤或滑鼠輸入來重設螢幕保護的定時器。 pvParam 參數必須指向BOOL變數,如果模擬輸入將會遭到封鎖,則為TRUE,否則為 FALSE。 |
|
擷取目前的聯繫人視覺效果設定。 pvParam 參數必須指向接收設定的ULONG變數。 如需詳細資訊,請參閱 聯繫人視覺效果。 |
|
擷取系統預設輸入語言的輸入地區設定標識碼。 pvParam 參數必須指向接收此值的 HKL 變數。 如需詳細資訊,請參閱 語言、地區設定和鍵盤配置。 |
|
擷取目前的手勢視覺效果設定。 pvParam 參數必須指向接收設定的ULONG變數。 如需詳細資訊,請參閱 手勢視覺效果。 |
|
判斷功能表訪問鍵是否一律加上底線。 pvParam 參數必須指向 BOOL 變數,如果功能表訪問鍵一律加上底線,則為 FALSE;只有當鍵盤啟動功能表時才會加上底線,則為 FALSE。 |
|
擷取鍵盤重複延遲設定,這是介於0 (大約250毫秒延遲) 到3 (大約1秒延遲) 的值。 與每個值相關聯的實際延遲可能會因硬體而異。 pvParam 參數必須指向接收設定的整數變數。 |
|
判斷使用者是否依賴鍵盤而非滑鼠,而且希望應用程式顯示不會隱藏的鍵盤介面。 pvParam 參數必須指向BOOL變數,如果使用者依賴鍵盤,則會收到TRUE;否則為 FALSE。 |
|
擷取鍵盤重複速度設定,這是介於0 (大約每秒2.5次重複) 到每秒31 (大約30次重複) 的值。 實際重複率與硬體相依,且可能會隨著線性刻度而有所不同,最多可達 20%。 pvParam 參數必須指向接收設定的 DWORD 變數。 |
|
擷取兩個滑鼠閾值和滑鼠加速。 pvParam 參數必須指向接收這些值的三個整數數位列。 如需詳細資訊 ,請參閱mouse_event 。 |
|
擷取滑鼠指標必須保留的矩形高度,以像素為單位, 讓 TrackMouseEvent 產生 WM_MOUSEHOVER 訊息。 pvParam 參數必須指向接收高度的 UINT 變數。 |
|
擷取滑鼠指標必須停留在 TrackMouseEvent 暫留矩形的時間,以毫秒為單位,以產生 WM_MOUSEHOVER 訊息。 pvParam 參數必須指向接收時間的 UINT 變數。 |
|
擷取滑鼠指標必須保留的矩形寬度,以像素為單位, 讓 TrackMouseEvent 產生 WM_MOUSEHOVER 訊息。 pvParam 參數必須指向接收寬度的 UINT 變數。 |
|
擷取目前的滑鼠速度。 滑鼠速度會根據滑鼠移動的距離來決定指標移動的距離。 pvParam 參數必須指向一個整數,以接收介於 1 (最慢) 和 20 (最快) 之間的值。 值為10是預設值。 值可由使用者使用滑鼠控制面板應用程式,或使用 SPI_SETMOUSESPEED的應用程式來設定。 |
|
判斷是否啟用滑鼠線索功能。 此功能可藉由簡短顯示游標的尾端並快速清除游標,來改善滑鼠游標移動的可見度。
pvParam 參數必須指向接收值的整數變數。 如果值為零或 1,則會停用此功能。 如果值大於 1,則會啟用此功能,且值表示在尾端繪製的數據指標數目。 未使用 uiParam 參數。 Windows 2000: 不支援此參數。 |
|
擷取滾輪按鈕輸入的路由設定。 路由設定會決定是否將滾輪按鈕輸入傳送至焦點 (前景) 或滑鼠游標下的應用程式。
pvParam 參數必須指向接收路由選項的 DWORD 變數。 如果值為零或MOUSEWHEEL_ROUTING_FOCUS,滑鼠滾輪輸入會傳遞至具有焦點的應用程式。 如果值為 1 或MOUSEWHEEL_ROUTING_HYBRID (默认) ,滑鼠滾輪輸入會傳遞至 (傳統型應用程式) 或滑鼠游標下的應用程式, (Windows 市集應用程式) 。 未使用 uiParam 參數。 |
|
擷取目前的畫筆手勢視覺效果設定。 pvParam 參數必須指向接收設定的ULONG變數。 如需詳細資訊,請參閱 畫筆視覺效果。 |
|
判斷是否啟用嵌入式管理單元到預設按鈕功能。 如果啟用,滑鼠游標會自動移至對話框的預設按鈕,例如 [確定 ] 或 [ 套用]。 pvParam 參數必須指向BOOL變數,如果功能已開啟,則為 FALSE。 |
|
從 Windows 8 開始: 判斷系統語言列是啟用還是停用。 pvParam 參數必須指向BOOL變數,如果啟用語言列,則為TRUE,否則為 FALSE。 |
|
從 Windows 8 開始: 判斷使用中輸入設定是否具有每一線程的本機 (、 TRUE) 或全域 (會話、 FALSE) 範圍。 pvParam 參數必須指向BOOL變數。 |
|
從 Windows 11 版本 24H2 開始: 擷取精確度觸控板的詳細數據,包括與觸控板相關的使用者設定和系統資訊。
pvParam 參數必須指向TOUCHPAD_PARAMETERS結構。 uiParam 參數必須指定 結構的大小。 TOUCHPAD_PARAMETERS 結構中 versionNumber 欄位的值必須設定為所使用結構版本的適當值。 |
|
擷取移動水平滑鼠滾輪時要捲動的字元數。 pvParam 參數必須指向接收行數的 UINT 變數。 預設值是 3。 |
|
擷取移動垂直滑鼠滾輪時要捲動的行數。 pvParam 參數必須指向接收行數的 UINT 變數。 預設值是 3。 |
|
開啟或關閉警告嗶聲器。 uiParam 參數會針對 on 指定 TRUE,或針對 off 指定 FALSE。 |
|
藉由呼叫 SendInput 函式來模擬鍵盤或滑鼠輸入,判斷應用程式是否可以重設 screensaver 的定時器。 如果模擬輸入不會停用 screensaver, 則 uiParam 參數會指定 TRUE ;如果模擬輸入將停用 screensaver,則為 FALSE 。 |
|
設定目前的聯繫人視覺效果設定。
pvParam 參數必須指向識別設定的ULONG變數。 如需詳細資訊,請參閱 聯繫人視覺效果。
注意 如果停用聯繫人視覺效果,就無法啟用手勢視覺效果。
|
|
設定系統殼層和應用程式的預設輸入語言。 指定的語言必須使用目前的系統字元集來顯示。 pvParam 參數必須指向包含預設語言輸入地區設定標識碼的 HKL 變數。 如需詳細資訊,請參閱 語言、地區設定和鍵盤配置。 |
|
將滑鼠的按兩下時間設定為 uiParam 參數的值。 如果 uiParam 值大於 5000 毫秒,系統會將按兩下時間設定為五千毫秒。
按兩下時間是在雙擊的第一次和第二次點選之間可能發生的毫秒數上限。 您也可以呼叫 SetDoubleClickTime 函式來設定按兩下時間。 若要取得目前的按兩下時間,請呼叫 GetDoubleClickTime 函式。 |
|
將雙擊矩形的高度設定為 uiParam 參數的值。
按兩下矩形是一個矩形,按兩下的第二次按兩下必須落在內,才能註冊為按兩下。 若要擷取按兩下矩形的高度,請使用 SM_CYDOUBLECLK旗標呼叫 GetSystemMetrics。 |
|
將雙擊矩形的寬度設定為 uiParam 參數的值。
按兩下矩形是一個矩形,按兩下的第二次按兩下必須落在內,才能註冊為按兩下。 若要擷取按兩下矩形的寬度,請使用 SM_CXDOUBLECLK旗標呼叫 GetSystemMetrics。 |
|
設定目前的手勢視覺效果設定。
pvParam 參數必須指向識別設定的ULONG變數。 如需詳細資訊,請參閱 手勢視覺效果。
注意 如果停用聯繫人視覺效果,就無法啟用手勢視覺效果。
|
|
設定功能表存取鍵字母的底線。 pvParam 參數是BOOL變數。 將 pvParam 設定為 TRUE 以一律加底線功能表訪問鍵,或 FALSE 設定為只有在從鍵盤啟動功能表時,才會加底線功能表訪問鍵。 |
|
設定鍵盤重複延遲設定。 uiParam 參數必須指定 0、1、2 或 3,其中零會設定大約 250 毫秒的最短延遲) ,而 3 則設定最長延遲 (大約 1 秒) 。 與每個值相關聯的實際延遲可能會因硬體而異。 |
|
設定鍵盤喜好設定。 如果使用者依賴鍵盤而非滑鼠,而且希望應用程式顯示隱藏的鍵盤介面, 則 uiParam 參數會指定 TRUE ; 否則 uiParam 為 FALSE 。 |
|
設定鍵盤重複速度設定。 uiParam 參數必須指定介於 0 (大約每秒 2.5 次重複) 到每秒 31 (大約 30 次重複) 的值。 實際的重複率與硬體相依,而且可能會隨線性小數字數而有所不同,最多可達 20%。 如果 uiParam 大於 31,參數會設定為 31。 |
|
設定在輸入語言之間切換的熱鍵集。 不會使用 uiParam 和 pvParam 參數。 值會再次讀取登錄,以設定鍵盤屬性表中的快速鍵。 使用這個旗標之前,必須先設定登錄。 登錄中的路徑 為 HKEY_CURRENT_USER\Keyboard Layout\Toggle. 有效值為 “1” = ALT+SHIFT、“2” = CTRL+SHIFT 和 “3” = none。 |
|
設定兩個滑鼠閾值和滑鼠加速。 pvParam 參數必須指向指定這些值的三個整數數位列。 如需詳細資訊 ,請參閱mouse_event 。 |
|
交換或還原左右滑鼠按鈕的意義。
uiParam 參數會指定 TRUE 來交換按鈕的意義,或指定 FALSE 來還原其原始意義。
若要擷取目前的設定,請使用 SM_SWAPBUTTON 旗標呼叫 GetSystemMetrics。 |
|
設定滑鼠指標必須保留的矩形高度,以像素為單位, 讓 TrackMouseEvent 產生 WM_MOUSEHOVER 訊息。 將 uiParam 參數設定為新的高度。 |
|
設定滑鼠指標必須停留在 TrackMouseEvent 暫留矩形的時間,以毫秒為單位,以產生 WM_MOUSEHOVER 訊息。 只有在呼叫 TrackMouseEvent 時,才會在 dwHoverTime 參數中傳遞HOVER_DEFAULT。 將 uiParam 參數設定為新時間。
指定的時間應該介於 USER_TIMER_MAXIMUM 和 USER_TIMER_MINIMUM 之間。 如果 uiParam 小於 USER_TIMER_MINIMUM,函式會使用 USER_TIMER_MINIMUM。 如果 uiParam 大於 USER_TIMER_MAXIMUM,函式將會 USER_TIMER_MAXIMUM。 Windows Server 2003 和 Windows XP: 在 Windows Server 2003 SP1 和 Windows XP SP2 之前,操作系統不會強制使用 USER_TIMER_MAXIMUM 和 USER_TIMER_MINIMUM 。 |
|
設定滑鼠指標必須保留的矩形寬度,以像素為單位, 讓 TrackMouseEvent 產生 WM_MOUSEHOVER 訊息。 將 uiParam 參數設定為新的寬度。 |
|
設定目前的滑鼠速度。 pvParam 參數是介於 1 (最慢) 和 20 (最快) 之間的整數。 值為10是預設值。 此值通常會使用滑鼠控制面板應用程式來設定。 |
|
啟用或停用滑鼠線索功能,藉由簡短顯示游標的尾端並快速清除游標,來改善滑鼠游標移動的可見度。
若要停用此功能,請將 uiParam 參數設定為零或 1。 若要啟用此功能,請將 uiParam 設定為大於 1 的值,以指出在尾端繪製的數據指標數目。 Windows 2000: 不支援此參數。 |
|
設定滾輪按鈕輸入的路由設定。 路由設定會決定是否將滾輪按鈕輸入傳送至焦點 (前景) 或滑鼠游標下的應用程式。
pvParam 參數必須指向接收路由選項的 DWORD 變數。 如果值為零或MOUSEWHEEL_ROUTING_FOCUS,滑鼠滾輪輸入會傳遞至具有焦點的應用程式。 如果值為 1 或MOUSEWHEEL_ROUTING_HYBRID (默认) ,滑鼠滾輪輸入會傳遞至 (傳統型應用程式) 或滑鼠游標下的應用程式, (Windows 市集應用程式) 。 將 uiParam 參數設定為零。 |
|
設定目前的畫筆手勢視覺效果設定。 pvParam 參數必須指向識別設定的ULONG變數。 如需詳細資訊,請參閱 畫筆視覺效果。 |
|
啟用或停用嵌入式管理單元到預設按鈕功能。 如果啟用,滑鼠游標會自動移至對話框的預設按鈕,例如 [確定 ] 或 [ 套用]。 將 uiParam 參數設定為 TRUE 以啟用此功能,或 將 FALSE 設定為停用此功能。 應用程式在顯示對話框時應該使用 ShowWindow 函式,讓對話框管理員可以放置滑鼠游標。 |
|
從 Windows 8 開始: 開啟或關閉舊版語言列功能。 pvParam 參數是BOOL變數的指標。 將 pvParam 設定為 TRUE 以啟用舊版語言列,或 將它停用 FALSE 。 Windows 8 支援旗標,其中舊版語言列會由輸入切換器取代,因此預設會關閉。 基於相容性考慮而開啟舊版語言列,且不會影響輸入切換器。 |
|
從 Windows 8 開始: 判斷作用中的輸入設定是否有本機 (個別線程、 TRUE) 或全域 (會話、 FALSE) 範圍。 pvParam 參數必須是由 PVOID 轉換的 BOOL 變數。 |
|
從 Windows 11 版本 24H2 開始: 設定精確度觸控板的詳細數據,包括與觸控板相關的使用者設定和系統資訊。
pvParam 參數必須指向TOUCHPAD_PARAMETERS結構。 uiParam 參數必須指定 結構的大小。 TOUCHPAD_PARAMETERS 結構中 versionNumber 欄位的值必須設定為所使用結構版本的適當值。 |
|
設定移動水平滑鼠滾輪時要捲動的字元數。 從 uiParam 參數設定字元數。 |
|
設定移動垂直滑鼠滾輪時要捲動的行數。 從 uiParam 參數設定行數。
行數是滾動滑鼠滾輪而不使用修飾詞鍵時,要捲動的建議行數。 如果數位為 0,則不應該發生任何捲動。 如果卷動的行數大於可檢視的行數,特別是當 WHEEL_PAGESCROLL (#defined 為 UINT_MAX) 時,卷動作業應該解譯為在滾動條頁面向下或頁面向上區域中單擊一次。 |
以下是功能表參數。
功能表參數 | 意義 |
---|---|
|
判斷快顯功能表是靠左對齊還是靠右對齊,相對於對應的功能表欄專案。 pvParam 參數必須指向在靠右對齊時接收 TRUE 的 BOOL 變數,否則為 FALSE。 |
|
判斷是否啟用功能表淡出動畫。 pvParam 參數必須指向BOOL變數,該變數會在啟用淡出動畫時接收TRUE,並在停用時收到FALSE。 如果停用淡出動畫,功能表會使用投影片動畫。 除非已啟用功能表動畫,否則會忽略此旗標,您可以使用 SPI_SETMENUANIMATION 旗標來執行此動作。 如需詳細資訊,請參閱 AnimateWindow。 |
|
擷取當滑鼠游標位於子功能表專案上方時,系統會在顯示快捷方式功能表之前等待的時間。 pvParam 參數必須指向接收延遲時間的 DWORD 變數。 |
|
設定快捷功能表的對齊值。 uiParam 參數會針對右對齊指定 TRUE,或為左對齊指定 FALSE。 |
|
啟用或停用功能表淡出動畫。 將 pvParam 設定為 TRUE ,讓功能表淡出效果或 FALSE 停用它。 如果停用淡出動畫,功能表會使用投影片動畫。 只有在系統具有超過 256 種色彩的色彩深度時,才會有功能表淡出效果。 除非也設定 SPI_MENUANIMATION ,否則會忽略此旗標。 如需詳細資訊,請參閱 AnimateWindow。 |
|
將 uiParam 設定為時間,以毫秒為單位,當滑鼠游標位於子功能表專案上方時,系統會在顯示快捷方式功能表之前等候。 |
以下是電源參數。
從 Windows Server 2008 和 Windows Vista 開始,不支援這些電源參數。 相反地,若要判斷目前的顯示電源狀態,應用程式應該註冊 GUID_MONITOR_POWER_STATE 通知。 若要判斷目前的顯示器電源關閉逾時,應用程式應該註冊通知 GUID_VIDEO_POWERDOWN_TIMEOUT 電源設定的變更。 如需詳細資訊,請參閱 註冊 Power Events。
Windows Server 2003 和 Windows XP/2000: 若要判斷目前的顯示電源狀態,請使用下列電源參數。
以下是螢幕保護參數。
以下是應用程式和服務的逾時參數。
以下是UI效果。 SPI_SETUIEFFECTS值可用來一次啟用或停用所有UI效果。 下表包含UI效果值的完整清單。
UI 效果參數 | 意義 |
---|---|
|
判斷是否啟用下拉式方塊的投影片開啟效果。 pvParam 參數必須指向BOOL變數,該變數會收到已啟用的TRUE,或停用的FALSE。 |
|
判斷游標周圍是否有陰影。 pvParam 參數必須指向BOOL變數,如果已啟用陰影,則為 FALSE。 只有當系統色彩深度超過 256 種色彩時,才會顯示此效果。 |
|
判斷是否啟用視窗標題列的漸層效果。 pvParam 參數必須指向BOOL變數,該變數會收到已啟用的TRUE,或停用的FALSE。 如需漸層效果的詳細資訊,請參閱 GetSysColor 函 式。 |
|
判斷是否啟用使用者介面元素的熱追蹤,例如功能表欄上的功能表名稱。
pvParam 參數必須指向BOOL變數,該變數會收到已啟用的TRUE,或停用的FALSE。
熱追蹤表示當游標移至專案上方時,會反白顯示,但未選取。 您可以查詢此值,以決定是否要在應用程式的使用者介面中使用熱追蹤。 |
|
判斷是否啟用清單框的平滑捲動效果。 pvParam 參數必須指向BOOL變數,該變數會收到已啟用的TRUE,或停用的FALSE。 |
|
判斷功能表動畫功能是否已啟用。 這個主要參數必須開啟,才能啟用功能表動畫效果。
pvParam 參數必須指向BOOL變數,如果已啟用動畫,則會接收TRUE,如果停用則為FALSE。
如果啟用動畫, SPI_GETMENUFADE 會指出功能表是否使用淡化或投影片動畫。 |
|
與 SPI_GETKEYBOARDCUES相同。 |
|
判斷是否啟用選取範圍淡化效果。
pvParam 參數必須指向BOOL變數,如果已啟用則為TRUE,如果停用則為 FALSE。
選取淡出效果會導致用戶選取的功能表項在關閉功能表後短暫停留在螢幕上。 |
|
判斷工具提示動畫是否已啟用。 pvParam 參數必須指向BOOL變數,如果已啟用則為TRUE,如果停用則為 FALSE。 如果已啟用 ToolTip 動畫, SPI_GETTOOLTIPFADE 指出工具提示是否使用淡出或投影片動畫。 |
|
如果啟用SPI_SETTOOLTIPANIMATION,SPI_GETTOOLTIPFADE會指出工具提示動畫使用淡出效果或投影片效果。 pvParam 參數必須指向BOOL變數,以接收淡出動畫的TRUE或投影片動畫的 FALSE。 如需投影片和淡化效果的詳細資訊,請參閱 AnimateWindow。 |
|
判斷UI效果是啟用還是停用。 pvParam 參數必須指向 BOOL 變數,如果已啟用所有 UI 效果,則為 TRUE,如果停用則為 FALSE。 |
|
啟用或停用下拉式方塊的投影片開啟效果。 將 pvParam 參數設定為 TRUE 以啟用漸層效果,或將 FALSE 設為停用。 |
|
啟用或停用游標周圍的陰影。 pvParam 參數是BOOL變數。 將 pvParam 設定為 TRUE ,讓陰影或 FALSE 停用陰影。 只有當系統色彩深度超過 256 種色彩時,才會顯示此效果。 |
|
啟用或停用視窗標題列的漸層效果。 將 pvParam 參數設定為 TRUE 以啟用它,或 將 FALSE 設定為停用它。 只有當系統的色彩深度超過 256 種色彩時,才能使用漸層效果。 如需漸層效果的詳細資訊,請參閱 GetSysColor 函 式。 |
|
啟用或停用使用者介面元素的熱追蹤,例如功能表欄上的功能表名稱。 將 pvParam 參數設定為 TRUE 以啟用它,或 將 FALSE 設定為停用它。
熱追蹤表示當游標移至專案上方時,它會反白顯示,但未選取。 |
|
啟用或停用清單框的平滑捲動效果。 將 pvParam 參數設定為 TRUE ,以啟用平滑捲動效果,或 將 FALSE 停用。 |
|
啟用或停用功能表動畫。 此主圖形參數必須開啟,才能發生任何功能表動畫。
pvParam 參數是 BOOL 變數;將 pvParam 設定為 TRUE 以啟用動畫,並將 FALSE 設定為停用動畫。
如果啟用動畫, SPI_GETMENUFADE 會指出功能表是否使用淡化或投影片動畫。 |
|
與 SPI_SETKEYBOARDCUES相同。 |
|
將 pvParam 設定為 TRUE ,以啟用選取淡出效果或 FALSE 加以停用。
選取淡出效果會導致用戶選取的功能表項在關閉功能表後短暫停留在螢幕上。 只有在系統色彩深度超過 256 種色彩時,才能使用選取淡出效果。 |
|
將 pvParam 設定為 TRUE 以啟用 ToolTip 動畫或 FALSE 加以停用。 如果啟用,您可以使用 SPI_SETTOOLTIPFADE 來指定淡出或投影片動畫。 |
|
如果已啟用 SPI_SETTOOLTIPANIMATION 旗標,請使用 SPI_SETTOOLTIPFADE 來指出ToolTip動畫是否使用淡入效果或投影片效果。 將 pvParam 設定為 TRUE 表示淡出動畫,或將投影片動畫設定為 FALSE 。 只有在系統具有超過 256 種色彩的色彩深度時,工具提示淡出效果才可行。 如需投影片和淡出效果的詳細資訊,請參閱 AnimateWindow 函式。 |
|
啟用或停用UI效果。 將 pvParam 參數設定為 TRUE ,讓所有 UI 效果或 FALSE 停用所有 UI 效果。 |
以下是窗口參數。
Window 參數 | 意義 |
---|---|
|
判斷使用中窗口追蹤 (啟用滑鼠開啟的視窗,) 開啟或關閉。 pvParam 參數必須指向接收 TRUE 的 BOOL 變數,或針對 off 接收 TRUE 的 FALSE。 |
|
判斷是否將透過作用中視窗追蹤啟動的視窗帶至頂端。 pvParam 參數必須指向接收 TRUE 的 BOOL 變數,或針對 off 接收 TRUE 的 FALSE。 |
|
擷取作用中窗口追蹤延遲,以毫秒為單位。 pvParam 參數必須指向接收時間的 DWORD 變數。 |
|
擷取與用戶動作相關聯的動畫效果。
pvParam 參數必須指向接收資訊的 ANIMATIONINFO 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(ANIMATIONINFO) 。
|
|
擷取框線乘數因數,決定視窗大小框線的寬度。 pvParam 參數必須指向接收此值的整數變數。 |
|
擷取編輯控件中的插入號寬度,以像素為單位。 pvParam 參數必須指向接收此值的 DWORD 變數。 |
|
判斷當視窗移至監視器或監視器陣列的上邊緣、左邊緣或右邊緣時,視窗是否停駐。
pvParam 參數必須指向在啟用時接收 TRUE 的 BOOL 變數,否則為 FALSE。
使用 SPI_GETWINARRANGING 來判斷是否啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
判斷是否在拖曳標題列時還原最大化視窗。
pvParam 參數必須指向在啟用時接收 TRUE 的 BOOL 變數,否則為 FALSE。
使用 SPI_GETWINARRANGING 來判斷是否啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
判斷是否已啟用完整視窗的拖曳。 pvParam 參數必須指向在啟用時接收 TRUE 的 BOOL 變數,否則為 FALSE。 |
|
擷取 SetForegroundWindow 在拒絕前景切換要求時會閃爍任務欄按鈕的次數。 pvParam 參數必須指向接收值的 DWORD 變數。 |
|
擷取使用者輸入之後的時間量,以毫秒為單位,在此期間,系統不允許應用程式強制自己進入前景。 pvParam 參數必須指向接收時間的 DWORD 變數。 |
|
擷取與最小化窗口相關聯的計量。
pvParam 參數必須指向接收資訊的 MINIMIZEDMETRICS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(MINIMIZEDMETRICS) 。
|
|
擷取以像素為單位的臨界值,其中停駐行為是使用滑鼠將視窗拖曳到監視器或監視器陣列的邊緣。 默認閾值為1。
pvParam 參數必須指向接收值的 DWORD 變數。
使用 SPI_GETWINARRANGING 來判斷是否啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
擷取以像素為單位的臨界值,其中使用滑鼠將視窗從監視器邊緣或監視器陣列拖曳到中央。 默認閾值為20。
使用 SPI_GETWINARRANGING 來判斷是否啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
從監視器頂端擷取以圖元為單位的臨界值,或是使用滑鼠拖曳時還原垂直最大化視窗的監視器數位。 默認閾值為 50。
使用 SPI_GETWINARRANGING 來判斷是否啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
擷取與非最小化視窗之非工作區相關聯的度量。
pvParam 參數必須指向接收資訊的 NONCLIENTMETRICS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(NONCLIENTMETRICS) 。
Windows Server 2003 和 Windows XP/2000: 請參閱 NONCLIENTMETRICS 的。 |
|
擷取以像素為單位的臨界值,其中停駐行為是使用手寫筆將視窗拖曳到監視器或監視器數位的邊緣。 預設值是 30。
使用 SPI_GETWINARRANGING 來判斷是否啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
擷取以像素為單位的臨界值,其中使用手寫筆將窗口從監視器或監視器陣列的邊緣拖曳至其中心。 默認閾值為30。
使用 SPI_GETWINARRANGING 來判斷是否啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
從監視或監視器陣列頂端擷取以像素為單位的臨界值,其中使用滑鼠拖曳時會還原垂直最大化視窗。 默認閾值為 50。
使用 SPI_GETWINARRANGING 來判斷是否啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
判斷每一使用者) 是否顯示 IME 狀態視窗 (。 pvParam 參數必須指向BOOL變數,如果狀態視窗為可見,則為TRUE,否則為 FALSE。 |
|
判斷當視窗的大小調整為監視器或監視器陣列的頂端或底部時,視窗是否垂直最大化。
pvParam 參數必須指向在啟用時接收 TRUE 的 BOOL 變數,否則為 FALSE。
使用 SPI_GETWINARRANGING 來判斷是否啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
判斷是否啟用窗口排列。
pvParam 參數必須指向在啟用時接收 TRUE 的 BOOL 變數,否則為 FALSE。
視窗排列可簡化拖曳或重設大小視窗的預設行為,以減少移動和調整最上層視窗所需的滑鼠、手寫筆或觸控互動數目。 下列參數會擷取個別視窗排列設定:
|
|
設定作用中視窗追蹤 (啟用滑鼠開啟的視窗,) 開啟或關閉。 針對 on 或 FALSE,將 pvParam 設定為 TRUE。 |
|
判斷是否應該將透過作用中視窗追蹤啟用的視窗帶入頂端。 針對 on 或 FALSE,將 pvParam 設定為 TRUE。 |
|
設定使用中視窗追蹤延遲。 將 pvParam 設定為在啟用滑鼠指標下視窗之前延遲的毫秒數。 |
|
設定與用戶動作相關聯的動畫效果。
pvParam 參數必須指向包含新參數的 ANIMATIONINFO 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(ANIMATIONINFO) 。
|
|
設定框線乘數因數,決定視窗大小框線的寬度。 uiParam 參數會指定新的值。 |
|
在編輯控制件中設定插入號寬度。 將 pvParam 設定為所需的寬度,以像素為單位。 預設值和最小值為1。 |
|
設定當視窗移至監視器或監視器陣列上的上、左或右停駐目標時,視窗是否停駐。 針對 on 或 FALSE,將 pvParam 設定為 TRUE。
SPI_GETWINARRANGING 必須是 TRUE ,才能啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
設定是否在拖曳標題列時還原最大化視窗。 針對 on 或 FALSE,將 pvParam 設定為 TRUE。
SPI_GETWINARRANGING 必須是 TRUE ,才能啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
設定開啟或關閉完整視窗的拖曳。 uiParam 參數會針對 on 指定 TRUE,或為 off 指定 FALSE。 |
|
設定用來偵測拖曳作業開始之矩形的高度,以像素為單位。 將 uiParam 設定為新的值。 若要擷取拖曳高度,請使用 SM_CYDRAG 旗標呼叫 GetSystemMetrics。 |
|
設定用來偵測拖曳作業開始之矩形的寬度,以像素為單位。 將 uiParam 設定為新的值。 若要擷取拖曳寬度,請使用 SM_CXDRAG 旗標呼叫 GetSystemMetrics。 |
|
設定 SetForegroundWindow 在拒絕前景切換要求時會閃爍任務欄按鈕的次數。 將 pvParam 設定為快閃的次數。 |
|
設定在使用者輸入之後的時間量,以毫秒為單位,在此期間,系統不允許應用程式強制自己進入前景。 將 pvParam 設定為新的逾時值。
呼叫線程必須能夠變更前景視窗,否則呼叫會失敗。 |
|
設定與最小化視窗相關聯的計量。
pvParam 參數必須指向包含新參數的MINIMIZEDMETRICS結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(MINIMIZEDMETRICS) 。
|
|
使用滑鼠將視窗拖曳到監視或監視器陣列邊緣,以像素為單位設定停駐行為觸發的臨界值。 默認閾值為1。
pvParam 參數必須指向包含新值的 DWORD 變數。
SPI_GETWINARRANGING 必須是 TRUE ,才能啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
使用滑鼠將視窗從監視器或監視器陣列的邊緣拖曳至其中心,以像素為單位設定未模擬行為的臨界值。 默認閾值為20。
pvParam 參數必須指向包含新值的 DWORD 變數。
SPI_GETWINARRANGING 必須是 TRUE ,才能啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
使用滑鼠拖曳時,設定監視器頂端的像素臨界值,其中垂直最大化視窗會還原。 默認閾值為 50。
pvParam 參數必須指向包含新值的 DWORD 變數。
SPI_GETWINARRANGING 必須是 TRUE ,才能啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
設定與非最小化視窗的非客戶端區域相關聯的計量。
pvParam 參數必須指向包含新參數的 NONCLIENTMETRICS 結構。 將這個 結構的 cbSize 成員與 uiParam 參數設定為 sizeof(NONCLIENTMETRICS) 。 此外,LOGFONT 結構的 lfHeight 成員必須是負值。
|
|
使用手寫筆將視窗拖曳到監視或監視器陣列的邊緣,以像素為單位設定停駐行為觸發的臨界值。 默認閾值為30。
pvParam 參數必須指向包含新值的 DWORD 變數。
SPI_GETWINARRANGING 必須是 TRUE ,才能啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
以像素為單位設定臨界值,其中使用手寫筆將視窗從監視器或監視器陣列的邊緣拖曳至其中心來觸發取消模擬行為。 默認閾值為30。
pvParam 參數必須指向包含新值的 DWORD 變數。
SPI_GETWINARRANGING 必須是 TRUE ,才能啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
使用手寫筆拖曳時,設定監視器頂端的像素臨界值,其中垂直最大化視窗會還原。 默認閾值為 50。
pvParam 參數必須指向包含新值的 DWORD 變數。
SPI_GETWINARRANGING 必須是 TRUE ,才能啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
設定是否以每個用戶為基礎顯示 IME 狀態視窗。 uiParam 參數會針對 off 指定 on 或 FALSE 的 TRUE。 |
|
設定視窗在調整為監視器頂端或底部的大小時,視窗是否垂直最大化。 針對 on 或 FALSE,將 pvParam 設定為 TRUE。
SPI_GETWINARRANGING 必須是 TRUE ,才能啟用此行為。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP/2000: 不支援此參數。 |
|
設定是否啟用窗口排列。 針對 on 或 FALSE,將 pvParam 設定為 TRUE。
視窗排列可簡化拖曳或重設大小視窗的預設行為,以減少移動和調整最上層視窗所需的滑鼠、手寫筆或觸控互動數目。 下列參數會設定個別視窗排列設定:
|
[in] uiParam
類型: UINT
使用方式和格式取決於查詢或設定的系統參數。 如需全系統參數的詳細資訊,請參閱 uiAction 參數。 如果未另有指示,您必須為此參數指定零。
[in, out] pvParam
類型: PVOID
使用方式和格式取決於查詢或設定的系統參數。 如需全系統參數的詳細資訊,請參閱 uiAction 參數。 如果未指定,您必須為此參數指定 NULL 。 如需 PVOID 資料類型的詳細資訊,請參閱 Windows 資料類型。
[in] fWinIni
類型: UINT
如果設定了系統參數,會指定是否要更新使用者配置檔,如果是,則是否要將 WM_SETTINGCHANGE 訊息廣播到所有最上層視窗,以通知他們變更。
如果您不想更新使用者配置檔或廣播 WM_SETTINGCHANGE 訊息,或者它可以是下列一或多個值,此參數可以是零。
值 | 意義 |
---|---|
|
將新的全系統參數設定寫入使用者配置檔。 |
|
更新使用者配置檔之後 ,廣播WM_SETTINGCHANGE 訊息。 |
|
與 SPIF_SENDCHANGE相同。 |
傳回值
類型: BOOL
如果函式成功,則傳回值是非零值。
如果此函式失敗,則傳回值為零。 若要取得擴充的錯誤資訊,請呼叫 GetLastError。
備註
此函式適用於可讓使用者自定義環境的應用程式。
鍵盤配置名稱應該衍生自對應至配置之語言標識碼的十六進位值。 例如,美國英文的語言標識碼為 0x0409,因此主要美式英文版面配置的名稱為 「00000409」。 美式英文版面配置的變化,例如 Dvorak 版面配置,命名為 “00010409”、“00020409” 等等。 如需組成語言標識碼的主要語言標識碼和子語言標識符清單,請參閱 MAKELANGID 宏。
高對比度色彩配置與高對比度模式之間有差異。 高對比度色彩配置會將系統色彩變更為具有明顯對比的色彩;您可以使用控制面板中的 [顯示選項] 切換至此色彩設定。 使用 SPI_GETHIGHCONTRAST 和 SPI_SETHIGHCONTRAST的高對比度模式會建議應用程式修改其外觀,以供視覺受損的使用者使用。 它牽涉到使用控制面板) 中的輔助功能選項 (使用者和自訂色彩配置等專案。 如需詳細資訊,請參閱 HIGHCONTRAST。 如需一般輔助功能功能的詳細資訊,請參閱 輔助功能。
在按住主要按鈕以啟動 Mouse ClickLock 功能期間,用戶可以移動滑鼠。 鎖定主要按鈕之後,釋放主要按鈕並不會產生 WM_LBUTTONUP 訊息。 因此,它會出現在主要按鈕仍在關閉的應用程式。 任何後續的按鈕訊息都會釋放主要按鈕,將 WM_LBUTTONUP 訊息傳送至應用程式,因此可以透過程式設計方式或透過使用者按兩下任何按鈕來解除鎖定按鈕。
此 API 無法感知 DPI,如果呼叫線程是個別監視器 DPI 感知,則不應該使用。 如需此 API 的 DPI 感知版本,請參閱 SystemParametersInfoForDPI。 如需 DPI 感知的詳細資訊,請參閱 Windows High DPI 檔。
範例
下列範例使用 SystemParametersInfo 將滑鼠速度加倍。
#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
}
}
注意
winuser.h 標頭會將 SystemParametersInfo 定義為別名,根據 UNICODE 預處理器常數的定義,自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼,可能會導致編譯或運行時間錯誤不符。 如需詳細資訊,請參閱 函式原型的慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | winuser.h (包含 Windows.h) |
程式庫 | User32.lib |
Dll | User32.dll |
API 集合 | ext-ms-win-ntuser-sysparams-ext-l1-1-0 (Windows 8) |