DWMWINDOWATTRIBUTE 열거형(dwmapi.h)
DwmGetWindowAttribute 및 DwmSetWindowAttribute 함수에서 사용하는 옵션입니다.
통사론
typedef enum DWMWINDOWATTRIBUTE {
DWMWA_NCRENDERING_ENABLED,
DWMWA_NCRENDERING_POLICY,
DWMWA_TRANSITIONS_FORCEDISABLED,
DWMWA_ALLOW_NCPAINT,
DWMWA_CAPTION_BUTTON_BOUNDS,
DWMWA_NONCLIENT_RTL_LAYOUT,
DWMWA_FORCE_ICONIC_REPRESENTATION,
DWMWA_FLIP3D_POLICY,
DWMWA_EXTENDED_FRAME_BOUNDS,
DWMWA_HAS_ICONIC_BITMAP,
DWMWA_DISALLOW_PEEK,
DWMWA_EXCLUDED_FROM_PEEK,
DWMWA_CLOAK,
DWMWA_CLOAKED,
DWMWA_FREEZE_REPRESENTATION,
DWMWA_PASSIVE_UPDATE_MODE,
DWMWA_USE_HOSTBACKDROPBRUSH,
DWMWA_USE_IMMERSIVE_DARK_MODE = 20,
DWMWA_WINDOW_CORNER_PREFERENCE = 33,
DWMWA_BORDER_COLOR,
DWMWA_CAPTION_COLOR,
DWMWA_TEXT_COLOR,
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS,
DWMWA_SYSTEMBACKDROP_TYPE,
DWMWA_LAST
} ;
상수
DWMWA_NCRENDERING_ENABLED중요하다
DWMWA_NCRENDERING_ENABLED 값은 1입니다. |
DWMWA_NCRENDERING_POLICYDwmSetWindowAttribute함께 사용합니다. 비 클라이언트 렌더링 정책을 설정합니다. pvAttribute 매개 변수는 DWMNCRENDERINGPOLICY 열거형의 값을 가리킵니다. |
DWMWA_TRANSITIONS_FORCEDISABLEDDwmSetWindowAttribute함께 사용합니다. DWM 전환을 사용하거나 강제로 사용하지 않도록 설정합니다. |
DWMWA_ALLOW_NCPAINTDwmSetWindowAttribute함께 사용합니다. 비 클라이언트 영역에서 렌더링된 콘텐츠를 DWM에서 그린 프레임에 표시할 수 있도록 합니다. |
DWMWA_CAPTION_BUTTON_BOUNDSDwmGetWindowAttribute함께 사용합니다. 창 상대 공간에서 캡션 단추 영역의 범위를 검색합니다. 검색된 값은 RECT |
DWMWA_NONCLIENT_RTL_LAYOUTDwmSetWindowAttribute함께 사용합니다. 클라이언트가 아닌 콘텐츠가 RTL(오른쪽에서 왼쪽으로) 미러링되는지 여부를 지정합니다. |
DWMWA_FORCE_ICONIC_REPRESENTATIONDwmSetWindowAttribute함께 사용합니다. 창의 라이브 또는 스냅샷 표현을 사용할 수 있는 경우에도 창이 아이콘 썸네일 또는 피킹 표현(정적 비트맵)을 표시하도록 합니다. 이 값은 일반적으로 창을 만드는 동안 설정되며 창의 수명 동안 변경되지 않습니다. 그러나 일부 시나리오에서는 시간이 지남에 따라 값을 변경해야 할 수 있습니다. |
DWMWA_FLIP3D_POLICYDwmSetWindowAttribute함께 사용합니다. Flip3D에서 창을 처리하는 방법을 설정합니다. pvAttribute 매개 변수는 DWMFLIP3DWINDOWPOLICY 열거형의 값을 가리킵니다. |
DWMWA_EXTENDED_FRAME_BOUNDSDwmGetWindowAttribute함께 사용합니다. 화면 공간에서 확장된 프레임 범위 사각형을 검색합니다. 검색된 값은 RECT |
DWMWA_HAS_ICONIC_BITMAPDwmSetWindowAttribute함께 사용합니다. 창은 DWM에서 아이콘 썸네일로 사용하거나 창에 대한 피킹 표현(정적 비트맵)으로 사용할 비트맵을 제공합니다. DWMWA_FORCE_ICONIC_REPRESENTATION사용하여 DWMWA_HAS_ICONIC_BITMAP 지정할 수 있습니다. DWMWA_HAS_ICONIC_BITMAP 일반적으로 창을 만드는 동안 설정되며 창의 수명 동안 변경되지 않습니다. 그러나 일부 시나리오에서는 시간이 지남에 따라 값을 변경해야 할 수 있습니다. Windows Vista 및 이전 버전: 이 값은 지원되지 않습니다. |
DWMWA_DISALLOW_PEEKDwmSetWindowAttribute함께 사용합니다. 창에 대한 미리 보기 미리 보기를 표시하지 마세요. 미리 보기는 마우스가 작업 표시줄에서 창의 축소판 그림 위로 마우스를 가져가면 창의 전체 크기 미리 보기를 보여 줍니다. 이 특성을 설정하면 창의 축소판 그림 위로 마우스 포인터를 가리키면 피킹이 해제됩니다(그룹의 다른 창에 미리 보기가 표시되는 경우). Windows Vista 및 이전 버전: 이 값은 지원되지 않습니다. |
DWMWA_EXCLUDED_FROM_PEEKDwmSetWindowAttribute함께 사용합니다. 피킹이 호출될 때 창이 유리 시트로 페이드되는 것을 방지합니다. Windows Vista 및 이전 버전: 이 값은 지원되지 않습니다. |
DWMWA_CLOAKDwmSetWindowAttribute함께 사용합니다. 사용자에게 표시되지 않도록 창을 숨깁니다. 창은 여전히 DWM으로 구성됩니다. DirectComposition 사용: 계층화된 자식 창과 연결된 DirectComposition 시각적 개체를 통해 창 콘텐츠의 표현에 애니메이션 효과를 주는 경우 DWMWA_CLOAK 플래그를 사용하여 계층화된 자식 창을 숨깁니다. 이 사용 사례에 대한 자세한 내용은 계층화된 자식 창비트맵에 애니메이션 효과를 적용하는 방법을 참조하세요. Windows 7 이전 버전: 이 값은 지원되지 않습니다. |
DWMWA_CLOAKEDDwmGetWindowAttribute함께 사용합니다. 창이 은폐된 경우 이유를 설명하는 다음 값 중 하나를 제공합니다. DWM_CLOAKED_APP(값 0x00000001). 창이 소유자 애플리케이션에 의해 은폐되었습니다. DWM_CLOAKED_SHELL(값 0x00000002). 창이 셸에 의해 은폐되었습니다. DWM_CLOAKED_INHERITED(값 0x00000004). 망토 값은 소유자 창에서 상속되었습니다. Windows 7 이전 버전: 이 값은 지원되지 않습니다. |
DWMWA_FREEZE_REPRESENTATIONDwmSetWindowAttribute함께 사용합니다. 창의 썸네일 이미지를 현재 시각적 개체로 고정합니다. 썸네일 이미지에서 창 내용과 일치하도록 더 이상 라이브 업데이트를 수행하지 않습니다. Windows 7 이전 버전: 이 값은 지원되지 않습니다. |
DWMWA_USE_HOSTBACKDROPBRUSHDwmSetWindowAttribute함께 사용합니다. UWP가 아닌 창에서 호스트 배경 브러시를 사용하도록 설정합니다. 이 플래그가 설정된 경우 windows::UI::Composition API를 이 값은 Windows 11 빌드 22000부터 지원됩니다. |
DWMWA_USE_IMMERSIVE_DARK_MODEDwmSetWindowAttribute함께 사용합니다. 어두운 모드 시스템 설정을 사용할 때 이 창의 창 프레임을 어두운 모드 색으로 그릴 수 있습니다. 호환성을 위해 모든 창은 시스템 설정에 관계없이 기본 모드로 설정됩니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다. |
DWMWA_WINDOW_CORNER_PREFERENCEDwmSetWindowAttribute함께 사용합니다. 창의 둥근 모서리 기본 설정을 지정합니다. pvAttribute 매개 변수는 DWM_WINDOW_CORNER_PREFERENCE형식의 값을 가리킵니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다. |
DWMWA_BORDER_COLORDwmSetWindowAttribute함께 사용합니다. 창 테두리의 색을 지정합니다. 색에 대한 DWMWA_COLOR_NONE(값 0xFFFFFFFE)를 지정하면 창 테두리의 그리기를 표시하지 않습니다. 이렇게 하면 테두리가 없는 둥근 창을 사용할 수 있습니다. 색에 대한 DWMWA_COLOR_DEFAULT(값 0xFFFFFFFF)를 지정하면 테두리 색에 대한 시스템의 기본 동작을 사용하여 창을 다시 설정합니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다. |
DWMWA_CAPTION_COLORDwmSetWindowAttribute함께 사용합니다. 캡션의 색을 지정합니다. 색에 대한 DWMWA_COLOR_DEFAULT(값 0xFFFFFFFF)를 지정하면 캡션 색에 대한 시스템의 기본 동작을 사용하여 창을 다시 설정합니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다. |
DWMWA_TEXT_COLORDwmSetWindowAttribute함께 사용합니다. 캡션 텍스트의 색을 지정합니다. 색에 대한 DWMWA_COLOR_DEFAULT(값 0xFFFFFFFF)를 지정하면 캡션 텍스트 색에 대한 시스템의 기본 동작을 사용하여 창이 다시 설정됩니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다. |
DWMWA_VISIBLE_FRAME_BORDER_THICKNESSDwmGetWindowAttribute함께 사용합니다. DWM이 이 창 주위에 그릴 바깥 테두리의 너비를 검색합니다. 값은 창의 DPI에 따라 달라질 수 있습니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다. |
DWMWA_SYSTEMBACKDROP_TYPE이 값은 Windows 11 빌드 22621부터 지원됩니다. |
DWMWA_LAST유효성 검사를 위해 사용되는 최대 인식 DWMWINDOWATTRIBUTE 값입니다. |
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 헤더 | dwmapi.h |