SystemParametersInfoA 함수(winuser.h)
중요
일부 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
시스템 전체 매개 변수 중 하나의 값을 검색하거나 설정합니다. 이 함수는 매개 변수를 설정하는 동안 사용자 프로필을 업데이트할 수도 있습니다.
구문
BOOL SystemParametersInfoA(
[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 매개 변수는 애니메이션이 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킵니다.
깜박임, 깜박임, 깜박임 및 콘텐츠 이동과 같은 표시 기능은 사진에 민감한 간질을 가진 사용자에게 발작을 일으킬 수 있습니다. 이 플래그를 사용하면 클라이언트 영역에서 이러한 애니메이션이 비활성화되었는지 여부를 확인할 수 있습니다. Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다. |
|
겹치는 콘텐츠의 사용 여부를 결정합니다.
pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 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이 하드웨어에 대한 기본 크기 조정 고원을 사용하여 앱을 표시하는지 아니면 다음 상위 고원으로 가는지를 결정하는 값을 검색합니다. 이 값은 PC 설정의 접근성 섹션에 있는 현재 "화면의 모든 항목을 더 크게 만들기" 설정을 기반으로 합니다. 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: 이 매개 변수는 지원되지 않습니다. |
|
마우스 클릭 잠금 기능의 상태를 검색합니다.
pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다. 자세한 내용은 마우스 입력 개요를 참조하세요.
Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
기본 마우스 단추가 잠기기 전의 시간 지연을 검색합니다.
pvParam 매개 변수는 시간 지연을 수신하는 DWORD(밀리초)를 가리킵니다. SPI_SETMOUSECLICKLOCK TRUE로 설정된 경우에만 사용하도록 설정됩니다. 자세한 내용은 마우스 입력 개요를 참조하세요.
Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
MouseKeys 접근성 기능에 대한 정보를 검색합니다.
pvParam 매개 변수는 정보를 수신하는 MOUSEKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(MOUSEKEYS)설정합니다.
|
|
마우스 수중 음파 탐지기 기능의 상태를 검색합니다.
pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다. 자세한 내용은 마우스 입력 개요를 참조하세요.
Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
마우스 소실 기능의 상태를 검색합니다.
pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다. 자세한 내용은 마우스 입력 개요를 참조하세요.
Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
화면 검토자 유틸리티가 실행 중인지 여부를 확인합니다. 화면 검토자 유틸리티는 음성 신시사이저 또는 점자 디스플레이와 같은 출력 디바이스에 텍스트 정보를 전달합니다. 이 플래그가 설정되면 애플리케이션은 그렇지 않으면 정보를 그래픽으로 표시하는 상황에서 텍스트 정보를 제공해야 합니다.
pvParam 매개 변수는 화면 검토자 유틸리티가 실행 중인 경우 TRUE를 수신하는 BOOL 변수에 대한 포인터이거나 그렇지 않으면 FALSE입니다.
참고 Windows에 포함된 화면 읽기 프로그램인 내레이터는 SPI_SETSCREENREADER 또는 SPI_GETSCREENREADER 플래그를 설정하지 않습니다.
|
|
이 매개 변수는 지원되지 않습니다.
Windows Server 2003 및 Windows XP/2000: 사용자는 제어판을 통해 이 설정을 제어해야 합니다. |
|
소리 표시 접근성 플래그가 켜지거나 꺼져 있는지 여부를 확인합니다. 이 설정이 켜진 경우 사용자는 애플리케이션이 정보를 가청 형식으로만 제공하는 상황에서 시각적으로 정보를 표시하도록 요구합니다.
pvParam 매개 변수는 기능이 켜져 있으면 TRUE를 수신하는 BOOL 변수를 가리키고, 해제된 경우 FALSE를 가리킵니다.
이 값을 사용하는 것은 SM_SHOWSOUNDSGetSystemMetrics를 호출하는 것과 같습니다. 이것이 권장되는 호출입니다. |
|
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 매개 변수는 메시지 기간을 지정합니다.
시각 장애가 있거나 ADHD 및 난독증과 같은 인지 조건이 있는 사용자는 알림 메시지에서 텍스트를 읽는 데 시간이 더 오래 필요할 수 있습니다. 이 플래그를 사용하면 메시지 기간을 설정할 수 있습니다. Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다. |
|
마우스 클릭 접근성 차단 기능을 켜거나 끕니다. 이 기능은 해당 단추를 클릭하고 SPI_SETMOUSECLICKLOCKTIME 지정된 시간 동안 누른 상태에서 기본 마우스 단추를 일시적으로 잠가 둡니다.
pvParam 매개 변수는 on에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다. 기본값은 off입니다. 자세한 내용은 설명 및 정보문자 입력을 참조하세요.
Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
기본 마우스 단추가 잠기기 전에 시간 지연을 조정합니다.
uiParam 매개 변수는 0으로 설정해야 합니다.
pvParam 매개 변수는 시간 지연을 밀리초 단위로 지정하는 DWORD를 가리킵니다. 예를 들어 1초 지연에 대해 1000을 지정합니다. 기본값은 1200입니다. 자세한 내용은 마우스 입력 개요를 참조하세요.
Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
MouseKeys 접근성 기능의 매개 변수를 설정합니다.
pvParam 매개 변수는 새 매개 변수를 포함하는 MOUSEKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(MOUSEKEYS)설정합니다.
|
|
수중 음파 탐지기 접근성 기능을 켜거나 끕니다. 이 기능은 사용자가 Ctrl 키를 누르고 놓을 때 마우스 포인터 주위의 여러 동심원을 간략하게 보여줍니다.
pvParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다. 기본값은 off입니다. 자세한 내용은 마우스 입력 개요를 참조하세요.
Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
소멸 기능을 켜거나 끕니다. 이 기능은 사용자가 입력할 때 마우스 포인터를 숨깁니다. 포인터는 사용자가 마우스를 이동할 때 다시 나타납니다.
pvParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다. 기본값은 off입니다. 자세한 내용은 마우스 입력 개요를 참조하세요.
Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
화면 검토 유틸리티가 실행 중인지 여부를 확인합니다.
uiParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다.
참고 Windows에 포함된 화면 읽기 프로그램인 내레이터는 SPI_SETSCREENREADER 또는 SPI_GETSCREENREADER 플래그를 설정하지 않습니다.
|
|
이 매개 변수는 지원되지 않습니다.
Windows Server 2003 및 Windows XP/2000: 사용자는 제어판을 통해 이 설정을 제어해야 합니다. |
|
ShowSounds 접근성 기능을 켜거나 끕니다. uiParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다. |
|
SoundSentry 접근성 기능의 매개 변수를 설정합니다.
pvParam 매개 변수는 새 매개 변수를 포함하는 SOUNDSENTRY 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(SOUNDSENTRY)설정합니다.
|
|
StickyKeys 접근성 기능의 매개 변수를 설정합니다.
pvParam 매개 변수는 새 매개 변수를 포함하는 STICKYKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(STICKYKEYS)설정합니다.
|
|
ToggleKeys 접근성 기능의 매개 변수를 설정합니다.
pvParam 매개 변수는 새 매개 변수를 포함하는 TOGGLEKEYS 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(TOGGLEKEYS)설정합니다.
|
다음은 데스크톱 매개 변수입니다.
| 데스크톱 매개 변수 | 의미 |
|---|---|
|
ClearType을 사용할 수 있는지 여부를 확인합니다.
pvParam 매개 변수는 ClearType이 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킵니다.
ClearType은 LCD(액정 디스플레이) 모니터에서 텍스트의 가독성을 향상시키는 소프트웨어 기술입니다. Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다. |
|
바탕 화면 배경 화면의 비트맵 파일 전체 경로를 검색합니다. pvParam 매개 변수는 null로 끝나는 경로 문자열을 수신하기 위해 버퍼를 가리킵니다. uiParam 매개 변수를 pvParam 버퍼의 크기(문자)로 설정합니다. 반환된 문자열은 MAX_PATH 문자를 초과하지 않습니다. 바탕 화면 배경 화면이 없으면 반환된 문자열이 비어 있습니다. |
|
그림자 효과를 사용할 수 있는지 여부를 확인합니다.
pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 반환하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.
Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
네이티브 사용자 메뉴에 플랫 메뉴 모양이 있는지 여부를 결정합니다.
pvParam 매개 변수는 플랫 메뉴 모양이 설정된 경우 TRUE를 반환하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킵니다.
Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
글꼴 다듬기 기능을 사용할 수 있는지 여부를 결정합니다. 이 기능은 글꼴 앤티앨리어싱을 사용하여 다양한 회색 수준에서 픽셀을 그리면 글꼴 곡선이 더 부드럽게 표시되도록 합니다.
pvParam 매개 변수는 기능이 사용하도록 설정된 경우 TRUE를 수신하는 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 변수입니다. ClearType을 사용하도록 설정하려면 pvParam 을 TRUE 로 설정하고 FALSE를 설정 하여 사용하지 않도록 설정합니다.
ClearType은 LCD 모니터에서 텍스트의 가독성을 향상시키는 소프트웨어 기술입니다. Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다. |
|
시스템 커서를 다시 로드합니다. uiParam 매개 변수를 0으로 설정하고 pvParam 매개 변수를 NULL로 설정합니다. |
|
Windows가 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_SETFONTSMOOTHINGTYPEFE_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 매개 변수를 0으로 설정하고 pvParam 매개 변수를 NULL로 설정합니다. |
|
아이콘 제목에 사용되는 글꼴을 설정합니다. uiParam 매개 변수는 LOGFONT 구조체의 크기를 지정하고 pvParam 매개 변수는 LOGFONT 구조를 가리킵니다. |
|
아이콘 제목 래핑을 켜거나 끕니다. uiParam 매개 변수는 ON에 대해 TRUE를 지정하고, 해제의 경우 FALSE를 지정합니다. |
입력 매개 변수는 다음과 같습니다. 여기에는 키보드, 마우스, 터치 패드, 펜, 입력 언어 및 경고 비퍼와 관련된 매개 변수가 포함됩니다.
| 입력 매개 변수 | 의미 |
|---|---|
|
경고 비퍼가 켜지는지 여부를 확인합니다.
pvParam 매개 변수는 비퍼가 켜져 있으면 TRUE를 수신하는 BOOL 변수를 가리키고, 비퍼가 꺼져 있으면 FALSE를 가리킵니다. |
|
SendInput 함수를 호출하여 키보드 또는 마우스 입력을 시뮬레이션하여 애플리케이션이 화면 보호기 타이머를 다시 설정할 수 있는지 여부를 나타내는 BOOL을 검색합니다. pvParam 매개 변수는 시뮬레이션된 입력이 차단될 경우 TRUE를 수신하는 BOOL 변수를 가리킵니다. 그렇지 않으면 FALSE를 가리킵니다. |
|
현재 연락처 시각화 설정을 검색합니다. pvParam 매개 변수는 설정을 수신하는 ULONG 변수를 가리킵니다. 자세한 내용은 연락처 시각화를 참조하세요. |
|
시스템 기본 입력 언어에 대한 입력 로캘 식별자를 검색합니다. pvParam 매개 변수는 이 값을 받는 HKL 변수를 가리킵니다. 자세한 내용은 언어, 로캘 및 키보드 레이아웃을 참조하세요. |
|
현재 제스처 시각화 설정을 검색합니다. pvParam 매개 변수는 설정을 수신하는 ULONG 변수를 가리킵니다. 자세한 내용은 제스처 시각화를 참조하세요. |
|
메뉴 액세스 키에 항상 밑줄이 표시되는지 여부를 결정합니다. pvParam 매개 변수는 메뉴 액세스 키가 항상 밑줄이 그어지는 경우 TRUE를 수신하는 BOOL 변수를 가리킨 다음 키보드에서 메뉴를 활성화할 때만 밑줄이 그어지는 경우 FALSE를 가리킵니다. |
|
0(약 250ms 지연)부터 3(약 1초 지연)에 이르는 범위의 값인 키보드 반복 지연 설정을 검색합니다. 각 값과 관련된 실제 지연은 하드웨어에 따라 달라질 수 있습니다. pvParam 매개 변수는 설정을 수신하는 정수 변수를 가리킵니다. |
|
사용자가 마우스 대신 키보드를 사용하는지 여부를 결정하고 애플리케이션에서 숨겨진 키보드 인터페이스를 표시하려고 합니다. pvParam 매개 변수는 사용자가 키보드를 사용하는 경우 TRUE를 수신하는 BOOL 변수를 가리킵니다. 그렇지 않으면 FALSE입니다. |
|
0(초당 약 2.5회 반복)부터 31(초당 약 30회 반복) 범위의 값인 키보드 반복 속도 설정을 검색합니다. 실제 반복 속도는 하드웨어에 따라 다르며 선형 규모에서 최대 20%까지 다를 수 있습니다. pvParam 매개 변수는 설정을 수신하는 DWORD 변수를 가리킵니다. |
|
두 개의 마우스 임계값과 마우스 가속을 검색합니다. pvParam 매개 변수는 이러한 값을 수신하는 세 개의 정수 배열을 가리킵니다. 자세한 내용은 mouse_event 참조하세요. |
|
TrackMouseEvent가 WM_MOUSEHOVER 메시지를 생성하기 위해 마우스 포인터를 유지해야 하는 사각형의 높이를 픽셀 단위로 검색합니다. pvParam 매개 변수는 높이를 받는 UINT 변수를 가리킵니다. |
|
WM_MOUSEHOVER 메시지를 생성하기 위해 마우스 포인터가 TrackMouseEvent 의 가리키기 사각형에 있어야 하는 시간을 밀리 초 단위로 검색합니다. pvParam 매개 변수는 시간을 수신하는 UINT 변수를 가리킵니다. |
|
TrackMouseEvent가 WM_MOUSEHOVER 메시지를 생성하기 위해 마우스 포인터를 유지해야 하는 사각형의 너비를 픽셀 단위로 검색합니다. pvParam 매개 변수는 너비를 받는 UINT 변수를 가리킵니다. |
|
현재 마우스 속도를 검색합니다. 마우스 속도는 마우스가 이동하는 거리에 따라 포인터가 이동할 거리를 결정합니다. pvParam 매개 변수는 1(가장 느림)에서 20(가장 빠른) 사이의 값을 받는 정수를 가리킵니다. 값 10이 기본값입니다. 이 값은 마우스 제어판 애플리케이션을 사용하는 최종 사용자 또는 SPI_SETMOUSESPEED 사용하는 애플리케이션에서 설정할 수 있습니다. |
|
마우스 트레일 기능을 사용할 수 있는지 여부를 확인합니다. 이 기능은 커서의 흔적을 간략하게 표시하고 빠르게 지워 마우스 커서 이동의 가시성을 향상시킵니다.
pvParam 매개 변수는 값을 받는 정수 변수를 가리킵니다. 값이 0 또는 1이면 기능이 비활성화됩니다. 값이 1보다 크면 기능이 활성화되고 값은 추적에 그려진 커서 수를 나타냅니다. uiParam 매개 변수는 사용되지 않습니다. Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
마우스 휠 입력에 대한 라우팅 설정을 검색합니다. 라우팅 설정은 마우스 휠 입력이 포커스가 있는 앱(포그라운드) 또는 마우스 커서 아래의 앱으로 전송되는지 여부를 결정합니다.
pvParam 매개 변수는 라우팅 옵션을 수신하는 DWORD 변수를 가리킵니다. uiParam 매개 변수는 사용되지 않습니다. 값이 0(MOUSEWHEEL_ROUTING_FOCUS)이면 마우스 휠 입력이 포커스를 사용하여 앱에 전달됩니다. 값이 1(MOUSEWHEEL_ROUTING_HYBRID)이면 마우스 휠 입력이 포커스가 있는 앱(데스크톱 앱) 또는 마우스 포인터(Windows 스토어 앱) 아래의 앱으로 전달됩니다. Windows 10부터: 값이 2(MOUSEWHEEL_ROUTING_MOUSE_POS)이면 마우스 휠 입력이 마우스 포인터 아래의 앱에 전달됩니다. 이는 새로운 기본값이며 MOUSEWHEEL_ROUTING_HYBRID 설정에서 더 이상 사용할 수 없습니다. |
|
현재 펜 제스처 시각화 설정을 검색합니다. pvParam 매개 변수는 설정을 수신하는 ULONG 변수를 가리킵니다. 자세한 내용은 펜 시각화를 참조하세요. |
|
맞춤-기본 단추 기능을 사용할 수 있는지 여부를 결정합니다. 사용하도록 설정하면 마우스 커서가 대화 상자의 기본 단추(예: 확인 또는 적용)로 자동으로 이동합니다. pvParam 매개 변수는 기능이 켜져 있으면 TRUE를 수신하는 BOOL 변수를 가리키고, 해제된 경우 FALSE를 가리킵니다. |
|
Windows 8부터: 시스템 언어 모음을 사용할지 여부를 결정합니다. pvParam 매개 변수는 언어 모음이 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 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를 지정하고 해제의 경우 FALSE를 지정합니다. |
|
애플리케이션이 SendInput 함수를 호출하여 키보드 또는 마우스 입력을 시뮬레이션하여 화면 보호기 타이머를 다시 설정할 수 있는지 여부를 결정합니다. uiParam 매개 변수는 시뮬레이트된 입력에 의해 화면 보호기가 비활성화되지 않는 경우 TRUE를 지정하고, 시뮬레이트된 입력에 의해 화면 보호기가 비활성화될 경우 FALSE를 지정합니다. |
|
현재 연락처 시각화 설정을 설정합니다.
pvParam 매개 변수는 설정을 식별하는 ULONG 변수를 가리킵니다. 자세한 내용은 연락처 시각화를 참조하세요.
참고 연락처 시각화를 사용하지 않도록 설정하면 제스처 시각화를 사용하도록 설정할 수 없습니다.
|
|
시스템 셸 및 애플리케이션의 기본 입력 언어를 설정합니다. 지정된 언어는 현재 시스템 문자 집합을 사용하여 표시할 수 있어야 합니다. pvParam 매개 변수는 기본 언어에 대한 입력 로캘 식별자가 포함된 HKL 변수를 가리킵니다. 자세한 내용은 언어, 로캘 및 키보드 레이아웃을 참조하세요. |
|
마우스의 두 번 클릭 시간을 uiParam 매개 변수 값으로 설정합니다.
uiParam 값이 5000밀리초보다 큰 경우 시스템은 두 번 클릭 시간을 5000밀리초로 설정합니다.
두 번 클릭 시간은 두 번 클릭의 첫 번째와 두 번째 클릭 사이에 발생할 수 있는 최대 시간(밀리초)입니다. SetDoubleClickTime 함수를 호출하여 두 번 클릭 시간을 설정할 수도 있습니다. 현재 두 번 클릭 시간을 얻으려면 GetDoubleClickTime 함수를 호출합니다. |
|
두 번 클릭 사각형의 높이를 uiParam 매개 변수 값으로 설정합니다.
두 번 클릭 사각형은 두 번 클릭으로 등록하려면 두 번 클릭의 두 번째 클릭이 있어야 하는 사각형입니다. 두 번 클릭 사각형의 높이를 검색하려면 SM_CYDOUBLECLK 플래그를 사용하여 GetSystemMetrics를 호출합니다. |
|
두 번 클릭 사각형의 너비를 uiParam 매개 변수 값으로 설정합니다.
두 번 클릭 사각형은 두 번 클릭으로 등록하려면 두 번 클릭의 두 번째 클릭이 있어야 하는 사각형입니다. 두 번 클릭 사각형의 너비를 검색하려면 SM_CXDOUBLECLK 플래그를 사용하여 GetSystemMetrics를 호출합니다. |
|
현재 제스처 시각화 설정을 설정합니다.
pvParam 매개 변수는 설정을 식별하는 ULONG 변수를 가리킵니다. 자세한 내용은 제스처 시각화를 참조하세요.
참고 연락처 시각화를 사용하지 않도록 설정하면 제스처 시각화를 사용하도록 설정할 수 없습니다.
|
|
메뉴 액세스 키 문자의 밑줄을 설정합니다. pvParam 매개 변수는 BOOL 변수입니다. 메뉴 액세스 키에 항상 밑줄을 표시하려면 pvParam 을 TRUE 로 설정하고, 키보드에서 메뉴가 활성화된 경우에만 FALSE 를 메뉴 액세스 키에 밑줄로 설정합니다. |
|
키보드 반복 지연 설정을 설정합니다. uiParam 매개 변수는 0, 1, 2 또는 3을 지정해야 합니다. 여기서 0은 가장 짧은 지연을 약 250ms로 설정하고 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를 지정합니다.
현재 설정을 검색하려면 SM_SWAPBUTTON 플래그를 사용하여 GetSystemMetrics를 호출합니다. |
|
WM_MOUSEHOVER 메시지를 생성하기 위해 TrackMouseEvent에 대해 마우스 포인터를 유지해야 하는 사각형의 높이를 픽셀 단위로 설정합니다. uiParam 매개 변수를 새 높이로 설정합니다. |
|
WM_MOUSEHOVER 메시지를 생성하기 위해 마우스 포인터가 TrackMouseEvent의 가리키기 사각형에 있어야 하는 시간을 밀리초 단위로 설정합니다.
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가 있는 Windows Server 2003까지 USER_TIMER_MAXIMUM 및 USER_TIMER_MINIMUM 사용을 적용하지 않습니다. |
|
WM_MOUSEHOVER 메시지를 생성하기 위해 TrackMouseEvent에 대해 마우스 포인터를 유지해야 하는 사각형의 너비를 픽셀 단위로 설정합니다. uiParam 매개 변수를 새 너비로 설정합니다. |
|
현재 마우스 속도를 설정합니다. pvParam 매개 변수는 1(가장 느림)에서 20(가장 빠른) 사이의 정수입니다. 값 10이 기본값입니다. 이 값은 일반적으로 마우스 제어판 애플리케이션을 사용하여 설정됩니다. |
|
마우스 추적 기능을 사용하거나 사용하지 않도록 설정하여 커서의 흔적을 간략하게 표시하고 빠르게 지워 마우스 커서 이동의 가시성을 향상시킵니다.
기능을 사용하지 않도록 설정하려면 uiParam 매개 변수를 0 또는 1로 설정합니다. 이 기능을 사용하도록 설정하려면 uiParam 을 1보다 큰 값으로 설정하여 추적에 그려진 커서 수를 나타냅니다. Windows 2000: 이 매개 변수는 지원되지 않습니다. |
|
마우스 휠 입력에 대한 라우팅 설정을 설정합니다. 라우팅 설정은 마우스 휠 입력이 포커스가 있는 앱(포그라운드) 또는 마우스 커서 아래의 앱으로 전송되는지 여부를 결정합니다.
pvParam 매개 변수는 라우팅 옵션을 수신하는 DWORD 변수를 가리킵니다. uiParam 매개 변수를 0으로 설정합니다. 값이 0(MOUSEWHEEL_ROUTING_FOCUS)이면 마우스 휠 입력이 포커스를 사용하여 앱에 전달됩니다. 값이 1(MOUSEWHEEL_ROUTING_HYBRID)이면 마우스 휠 입력이 포커스가 있는 앱(데스크톱 앱) 또는 마우스 포인터(Windows 스토어 앱) 아래의 앱으로 전달됩니다. Windows 10부터: 값이 2(MOUSEWHEEL_ROUTING_MOUSE_POS)이면 마우스 휠 입력이 마우스 포인터 아래의 앱에 전달됩니다. 이는 새로운 기본값이며 MOUSEWHEEL_ROUTING_HYBRID 설정에서 더 이상 사용할 수 없습니다. |
|
현재 펜 제스처 시각화 설정을 설정합니다. pvParam 매개 변수는 설정을 식별하는 ULONG 변수를 가리킵니다. 자세한 내용은 펜 시각화를 참조하세요. |
|
snap-to-default-button 기능을 사용하거나 사용하지 않도록 설정합니다. 사용하도록 설정하면 마우스 커서가 대화 상자의 기본 단추(예: 확인 또는 적용)로 자동으로 이동합니다. 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(#definedUINT_MAX)인 경우 스크롤 작업은 스크롤 막대의 페이지 아래쪽 또는 페이지 위로 영역을 한 번 클릭하는 것으로 해석되어야 합니다. |
메뉴 매개 변수는 다음과 같습니다.
| 메뉴 매개 변수 | 의미 |
|---|---|
|
해당 메뉴 모음 항목을 기준으로 팝업 메뉴가 왼쪽 맞춤 또는 오른쪽 맞춤인지 여부를 결정합니다. pvParam 매개 변수는 오른쪽 맞춤이면 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다. |
|
메뉴 페이드 애니메이션을 사용할지 여부를 결정합니다. pvParam 매개 변수는 페이드 애니메이션을 사용할 때 TRUE를 수신하는 BOOL변수를 가리킨 다음 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 전원 설정 변경에 대한 알림을 등록해야 합니다. 자세한 내용은 전원 이벤트 등록을 참조하세요.
Windows Server 2003 및 Windows XP/2000: 현재 디스플레이 전원 상태를 확인하려면 다음 전원 매개 변수를 사용합니다.
다음은 화면 보호기 매개 변수입니다.
다음은 애플리케이션 및 서비스에 대한 제한 시간 매개 변수입니다.
다음은 UI 효과입니다. SPI_SETUIEFFECTS 값은 모든 UI 효과를 한 번에 사용하거나 사용하지 않도록 설정하는 데 사용됩니다. 이 테이블에는 UI 효과 값의 전체 목록이 포함되어 있습니다.
| UI 효과 매개 변수 | 의미 |
|---|---|
|
콤보 상자에 대한 슬라이드 열기 효과를 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 활성화된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다. |
|
커서 주위에 그림자가 있는지 여부를 확인합니다. pvParam 매개 변수는 그림자가 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리킨 다음, 사용하지 않도록 설정된 경우 FALSE를 가리킵니다. 이 효과는 시스템에 색 깊이가 256개 이상인 경우에만 나타납니다. |
|
창 제목 표시줄의 그라데이션 효과를 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 활성화된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다. 그라데이션 효과에 대한 자세한 내용은 GetSysColor 함수를 참조하세요. |
|
메뉴 모음의 메뉴 이름과 같은 사용자 인터페이스 요소의 핫 추적을 사용할 수 있는지 여부를 결정합니다.
pvParam 매개 변수는 활성화된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.
핫 트랙은 커서가 항목 위로 이동하면 강조 표시되지만 선택되지는 않음을 의미합니다. 이 값을 쿼리하여 애플리케이션의 사용자 인터페이스에서 핫 추적을 사용할지 여부를 결정할 수 있습니다. |
|
목록 상자의 부드러운 스크롤 효과를 사용할 수 있는지 여부를 결정합니다. pvParam 매개 변수는 활성화된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 FALSE를 가리킵니다. |
|
메뉴 애니메이션 기능을 사용할 수 있는지 여부를 결정합니다. 메뉴 애니메이션 효과를 사용하려면 이 마스터 스위치가 켜져 있어야 합니다.
pvParam 매개 변수는 애니메이션이 활성화된 경우 TRUE를 수신하는 BOOL 변수를 가리킨 다음 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.
애니메이션을 사용하는 경우 SPI_GETMENUFADE 메뉴에서 페이드 애니메이션 또는 슬라이드 애니메이션을 사용하는지 여부를 나타냅니다. |
|
SPI_GETKEYBOARDCUES 동일합니다. |
|
선택 페이드 효과를 사용할지 여부를 결정합니다.
pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리킨 다음 사용하지 않도록 설정된 경우 FALSE를 가리킵니다.
선택 페이드 효과로 인해 사용자가 선택한 메뉴 항목이 잠시 화면에 남아 있는 동안 메뉴가 해제된 후 사라집니다. |
|
도구 설명 애니메이션을 사용할지 여부를 결정합니다. pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리킨 다음 사용하지 않도록 설정된 경우 FALSE를 가리킵니다. 도구 설명 애니메이션을 사용하는 경우 SPI_GETTOOLTIPFADE 도구 설명이 페이드 애니메이션 또는 슬라이드 애니메이션을 사용하는지 여부를 나타냅니다. |
|
SPI_SETTOOLTIPANIMATION 사용하도록 설정된 경우 SPI_GETTOOLTIPFADE 도구 설명 애니메이션이 페이드 효과 또는 슬라이드 효과를 사용하는지 여부를 나타냅니다. pvParam 매개 변수는 페이드 애니메이션의 경우 TRUE를 수신하는 BOOL 변수를 가리키고 슬라이드 애니메이션의 경우 FALSE를 가리킵니다. 슬라이드 및 페이드 효과에 대한 자세한 내용은 AnimateWindow를 참조하세요. |
|
UI 효과를 사용할지 아니면 사용하지 않도록 설정할지 여부를 결정합니다. pvParam 매개 변수는 모든 UI 효과가 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 사용하지 않도록 설정된 경우 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 함수를 참조하세요. |
|
UI 효과를 사용하거나 사용하지 않도록 설정합니다. pvParam 매개 변수를 TRUE로 설정하여 모든 UI 효과를 사용하도록 설정하거나 FALSE를 사용하여 모든 UI 효과를 사용하지 않도록 설정합니다. |
다음은 창 매개 변수입니다.
| Window 매개 변수 | 의미 |
|---|---|
|
활성 창 추적(마우스가 켜진 창 활성화)이 켜지거나 꺼져 있는지 여부를 결정합니다. pvParam 매개 변수는 ON에 대해 TRUE를 수신하는 BOOL 변수를 가리키거나 해제할 경우 FALSE를 가리킵니다. |
|
활성 창 추적을 통해 활성화된 창을 맨 위로 가져올지 여부를 결정합니다. pvParam 매개 변수는 ON에 대해 TRUE를 수신하는 BOOL 변수를 가리키거나 해제할 경우 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 매개 변수는 상태 창이 표시되면 TRUE를 수신하는 BOOL 변수를 가리키고, 그렇지 않으면 FALSE를 가리킵니다. |
|
창이 모니터 또는 모니터 배열의 위쪽 또는 아래쪽에 크기가 조정될 때 세로로 최대화되는지 여부를 결정합니다.
pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다.
SPI_GETWINARRANGING 사용하여 이 동작이 사용되는지 여부를 확인합니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다. |
|
창 배열을 사용할 수 있는지 여부를 결정합니다.
pvParam 매개 변수는 사용하도록 설정된 경우 TRUE를 수신하는 BOOL 변수를 가리키고 그렇지 않으면 FALSE를 가리킬 수 있습니다.
창 배열은 창이 끌거나 크기가 조정될 때 창의 기본 동작을 간소화하여 최상위 창을 이동하고 크기를 조정하는 데 필요한 마우스, 펜 또는 터치 조작의 수를 줄입니다. 다음 매개 변수는 개별 창 정렬 설정을 검색합니다.
|
|
활성 창 추적(마우스가 켜진 창 활성화)을 설정하거나 해제합니다. pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다. |
|
활성 창 추적을 통해 활성화된 창을 맨 위로 가져올지 여부를 결정합니다. pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다. |
|
활성 창 추적 지연을 설정합니다. pvParam을 마우스 포인터 아래의 창을 활성화하기 전에 지연할 시간(밀리초)으로 설정합니다. |
|
사용자 작업과 연결된 애니메이션 효과를 설정합니다.
pvParam 매개 변수는 새 매개 변수를 포함하는 ANIMATIONINFO 구조를 가리킵니다. 이 구조체의 cbSize 멤버와 uiParam 매개 변수를 로 sizeof(ANIMATIONINFO)설정합니다.
|
|
창 크기 조정 테두리의 너비를 결정하는 테두리 승수 인수를 설정합니다. uiParam 매개 변수는 새 값을 지정합니다. |
|
편집 컨트롤의 캐리트 너비를 설정합니다. pvParam을 원하는 너비(픽셀)로 설정합니다. 기본값과 최소값은 1입니다. |
|
모니터 또는 모니터 배열의 위쪽, 왼쪽 또는 오른쪽 도킹 대상으로 이동할 때 창이 도킹되는지 여부를 설정합니다.
pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다.
이 동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다. |
|
캡션 표시줄을 끌 때 최대화된 창이 복원되는지 여부를 설정합니다.
pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다.
이 동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다. |
|
전체 창의 끌기를 켜거나 끕니다. uiParam 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 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 매개 변수는 ON에 대해 TRUE를 지정하고 해제의 경우 FALSE를 지정합니다. |
|
창이 모니터의 위쪽 또는 아래쪽으로 크기가 조정될 때 세로로 최대화되는지 여부를 설정합니다.
pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다.
이 동작을 사용하려면 SPI_GETWINARRANGING TRUE 여야 합니다. Windows Server 2008, Windows Vista, Windows Server 2003 및 Windows XP/2000: 이 매개 변수는 지원되지 않습니다. |
|
창 배열을 사용할지 여부를 설정합니다.
pvParam을 ON의 경우 TRUE로, 해제의 경우 FALSE로 설정합니다.
창 배열은 창이 끌거나 크기가 조정될 때 창의 기본 동작을 간소화하여 최상위 창을 이동하고 크기를 조정하는 데 필요한 마우스, 펜 또는 터치 조작의 수를 줄입니다. 다음 매개 변수는 개별 창 정렬 설정을 설정합니다.
|
[in] uiParam
형식: UINT
사용량 및 형식이 쿼리 또는 설정되는 시스템 매개 변수에 따라 달라지는 매개 변수입니다. 시스템 전체 매개 변수에 대한 자세한 내용은 uiAction 매개 변수를 참조하세요. 달리 표시되지 않으면 이 매개 변수에 대해 0을 지정해야 합니다.
[in, out] pvParam
형식: PVOID
사용량 및 형식이 쿼리 또는 설정되는 시스템 매개 변수에 따라 달라지는 매개 변수입니다. 시스템 전체 매개 변수에 대한 자세한 내용은 uiAction 매개 변수를 참조하세요. 달리 표시되지 않으면 이 매개 변수에 대해 NULL 을 지정해야 합니다. PVOID 데이터 형식에 대한 자세한 내용은 Windows 데이터 형식을 참조하세요.
[in] fWinIni
형식: UINT
시스템 매개 변수를 설정하는 경우 는 사용자 프로필을 업데이트할지 여부를 지정하고, 업데이트할 경우 WM_SETTINGCHANGE 메시지를 모든 최상위 창으로 브로드캐스트하여 변경 사항을 알릴지 여부를 지정합니다.
사용자 프로필을 업데이트하거나 WM_SETTINGCHANGE 메시지를 브로드캐스트하지 않으려면 이 매개 변수가 0이거나 다음 값 중 하나 이상이 될 수 있습니다.
| 값 | 의미 |
|---|---|
|
새 시스템 전체 매개 변수 설정을 사용자 프로필에 씁니다. |
|
사용자 프로필을 업데이트한 후 WM_SETTINGCHANGE 메시지를 브로드캐스트합니다. |
|
SPIF_SENDCHANGE 동일합니다. |
반환 값
형식: BOOL
함수가 성공하면 반환 값은 0이 아닌 값입니다.
함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.
설명
이 함수는 사용자가 환경을 사용자 지정할 수 있는 애플리케이션과 함께 사용하기 위한 것입니다.
키보드 레이아웃 이름은 레이아웃에 해당하는 언어 식별자의 16진수 값에서 파생되어야 합니다. 예를 들어 미국 영어에는 0x0409 언어 식별자가 있으므로 기본 미국 영어 레이아웃의 이름은 "00000409"입니다. Dvorak 레이아웃과 같은 미국 영어 레이아웃의 변형 이름은 "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 |
| 헤더 | winuser.h(Windows.h 포함) |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
| API 세트 | ext-ms-win-ntuser-sysparams-ext-l1-1-0(Windows 8에서 도입) |