다음을 통해 공유

HIGHCONTRASTW 구조체(winuser.h)

  • 아티클

고대비 접근성 기능에 대한 정보를 포함합니다. 이 기능은 시각 장애가 있는 사용자의 가시성을 극대화하기 위해 사용자 인터페이스의 모양 체계를 설정하고 애플리케이션에 이 모양 체계를 준수하도록 권고합니다.

구문

typedef struct tagHIGHCONTRASTW {
  UINT   cbSize;
  DWORD  dwFlags;
  LPWSTR lpszDefaultScheme;
} HIGHCONTRASTW, *LPHIGHCONTRASTW;

멤버

cbSize

형식: UINT

이 구조체의 크기(바이트)를 지정합니다.

dwFlags

형식: DWORD

다음 값의 조합을 지정합니다.

값 의미
HCF_HIGHCONTRASTON
0x00000001
 고대비 기능이 켜집니다.
HCF_AVAILABLE
0x00000002
 고대비 기능을 사용할 수 있습니다.
HCF_HOTKEYACTIVE
0x00000004
 사용자는 왼쪽 ALT, 왼쪽 SHIFT 및 PRINT SCREEN 키를 동시에 눌러 고대비 기능을 켜고 끌 수 있습니다.
HCF_CONFIRMHOTKEY
0x00000008
 핫 키를 사용하여 고대비 기능을 활성화하면 확인 대화 상자가 나타납니다.
HCF_HOTKEYSOUND
0x00000010
 사용자가 핫 키를 사용하여 고대비 기능을 켜거나 끌 때 사이렌이 재생됩니다.
HCF_INDICATOR
0x00000020
 고대비 기능이 켜지면 시각적 표시기가 표시됩니다. 이 값은 현재 사용되지 않으며 무시됩니다.
HCF_HOTKEYAVAILABLE
0x00000040
 고대비 기능과 연결된 핫 키를 사용하도록 설정할 수 있습니다. 애플리케이션은 이 값을 검색할 수 있지만 설정할 수는 없습니다.
HCF_OPTION_NOTHEMECHANGE
0x00001000

SystemParametersInfoW 호출에서 HIGHCONTRASTSTRUCTURE를 전달하면 테마가 변경되지 않더라도 테마 변경 효과가 발생할 수 있습니다. 예를 들어 WM_THEMECHANGED 메시지는 변경 내용만 HCF_HOTKEYSOUND 경우에도 Windows로 전송됩니다.

이를 방지하려면 SystemParametersInfo 호출에 HCF_OPTION_NOTHEMECHANGE 플래그를 포함합니다.

참고

고대비 모드(HCF_HIGHCONTRASTON)를 전환할 때는 HCF_OPTION_NOTHEMECHANGE 플래그를 사용하면 안 됩니다.
HCF_OPTION_NOTHEMECHANGE
0x00001000

SystemParametersInfoW 호출에서 HIGHCONTRASTSTRUCTURE를 전달하면 테마가 변경되지 않더라도 테마 변경 효과가 발생할 수 있습니다. 예를 들어 WM_THEMECHANGED 메시지는 변경 내용만 HCF_HOTKEYSOUND 경우에도 Windows로 전송됩니다.

이를 방지하려면 SystemParametersInfo 호출에 HCF_OPTION_NOTHEMECHANGE 플래그를 포함합니다.

참고

고대비 모드(HCF_HIGHCONTRASTON)를 전환할 때는 HCF_OPTION_NOTHEMECHANGE 플래그를 사용하면 안 됩니다.

lpszDefaultScheme

형식: LPTSTR

기본 구성표로 설정될 색 구성표의 이름을 포함하는 문자열을 가리킵니다. 시스템은 이 버퍼를 할당하고 LocalFree를 사용하여 버퍼를 해제합니다.

설명

애플리케이션은 SPI_GETHIGHCONTRAST 또는 SPI_SETHIGHCONTRAST 값으로SystemParametersInfoW 함수를 호출할 때 이 구조를 사용합니다. SPI_GETHIGHCONTRAST 사용하는 경우 애플리케이션은 HIGHCONTRAST 구조체의 cbSize 멤버를 지정해야 합니다. SystemParametersInfo 함수는 나머지 멤버를 채웁니다. 애플리케이션은 SPI_SETHIGHCONTRAST 값을 사용할 때 모든 구조체 멤버를 지정해야 합니다.

참고

winuser.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 HIGHCONTRAST를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
머리글 winuser.h(Windows.h 포함)

추가 정보

SystemParametersInfoW 함수, HIGHCONTRASTA 구조체, 접근성 구조체, SystemParametersInfo