다음을 통해 공유


SetDialogDpiChangeBehavior 함수(winuser.h)

모니터별 v2 컨텍스트의 대화 상자는 자동으로 DPI 크기가 조정됩니다. 이 메서드를 사용하면 DPI 변경 동작을 사용자 지정할 수 있습니다.

이 함수는 대화 상자의 기본 DPI 크기 조정 동작을 재정의하기 위해 DIALOG_DPI_CHANGE_BEHAVIORS 열거형과 함께 작동합니다. 이 함수는 지정된 플래그가 개별적으로 저장되는 지정된 대화 상자에서 호출됩니다.

이 함수는 SetDialogControlDpiChangeBehavior를 사용하여 수행되는 해당 대화 상자의 자식 창에 대한 DPI 크기 조정 동작에 영향을 주지 않습니다.

구문

BOOL SetDialogDpiChangeBehavior(
  HWND                        hDlg,
  DIALOG_DPI_CHANGE_BEHAVIORS mask,
  DIALOG_DPI_CHANGE_BEHAVIORS values
);

매개 변수

hDlg

동작이 수정될 대화 상자의 핸들입니다.

mask

변경할 플래그의 하위 집합을 지정하는 마스크입니다.

values

지정된 플래그 하위 집합에 대해 설정할 원하는 값입니다.

반환 값

이 함수는 작업이 성공하면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

잘못된 대화 상자 HWND를 전달하면 오류가 ERROR_INVALID_HANDLE 대화 상자가 다른 프로세스에 속하는지 ERROR_ACCESS_DENIED 수 있습니다.

설명

확장성을 위해 DIALOG_DPI_CHANGE_BEHAVIORS 별도의 동작을 나타내는 비트 플래그 집합으로 모델링되었습니다. 이 함수는 일반적인 두 매개 변수 접근 방식을 따라 플래그를 설정합니다. 여기서 마스크는 변경할 플래그의 하위 집합을 지정합니다.

Per Monitor v2 컨텍스트 외부에서 이 API를 호출하는 것은 오류가 아니지만 플래그는 컨텍스트가 Per Monitor v2로 변경될 때까지 지정된 대화 상자의 동작에 영향을 주지 않습니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 10, 버전 1703 [데스크톱 앱만 해당]
지원되는 최소 서버 Windows Server 2016 [데스크톱 앱만 해당]
대상 플랫폼 Windows
헤더 winuser.h
라이브러리 User32.lib
DLL User32.dll

추가 정보

DIALOG_DPI_CHANGE_BEHAVIORS

GetDialogDpiChangeBehavior