Функция SystemParametersInfoW (winuser.h)
Важно!
Некоторые сведения относятся к предварительной версии продукта, который может быть существенно изменен до его коммерческого выпуска. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Извлекает или задает значение одного из параметров всей системы. Эта функция также может обновлять профиль пользователя при настройке параметра.
Синтаксис
BOOL SystemParametersInfoW(
[in] UINT uiAction,
[in] UINT uiParam,
[in, out] PVOID pvParam,
[in] UINT fWinIni
);
Параметры
[in] uiAction
Тип: UINT
Системный параметр, который требуется извлечь или задать. Возможные значения упорядочены в следующих таблицах связанных параметров:
- Параметры специальных возможностей
- Параметры рабочего стола
- Параметры значка
- Входные параметры
- Параметры меню
- Параметры питания
- Параметры заставки
- Параметры времени ожидания
- Параметры эффекта пользовательского интерфейса
- Параметры окна
Ниже приведены параметры специальных возможностей.
| Параметр специальных возможностей | Значение |
|---|---|
|
Извлекает сведения о периоде ожидания, связанном с функциями специальных возможностей. Параметр 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 в противном случае.
Такие функции отображения, как фоновые изображения, текстурированный фон, водяные знаки на документах, альфа-смешивание и прозрачность, могут уменьшить контрастность переднего плана и фона, что усложняет пользователям со слабым зрением видеть объекты на экране. Этот флаг позволяет определить, было ли отключено такое перекрывающееся содержимое. 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 , чтобы получить предпочтительный коэффициент масштабирования. Классические приложения должны использовать логическое разрешение на рабочий стол, а не коэффициент масштабирования. Логическое разрешение на рабочий стол можно получить с помощью функции GetDeviceCaps .
|
|
Извлекает время отображения всплывающих окон уведомлений в секундах. Параметр pvParam должен указывать на ULONG , получающий длительность сообщения.
Пользователям с нарушениями зрения или когнитивными заболеваниями, такими как СДВГ и дислексия, может потребоваться больше времени, чтобы прочитать текст в уведомлениях. Этот флаг позволяет получить длительность сообщения. Windows Server 2003 и Windows XP/2000: Этот параметр не поддерживается. |
|
Возвращает состояние компонента Mouse ClickLock. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если включено, или FALSE в противном случае. Дополнительные сведения см. в разделе Общие сведения о вводе мыши.
Windows 2000: Этот параметр не поддерживается. |
|
Извлекает временную задержку до блокировки основной кнопки мыши. Параметр pvParam должен указывать на DWORD , получающий задержку времени в миллисекундах. Эта функция включена, только если SPI_SETMOUSECLICKLOCK имеет значение TRUE. Дополнительные сведения см. в разделе Общие сведения о вводе мыши.
Windows 2000: Этот параметр не поддерживается. |
|
Извлекает сведения о функции специальных возможностей MouseKeys. Параметр pvParam должен указывать на структуру MOUSEKEYS , которая получает сведения. Присвойте элементу cbSize этой структуры и параметру uiParam значение sizeof(MOUSEKEYS).
|
|
Извлекает состояние компонента Sonar мыши. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если включено, или FALSE в противном случае. Дополнительные сведения см. в разделе Общие сведения о вводе мыши.
Windows 2000: Этот параметр не поддерживается. |
|
Извлекает состояние компонента Mouse Vanish. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если включено, или FALSE в противном случае. Дополнительные сведения см. в разделе Общие сведения о вводе мыши.
Windows 2000: Этот параметр не поддерживается. |
|
Определяет, запущена ли служебная программа проверки экрана. Служебная программа проверки экрана направляет текстовую информацию на устройство вывода, например синтезатор речи или брайлевский дисплей. Если этот флаг установлен, приложение должно предоставлять текстовые сведения в ситуациях, когда в противном случае они будут представлены графически.
Параметр pvParam является указателем на переменную BOOL , которая получает значение TRUE , если запущена программа проверки экрана, или FALSE в противном случае.
Примечание Экранный диктор, средство чтения с экрана, входящее в состав Windows, не устанавливает флаги SPI_SETSCREENREADER или SPI_GETSCREENREADER .
|
|
Этот параметр не поддерживается.
Windows Server 2003 и Windows XP/2000: Пользователь должен управлять этим параметром с помощью панели управления. |
|
Определяет, включен или отключен флаг специальных возможностей Показать звуки. Если она включена, пользователю требуется, чтобы приложение визуализировать информацию в ситуациях, когда в противном случае она будет представлять информацию только в звуковой форме. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если функция включена, или FALSE , если она отключена.
Использование этого значения эквивалентно вызову GetSystemMetrics с SM_SHOWSOUNDS. Это рекомендуемый вызов. |
|
Извлекает сведения о функции специальных возможностей 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 , чтобы включить перекрывающееся содержимое.
Такие функции, как фоновые изображения, текстурированные фоны, водяные знаки в документах, альфа-смешение и прозрачность, могут уменьшить контрастность переднего плана и фона, что усложняет пользователям со слабым зрением видеть объекты на экране. Этот флаг позволяет включать или отключать все такое перекрывающееся содержимое. 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 указывает длительность сообщения.
Пользователям с нарушениями зрения или когнитивными заболеваниями, такими как СДВГ и дислексия, может потребоваться больше времени для чтения текста в уведомлениях. Этот флаг позволяет задать длительность сообщения. Windows Server 2003 и Windows XP/2000: Этот параметр не поддерживается. |
|
Включает или отключает функцию специальных возможностей Mouse ClickLock. Эта функция временно блокирует основную кнопку мыши, когда она нажата и удерживается на время, указанное SPI_SETMOUSECLICKLOCKTIME. Параметр pvParam задает значение TRUE для параметра on или FALSE для параметра off. Значение по умолчанию — off. Дополнительные сведения см. в разделах Примечания и Входные данные AboutMouse.
Windows 2000: Этот параметр не поддерживается. |
|
Корректирует временную задержку до блокировки основной кнопки мыши. Параметр uiParam должен иметь значение 0. Параметр pvParam указывает на DWORD , указывающий временную задержку в миллисекундах. Например, укажите 1000 для задержки в 1 секунду. Значение по умолчанию — 1200. Дополнительные сведения см. в разделе Общие сведения о вводе мыши.
Windows 2000: Этот параметр не поддерживается. |
|
Задает параметры функции специальных возможностей MouseKeys. Параметр pvParam должен указывать на структуру MOUSEKEYS , содержащую новые параметры. Присвойте элементу cbSize этой структуры и параметру uiParam значение sizeof(MOUSEKEYS).
|
|
Включает или отключает функцию специальных возможностей Sonar. Эта функция кратко показывает несколько концентрических кругов вокруг указателя мыши, когда пользователь нажимает и отпускает клавишу CTRL. Параметр pvParam задает значение TRUE для параметра on и FALSE для параметра off. Значение по умолчанию — off. Дополнительные сведения см. в разделе Общие сведения о вводе мыши.
Windows 2000: Этот параметр не поддерживается. |
|
Включает или отключает функцию "Исчезать". Эта функция скрывает указатель мыши при вводе пользователем; указатель снова появляется, когда пользователь перемещает мышь. Параметр pvParam задает значение TRUE для параметра on и FALSE для параметра off. Значение по умолчанию — off. Дополнительные сведения см. в разделе Общие сведения о вводе мыши.
Windows 2000: Этот параметр не поддерживается. |
|
Определяет, запущена ли служебная программа проверки экрана. Параметр uiParam задает значение TRUE для параметра on или FALSE для параметра off.
Примечание Экранный диктор, средство чтения с экрана, входящее в состав Windows, не устанавливает флаги SPI_SETSCREENREADER или SPI_GETSCREENREADER .
|
|
Этот параметр не поддерживается.
Windows Server 2003 и Windows XP/2000: Пользователь должен управлять этим параметром с помощью панели управления. |
|
Включает или отключает функцию специальных возможностей ShowSounds. Параметр uiParam задает значение TRUE для параметра on или FALSE для параметра off. |
|
Задает параметры функции специальных возможностей SoundSentry . Параметр pvParam должен указывать на структуру SOUNDSENTRY , содержащую новые параметры. Присвойте элементу cbSize этой структуры и параметру uiParam значение sizeof(SOUNDSENTRY).
|
|
Задает параметры функции специальных возможностей StickyKeys. Параметр pvParam должен указывать на структуру STICKYKEYS , содержащую новые параметры. Присвойте элементу cbSize этой структуры и параметру uiParam значение sizeof(STICKYKEYS).
|
|
Задает параметры функции специальных возможностей ToggleKeys. Параметр pvParam должен указывать на структуру TOGGLEKEYS , содержащую новые параметры. Присвойте элементу cbSize этой структуры и параметру uiParam значение sizeof(TOGGLEKEYS).
|
Ниже приведены параметры рабочего стола.
| Параметр Desktop | Значение |
|---|---|
|
Определяет, включен ли ClearType. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если clearType включен, или FALSE в противном случае.
ClearType — это программная технология, которая улучшает удобочитаемость текста на жидкокристаллических дисплеях (ЖК-мониторах). 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 , которая получает значение TRUE , если функция включена, или FALSE , если она не включена. |
|
Извлекает значение контрастности, используемое в сглаживание ClearType . Параметр pvParam должен указывать на UINT , который получает сведения. Допустимые значения контрастности — от 1000 до 2200. Значение по умолчанию — 1400.
Windows 2000: Этот параметр не поддерживается. |
|
Получает ориентацию сглаживания шрифта. Параметр pvParam должен указывать на UINT , который получает сведения. Возможные значения : FE_FONTSMOOTHINGORIENTATIONBGR (сине-зеленый-красный) и FE_FONTSMOOTHINGORIENTATIONRGB (красный-зеленый-синий).
Windows XP/2000: Этот параметр не поддерживается до windows XP с пакетом обновления 2 (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. |
|
Задает текущий шаблон рабочего стола, заставляя Windows считывать параметр Pattern= из файла WIN.INI. |
|
Примечание Если используется флаг 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 с пакетом обновления 2 (SP2). |
|
Задает тип сглаживания шрифта. Параметр pvParam либо FE_FONTSMOOTHINGSTANDARD, если используется стандартное сглаживание, либо FE_FONTSMOOTHINGCLEARTYPE, если используется ClearType . Значение по умолчанию — FE_FONTSMOOTHINGSTANDARD.
также необходимо задать SPI_SETFONTSMOOTHING. Windows 2000: Этот параметр не поддерживается. |
|
Задает размер рабочей области. Рабочая область — это часть экрана, не скрытая системной панелью задач или панелью инструментов рабочего стола приложения. Параметр pvParam — это указатель на структуру RECT , которая задает новый прямоугольник рабочей области, выраженный в координатах виртуального экрана. В системе с несколькими мониторами отображения функция задает рабочую область монитора, содержащего указанный прямоугольник. |
Ниже приведены параметры значка.
| Параметр Icon | Значение |
|---|---|
|
Извлекает метрики, связанные со значками. Параметр pvParam должен указывать на структуру ICONMETRICS , которая получает информацию. Присвойте элементу cbSize этой структуры и параметру uiParam значение sizeof(ICONMETRICS).
|
|
Извлекает сведения о логическом шрифте для текущего шрифта заголовка значка. Параметр uiParam указывает размер структуры LOGFONT , а параметр pvParam должен указывать на структуру LOGFONT для заполнения. |
|
Определяет, включена ли оболочка заголовка значков. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если включено, или 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 задает значение TRUE для параметра on или FALSE для параметра off. |
Ниже приведены входные параметры. Они включают параметры, связанные с клавиатурой, мышью, пером, языком ввода и предупреждением beeper.
| Входной параметр | Значение |
|---|---|
|
Определяет, включена ли оповещение.
Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если beeper включен, или FALSE , если он отключен. |
|
Извлекает bool , указывающий, может ли приложение сбросить таймер экранной заставки, вызывая функцию SendInput для имитации ввода с помощью клавиатуры или мыши. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если имитация входных данных будет заблокирована, или false в противном случае. |
|
Извлекает текущий параметр визуализации контакта. Параметр pvParam должен указывать на переменную ULONG , которая получает параметр . Дополнительные сведения см. в разделе Визуализация контактов. |
|
Извлекает идентификатор входного языкового стандарта для системного языка ввода по умолчанию. Параметр pvParam должен указывать на переменную HKL , которая получает это значение. Дополнительные сведения см. в разделе Языки, языковые параметры и раскладки клавиатуры. |
|
Извлекает текущий параметр визуализации жестов. Параметр pvParam должен указывать на переменную ULONG , которая получает параметр . Дополнительные сведения см. в разделе Визуализация жестов. |
|
Определяет, всегда ли подчеркиваются клавиши доступа к меню. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если клавиши доступа к меню всегда подчеркнуты, и 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 , которая получает значение TRUE , если функция включена, или FALSE , если она отключена. |
|
Начиная с Windows 8: Определяет, включена или отключена системная языковая панель. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если языковая панель включена, или false в противном случае. |
|
Начиная с Windows 8: Определяет, имеют ли активные входные параметры локальную (для потока, TRUE) или глобальную (сеанс, FALSE) область. Параметр pvParam должен указывать на переменную BOOL . |
|
Начиная с Windows 11 версии 24H2: Извлекает сведения о сенсорной панели Precision, включая параметры пользователя и системные сведения, связанные с сенсорной панелью.
Параметр pvParam должен указывать на TOUCHPAD_PARAMETERS структуру. Параметр uiParam должен указывать размер структуры. Значение поля versionNumber в структуре TOUCHPAD_PARAMETERS должно иметь соответствующее значение для используемой версии структуры. |
|
Извлекает количество символов для прокрутки при перемещении горизонтального колесика мыши. Параметр pvParam должен указывать на переменную UINT , которая получает количество строк. Значение по умолчанию равно 3. |
|
Извлекает количество строк для прокрутки при перемещении вертикального колесика мыши. Параметр pvParam должен указывать на переменную UINT , которая получает количество строк. Значение по умолчанию равно 3. |
|
Включает или отключает оповещение. Параметр uiParam задает значение TRUE для параметра on или FALSE для параметра off. |
|
Определяет, может ли приложение сбросить таймер заставки, вызвав функцию SendInput для имитации ввода с клавиатуры или мыши. Параметр uiParam задает значение TRUE , если экранная заставка не будет деактивирована с помощью имитированных входных данных, или false , если экранная заставка будет отключена с помощью имитации входных данных. |
|
Задает текущий параметр визуализации контакта. Параметр pvParam должен указывать на переменную ULONG , которая идентифицирует параметр. Дополнительные сведения см. в разделе Визуализация контактов.
Примечание Если визуализации контактов отключены, визуализации жестов нельзя включить.
|
|
Задает язык ввода по умолчанию для системной оболочки и приложений. Указанный язык должен отображаться с использованием текущей системной кодировки. Параметр pvParam должен указывать на переменную HKL , содержащую идентификатор входного языкового стандарта для языка по умолчанию. Дополнительные сведения см. в разделе Языки, языковые стандарты и раскладки клавиатуры. |
|
Задает для параметра uiParam время двойного щелчка мыши. Если значение uiParam больше 5000 миллисекунда, система устанавливает время двойного щелчка равным 5000 миллисекундам.
Время двойного щелчка — это максимальное количество миллисекунд, которое может произойти между первым и вторым щелчком двойного щелчка. Можно также вызвать функцию SetDoubleClickTime , чтобы задать время двойного щелчка. Чтобы получить текущее время двойного щелчка, вызовите функцию GetDoubleClickTime . |
|
Задает высоту прямоугольника двойного щелчка значением параметра uiParam .
Прямоугольник двойного щелчка — это прямоугольник, в пределах которого должен падать второй щелчок двойного щелчка, чтобы он был зарегистрирован как двойной щелчок. Чтобы получить высоту прямоугольника двойного щелчка, вызовите GetSystemMetrics с флагом SM_CYDOUBLECLK . |
|
Задает ширину прямоугольника двойного щелчка в значение параметра uiParam .
Прямоугольник двойного щелчка — это прямоугольник, в пределах которого должен падать второй щелчок двойного щелчка, чтобы он был зарегистрирован как двойной щелчок. Чтобы получить ширину прямоугольника двойного щелчка, вызовите GetSystemMetrics с флагом SM_CXDOUBLECLK . |
|
Задает текущий параметр визуализации жестов. Параметр 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\Раскладка клавиатуры\Переключение. Допустимые значения: "1" = ALT+SHIFT, "2" = CTRL+SHIFT и "3" = none. |
|
Задает два пороговых значения мыши и ускорение мыши. Параметр pvParam должен указывать на массив из трех целых чисел, задающий эти значения. Дополнительные сведения см. в разделе mouse_event . |
|
Меняет или восстанавливает значение левой и правой кнопок мыши. Параметр uiParam указывает значение TRUE для переключения значений кнопок, или FALSE для восстановления их исходных значений.
Чтобы получить текущий параметр, вызовите GetSystemMetrics с флагом SM_SWAPBUTTON . |
|
Задает высоту (в пикселях) прямоугольника, в котором должен оставаться указатель мыши для TrackMouseEvent для создания сообщения WM_MOUSEHOVER . Задайте для параметра uiParam новую высоту. |
|
Задает время (в миллисекундах), в течение которого указатель мыши должен оставаться в прямоугольнике наведения указателя мыши для TrackMouseEvent , чтобы создать сообщение WM_MOUSEHOVER . Используется только в том случае, если вы передаете HOVER_DEFAULT в параметре dwHoverTime в вызове TrackMouseEvent. Задайте для параметра 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: Операционная система не применяет использование USER_TIMER_MAXIMUM и USER_TIMER_MINIMUM до Windows Server 2003 с пакетом обновления 1 (SP1) и Windows XP с пакетом обновления 2 (SP2). |
|
Задает ширину (в пикселях) прямоугольника, в котором должен оставаться указатель мыши для TrackMouseEvent для создания сообщения WM_MOUSEHOVER . Задайте для параметра uiParam новую ширину. |
|
Задает текущую скорость мыши. Параметр pvParam — это целое число от 1 (самый медленный) до 20 (самый быстрый). Значением по умолчанию является 10. Обычно это значение задается с помощью приложения панели управления мышью. |
|
Включает или отключает функцию "Следы мыши", которая улучшает видимость перемещения курсора мыши, кратко отображая след курсоров и быстро стирая их.
Чтобы отключить эту функцию, задайте для параметра uiParam значение 0 или 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 должен быть переменной BOOL , приведение к ней с помощью PVOID. |
|
Начиная с Windows 11 версии 24H2: Задает сведения о сенсорной панели Precision, включая параметры пользователя и системные сведения, связанные с сенсорной панелью.
Параметр pvParam должен указывать на TOUCHPAD_PARAMETERS структуру. Параметр uiParam должен указывать размер структуры. Значение поля versionNumber в структуре TOUCHPAD_PARAMETERS должно иметь соответствующее значение для используемой версии структуры. |
|
Задает количество символов для прокрутки при перемещении горизонтального колесика мыши. Количество символов задается из параметра uiParam . |
|
Задает количество строк для прокрутки при перемещении вертикального колесика мыши. Количество строк задается с помощью параметра uiParam .
Количество строк — это предлагаемое количество строк для прокрутки при накате колесика мыши без использования клавиш-модификаторов. Если число равно 0, прокрутка не должна выполняться. Если количество прокручиваемых строк больше числа доступных для просмотра строк и, в частности, если оно WHEEL_PAGESCROLL (#defined как UINT_MAX), операция прокрутки должна интерпретироваться как щелчок один раз в области страницы вниз или вверх на полосе прокрутки. |
Ниже приведены параметры меню.
| Параметр меню | Значение |
|---|---|
|
Определяет, выровнены ли всплывающие меню по левому краю или по правому краю относительно соответствующего пункта строки меню. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE при выравнивании по правому краю, или 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.
Windows Server 2003 и Windows XP/2000: Чтобы определить текущее состояние питания дисплея, используйте следующие параметры питания.
Ниже приведены параметры заставки.
Ниже приведены параметры времени ожидания для приложений и служб.
Ниже приведены эффекты пользовательского интерфейса. Значение SPI_SETUIEFFECTS используется для одновременного включения или отключения всех эффектов пользовательского интерфейса. Эта таблица содержит полный список значений эффектов пользовательского интерфейса.
| Параметр эффектов пользовательского интерфейса | Значение |
|---|---|
|
Определяет, включен ли эффект открытия слайда для полей со списком. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE для параметра enabled или FALSE для отключенного. |
|
Определяет, есть ли вокруг курсора тень. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если тень включена, и FALSE , если она отключена. Этот эффект появляется только в том случае, если глубина цвета системы превышает 256 цветов. |
|
Определяет, включен ли эффект градиента для строк заголовков окна. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE для параметра enabled или FALSE для отключенного. Дополнительные сведения о эффекте градиента см. в разделе Функция GetSysColor . |
|
Определяет, включено ли горячее отслеживание элементов пользовательского интерфейса, например имен меню в строках меню. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE для параметра enabled или FALSE для отключенного.
Горячее отслеживание означает, что при перемещении курсора над элементом он выделяется, но не выбирается. Вы можете запросить это значение, чтобы решить, следует ли использовать горячее отслеживание в пользовательском интерфейсе приложения. |
|
Определяет, включен ли эффект плавной прокрутки для списков. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE для параметра enabled или FALSE для отключенного. |
|
Определяет, включена ли функция анимации меню. Этот главный переключатель должен быть включен, чтобы включить эффекты анимации меню. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если анимация включена, и FALSE , если она отключена.
Если анимация включена, SPI_GETMENUFADE указывает, используется ли в меню анимация затухания или слайдов. |
|
То же, что и SPI_GETKEYBOARDCUES. |
|
Определяет, включен ли эффект затухания выделения. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если она включена, или FALSE , если она отключена.
Эффект затухания выделения приводит к тому, что элемент меню, выбранный пользователем, ненадолго остается на экране, а затем исчезает после закрытия меню. |
|
Определяет, включена ли анимация подсказки. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если она включена, или FALSE , если она отключена. Если анимация подсказки включена, SPI_GETTOOLTIPFADE указывает, используется ли анимация всплывающих подсказок или анимация слайдов. |
|
Если SPI_SETTOOLTIPANIMATION включен, SPI_GETTOOLTIPFADE указывает, используется ли анимация подсказки эффект затухания или эффект слайда. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE для анимации затухания или FALSE для анимации слайдов. Дополнительные сведения о эффектах слайда и затухания см. в разделе AnimateWindow. |
|
Определяет, включены или отключены эффекты пользовательского интерфейса. Параметр pvParam должен указывать на переменную BOOL , которая получает значение 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 , чтобы включить анимацию подсказки, или FALSE , чтобы отключить ее. Если этот параметр включен, можно использовать SPI_SETTOOLTIPFADE для указания анимации затухания или слайдов. |
|
Если флаг SPI_SETTOOLTIPANIMATION включен, используйте SPI_SETTOOLTIPFADE , чтобы указать, использует ли анимация подсказки эффект затухания или эффект слайда. Задайте для pvParam значение TRUE для анимации затухания или FALSE для анимации слайдов. Эффект затухания подсказки возможен только в том случае, если глубина цвета в системе превышает 256 цветов. Дополнительные сведения об эффектах слайда и затухания см. в разделе Функция AnimateWindow . |
|
Включает или отключает эффекты пользовательского интерфейса. Задайте для параметра pvParamзначение TRUE , чтобы включить все эффекты пользовательского интерфейса, или FALSE , чтобы отключить все эффекты пользовательского интерфейса. |
Ниже приведены параметры окна.
| Параметр Window | Значение |
|---|---|
|
Определяет, включена ли активная функция отслеживания окна (активация окна, включаемого мышью). Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE для параметра on или FALSE для выключения. |
|
Определяет, будут ли окна, активированные с помощью активного отслеживания окон, быть выведены в верхнюю часть. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE для параметра on или FALSE для выключения. |
|
Извлекает активную задержку отслеживания окна в миллисекундах. Параметр pvParam должен указывать на переменную DWORD , которая получает время. |
|
Извлекает эффекты анимации, связанные с действиями пользователя. Параметр pvParam должен указывать на структуру ANIMATIONINFO , которая получает информацию. Присвойте элементу cbSize этой структуры и параметру uiParam значение sizeof(ANIMATIONINFO).
|
|
Извлекает коэффициент умножения границы, определяющий ширину границы размера окна. Параметр pvParam должен указывать на целочисленную переменную, которая получает это значение. |
|
Извлекает ширину курсора в элементах управления редактированием в пикселях. Параметр pvParam должен указывать на переменную DWORD , которая получает это значение. |
|
Определяет, закреплено ли окно при перемещении к верхнему, левому или правому краю монитора или массива мониторов. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если включено, или FALSE в противном случае.
Используйте SPI_GETWINARRANGING , чтобы определить, включено ли это поведение. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP/2000: Этот параметр не поддерживается. |
|
Определяет, восстанавливается ли развернутое окно при перетаскивании его заголовка. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если включено, или FALSE в противном случае.
Используйте SPI_GETWINARRANGING , чтобы определить, включено ли это поведение. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP/2000: Этот параметр не поддерживается. |
|
Определяет, включено ли перетаскивание полных окон. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если включено, или 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 должен указывать на переменную BOOL , которая получает значение TRUE , если этот параметр включен, или FALSE в противном случае.
Используйте SPI_GETWINARRANGING , чтобы определить, включено ли это поведение. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP/2000: Этот параметр не поддерживается. |
|
Определяет, включено ли упорядочение окон. Параметр pvParam должен указывать на переменную BOOL , которая получает значение TRUE , если этот параметр включен, или FALSE в противном случае.
Расположение окон сокращает количество взаимодействий мыши, пера или сенсорного ввода, необходимых для перемещения и размера окон верхнего уровня, упрощая поведение окна по умолчанию при перетаскивании или размере. Следующие параметры извлекают отдельные параметры расположения окон:
|
|
Устанавливает активное отслеживание окна (активация окна, в котором находится мышь) как включено, так и отключено. Установите для параметра pvParamзначение TRUE для параметра on или FALSE для параметра off. |
|
Определяет, должны ли окна, активированные с помощью активного отслеживания окон, быть перенесены в верхнюю часть. Установите для параметра pvParamзначение TRUE для параметра on или FALSE для параметра off. |
|
Задает задержку отслеживания активного окна. Установите значение pvParam в миллисекундах для задержки перед активацией окна под указателем мыши. |
|
Задает эффекты анимации, связанные с действиями пользователя. Параметр pvParam должен указывать на структуру ANIMATIONINFO , содержащую новые параметры. Присвойте элементу cbSize этой структуры и параметру uiParam значение sizeof(ANIMATIONINFO).
|
|
Задает коэффициент мультипликатора границы, определяющий ширину границы размера окна. Параметр uiParam указывает новое значение. |
|
Задает ширину курсора в элементах управления редактированием. Задайте для параметра pvParam нужную ширину в пикселях. Минимальное значение по умолчанию — 1. |
|
Задает, закрепляется ли окно при перемещении в верхнюю, левую или правую закрепления целевых объектов на мониторе или массиве монитора. Установите для параметра pvParamзначение TRUE для параметра on или FALSE для параметра off.
SPI_GETWINARRANGING должно иметь значение TRUE , чтобы включить такое поведение. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP/2000: Этот параметр не поддерживается. |
|
Задает, восстанавливается ли развернутое окно при перетаскивании его панели заголовков. Установите для параметра pvParamзначение TRUE для параметра on или FALSE для параметра off.
SPI_GETWINARRANGING должно иметь значение TRUE , чтобы включить такое поведение. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP/2000: Этот параметр не поддерживается. |
|
Устанавливает включение или отключение перетаскивания полных окон. Параметр uiParam задает значение TRUE для параметра on или FALSE для параметра off. |
|
Задает высоту (в пикселях) прямоугольника, используемого для определения начала операции перетаскивания. Задайте для uiParam новое значение. Чтобы получить высоту перетаскивания, вызовите GetSystemMetrics с флагом SM_CYDRAG . |
|
Задает ширину (в пикселях) прямоугольника, используемого для определения начала операции перетаскивания. Задайте для uiParam новое значение. Чтобы получить ширину перетаскивания, вызовите Метод GetSystemMetrics с флагом SM_CXDRAG . |
|
Задает количество раз, когда 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). Кроме того, элемент lfHeight структуры LOGFONT должен быть отрицательным значением.
|
|
Задает пороговое значение в пикселях, в котором активируется поведение закрепления с помощью пера для перетаскивания окна к краю монитора или массива мониторов. Пороговое значение по умолчанию — 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 задает значение TRUE для параметра on или FALSE для параметра off. |
|
Задает, будет ли окно развернуто по вертикали при его размере до верхней или нижней части монитора. Установите для параметра pvParamзначение TRUE для параметра on или FALSE для параметра off.
SPI_GETWINARRANGING должно иметь значение TRUE , чтобы включить такое поведение. Windows Server 2008, Windows Vista, Windows Server 2003 и Windows XP/2000: Этот параметр не поддерживается. |
|
Задает, включено ли упорядочение окон. Установите для параметра pvParamзначение TRUE для параметра on или FALSE для параметра off.
Расположение окон сокращает количество взаимодействий мыши, пера или сенсорного ввода, необходимых для перемещения и размера окон верхнего уровня, упрощая поведение окна по умолчанию при перетаскивании или размере. Следующие параметры задают отдельные параметры расположения окон:
|
[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". Варианты американского английского макета, такие как макет Дворжак, называются "00010409", "00020409" и т. д. Список идентификаторов основного языка и подязык, составляющих идентификатор языка, см. в макросе MAKELANGID .
Существует разница между цветовой схемой высокой контрастности и режимом высокой контрастности. Цветовая схема высокой контрастности изменяет системные цвета на цвета с очевидной контрастностью; Переключитесь на эту цветовую схему с помощью параметров отображения на панели управления. Режим высокой контрастности, в котором используются SPI_GETHIGHCONTRAST и SPI_SETHIGHCONTRAST, рекомендует приложениям изменять их внешний вид для пользователей с нарушениями зрения. Он включает в себя такие элементы, как звуковое предупреждение для пользователей и настраиваемая цветовая схема (с помощью параметров специальных возможностей на панели управления). Дополнительные сведения см. в разделе HIGHCONTRAST. Дополнительные сведения об общих специальных возможностях см. в разделе Специальные возможности.
Во время удерживания основной кнопки для активации функции мыши 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 в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h (включая Windows.h) |
| Библиотека | User32.lib |
| DLL | User32.dll |
| Набор API | ext-ms-win-ntuser-sysparams-ext-l1-1-0 (представлено в Windows 8) |