DWMWINDOWATTRIBUTE 열거형(dwmapi.h)

DwmGetWindowAttribute 및 DwmSetWindowAttribute 함수에서 사용하는 옵션입니다.

Syntax

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 DwmGetWindowAttribute와 함께 사용합니다. 비 클라이언트 렌더링을 사용할 수 있는지 여부를 검색합니다. 검색된 값은 BOOL 형식입니다. 클라이언트 가 아닌 렌더링을 사용하도록 설정하면 TRUE이고, 그렇지 않으면 FALSE입니다.
DWMWA_NCRENDERING_POLICY DwmSetWindowAttribute와 함께 사용합니다. 비 클라이언트 렌더링 정책을 설정합니다. pvAttribute 매개 변수는 DWMNCRENDERINGPOLICY 열거형의 값을 가리킵니다.
DWMWA_TRANSITIONS_FORCEDISABLED DwmSetWindowAttribute와 함께 사용합니다. DWM 전환을 사용하거나 강제로 사용하지 않도록 설정합니다. pvAttribute 매개 변수는 BOOL 형식의 값을 가리킵니다. TRUE 이면 전환을 사용하지 않도록 설정하거나 FALSE 를 사용하여 전환을 사용하도록 설정합니다.
DWMWA_ALLOW_NCPAINT DwmSetWindowAttribute와 함께 사용합니다. 비 클라이언트 영역에서 렌더링된 콘텐츠를 DWM에서 그린 프레임에 표시할 수 있도록 합니다. pvAttribute 매개 변수는 BOOL 형식의 값을 가리킵니다. TRUE 이면 클라이언트가 아닌 영역에서 렌더링된 콘텐츠를 프레임에 표시할 수 있습니다. 그렇지 않으면 FALSE입니다.
DWMWA_CAPTION_BUTTON_BOUNDS DwmGetWindowAttribute와 함께 사용합니다. 창 상대 공간에서 캡션 단추 영역의 범위를 검색합니다. 검색된 값은 RECT 형식입니다. 창을 최소화하거나 사용자에게 표시되지 않으면 검색된 RECT 의 값이 정의되지 않습니다. 검색된 RECT에 작업할 수 있는 경계가 포함되어 있는지 여부를 검사, 그렇지 않으면 창이 최소화되었거나 표시되지 않는다고 결론을 내릴 수 있습니다.
DWMWA_NONCLIENT_RTL_LAYOUT DwmSetWindowAttribute와 함께 사용합니다. 비 클라이언트 콘텐츠가 RTL(오른쪽에서 왼쪽으로) 미러링되는지 여부를 지정합니다. pvAttribute 매개 변수는 BOOL 형식의 값을 가리킵니다. 비 클라이언트 콘텐츠가 RTL(오른쪽에서 왼쪽으로) 미러된 경우 TRUE이고, 그렇지 않으면 FALSE입니다.
DWMWA_FORCE_ICONIC_REPRESENTATION DwmSetWindowAttribute와 함께 사용합니다. 창의 라이브 또는 스냅샷 표현을 사용할 수 있더라도 창을 강제로 아이콘 축소판 그림 또는 피킹 표현(정적 비트맵)으로 표시합니다. 이 값은 일반적으로 창을 만드는 동안 설정되며 창의 수명 동안 변경되지 않습니다. 그러나 일부 시나리오에서는 시간이 지남에 따라 값을 변경해야 할 수 있습니다. pvAttribute 매개 변수는 BOOL 형식의 값을 가리킵니다. TRUE 이면 상징적인 썸네일 또는 피킹 표현이 필요합니다. 그렇지 않으면 FALSE입니다.
DWMWA_FLIP3D_POLICY DwmSetWindowAttribute와 함께 사용합니다. Flip3D에서 창을 처리하는 방법을 설정합니다. pvAttribute 매개 변수는 DWMFLIP3DWINDOWPOLICY 열거형의 값을 가리킵니다.
DWMWA_EXTENDED_FRAME_BOUNDS DwmGetWindowAttribute와 함께 사용합니다. 화면 공간에서 확장된 프레임 범위 사각형을 검색합니다. 검색된 값은 RECT 형식입니다.
DWMWA_HAS_ICONIC_BITMAP DwmSetWindowAttribute와 함께 사용합니다. 창은 DWM에서 아이콘 썸네일로 사용하거나 창에 대한 피킹 표현(정적 비트맵)으로 사용할 비트맵을 제공합니다. DWMWA_FORCE_ICONIC_REPRESENTATION 사용하여DWMWA_HAS_ICONIC_BITMAP 지정할 수 있습니다. DWMWA_HAS_ICONIC_BITMAP 일반적으로 창을 만드는 동안 설정되며 창의 수명 동안 변경되지 않습니다. 그러나 일부 시나리오에서는 시간이 지남에 따라 값을 변경해야 할 수 있습니다. pvAttribute 매개 변수는 BOOL 형식의 값을 가리킵니다. TRUE 이면 창이 상징적인 썸네일 또는 피킹 표현을 제공할 것임을 DWM에 알립니다. 그렇지 않으면 FALSE입니다. Windows Vista 및 이전 버전: 이 값은 지원되지 않습니다.
DWMWA_DISALLOW_PEEK DwmSetWindowAttribute와 함께 사용합니다. 창에 대한 미리 보기 미리 보기를 표시하지 마세요. 피킹 보기는 마우스가 작업 표시줄의 창 축소판 그림 위로 마우스를 가져가면 창의 전체 크기 미리 보기를 표시합니다. 이 특성을 설정하면 창의 축소판 그림 위로 마우스 포인터를 가리키면 피킹이 해제됩니다(그룹의 다른 창에 미리 보기가 표시되는 경우). pvAttribute 매개 변수는 BOOL 형식의 값을 가리킵니다. 피 킹 기능을 방지하려면 TRUE, 허용하려면 FALSE 입니다. Windows Vista 및 이전 버전: 이 값은 지원되지 않습니다.
DWMWA_EXCLUDED_FROM_PEEK DwmSetWindowAttribute와 함께 사용합니다. 피킹이 호출될 때 창이 유리 시트로 페이드되는 것을 방지합니다. pvAttribute 매개 변수는 BOOL 형식의 값을 가리킵니다. TRUE 이면 다른 창이 피킹하는 동안 창이 퇴색하지 않도록 하거나 일반적인 동작의 경우 FALSE 입니다. Windows Vista 및 이전 버전: 이 값은 지원되지 않습니다.
DWMWA_CLOAK DwmSetWindowAttribute와 함께 사용합니다. 창이 사용자에게 표시되지 않도록 창을 은폐합니다. 창은 여전히 DWM으로 구성됩니다. DirectComposition과 함께 사용: 계층화된 자식 창과 연결된 DirectComposition 시각적 개체를 통해 창 콘텐츠의 표현에 애니메이션 효과를 주는 경우 DWMWA_CLOAK 플래그를 사용하여 계층화된 자식 창을 은폐합니다. 이 사용 사례에 대한 자세한 내용은 계층화된 자식 창의 비트맵에 애니메이션 효과를 주는 방법을 참조하세요. Windows 7 이하: 이 값은 지원되지 않습니다.
DWMWA_CLOAKED DwmGetWindowAttribute와 함께 사용합니다. 창이 은폐된 경우 이유를 설명하는 다음 값 중 하나를 제공합니다. DWM_CLOAKED_APP (값 0x00000001). 창이 소유자 애플리케이션에 의해 은폐되었습니다. DWM_CLOAKED_SHELL (값 0x00000002). 창이 셸에 의해 은폐되었습니다. DWM_CLOAKED_INHERITED (값 0x00000004). 망토 값은 소유자 창에서 상속되었습니다. Windows 7 이하: 이 값은 지원되지 않습니다.
DWMWA_FREEZE_REPRESENTATION DwmSetWindowAttribute와 함께 사용합니다. 창의 썸네일 이미지를 현재 시각적 개체로 고정합니다. 썸네일 이미지에서 창 내용과 일치하도록 라이브 업데이트를 더 이상 수행하지 않습니다. Windows 7 이하: 이 값은 지원되지 않습니다.
DWMWA_USE_HOSTBACKDROPBRUSH DwmSetWindowAttribute와 함께 사용합니다. UWP가 아닌 창에서 호스트 배경 브러시를 사용하도록 설정합니다. 이 플래그가 설정된 경우 Windows::UI::Composition API를 호출하는 Win32 앱은 호스트 배경 브러시를 사용하여 투명도 효과를 빌드할 수 있습니다( Compositor.CreateHostBackdropBrush 참조). pvAttribute 매개 변수는 BOOL 형식의 값을 가리킵니다. TRUE 이면 창에 호스트 배경 브러시를 사용하거나 FALSE 를 사용하여 사용하지 않도록 설정합니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다.
DWMWA_USE_IMMERSIVE_DARK_MODE DwmSetWindowAttribute와 함께 사용합니다. 어두운 모드 시스템 설정을 사용할 때 이 창의 창 프레임을 어두운 모드 색으로 그릴 수 있습니다. 호환성을 위해 모든 창은 시스템 설정에 관계없이 기본 모드로 설정됩니다. pvAttribute 매개 변수는 BOOL 형식의 값을 가리킵니다. TRUE 이면 창의 어두운 모드를 적용하고 FALSE 는 항상 광원 모드를 사용합니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다.
DWMWA_WINDOW_CORNER_PREFERENCE DwmSetWindowAttribute와 함께 사용합니다. 창의 둥근 모서리 기본 설정을 지정합니다. pvAttribute 매개 변수는 DWM_WINDOW_CORNER_PREFERENCE 형식의 값을 가리킵니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다.
DWMWA_BORDER_COLOR DwmSetWindowAttribute와 함께 사용합니다. 창 테두리의 색을 지정합니다. pvAttribute 매개 변수는 COLORREF 형식의 값을 가리킵니다. 앱은 창 활성화 변경과 같은 상태 변경에 따라 테두리 색을 변경해야 합니다. 색에 대한 DWMWA_COLOR_NONE (값 0xFFFFFFFE)을 지정하면 창 테두리의 그리기를 표시하지 않습니다. 이렇게 하면 테두리가 없는 둥근 창을 가질 수 있습니다. 색에 대한 DWMWA_COLOR_DEFAULT (값 0xFFFFFFFF)을 지정하면 경계 색에 대한 시스템의 기본 동작을 사용하여 창이 다시 설정됩니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다.
DWMWA_CAPTION_COLOR DwmSetWindowAttribute와 함께 사용합니다. 캡션 색을 지정합니다. pvAttribute 매개 변수는 COLORREF 형식의 값을 가리킵니다. 색에 대한 DWMWA_COLOR_DEFAULT(값 0xFFFFFFFF)을 지정하면 캡션 색에 대한 시스템의 기본 동작을 사용하여 창이 다시 설정됩니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다.
DWMWA_TEXT_COLOR DwmSetWindowAttribute와 함께 사용합니다. 캡션 텍스트의 색을 지정합니다. pvAttribute 매개 변수는 COLORREF 형식의 값을 가리킵니다. 색에 대한 DWMWA_COLOR_DEFAULT(값 0xFFFFFFFF)을 지정하면 캡션 텍스트 색에 대한 시스템의 기본 동작을 사용하여 창이 다시 설정됩니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다.
DWMWA_VISIBLE_FRAME_BORDER_THICKNESS DwmGetWindowAttribute와 함께 사용합니다. DWM이 이 창 주위에 그릴 바깥 테두리의 너비를 검색합니다. 값은 창의 DPI에 따라 달라질 수 있습니다. pvAttribute 매개 변수는 UINT 형식의 값을 가리킵니다. 이 값은 Windows 11 빌드 22000부터 지원됩니다.
DWMWA_SYSTEMBACKDROP_TYPE DwmGetWindowAttribute 또는 DwmSetWindowAttribute와 함께 사용합니다. 클라이언트가 아닌 영역 뒤를 포함하여 창의 시스템 그리기 배경 자료를 검색하거나 지정합니다. pvAttribute 매개 변수는 DWM_SYSTEMBACKDROP_TYPE 형식의 값을 가리킵니다. 이 값은 Windows 11 빌드 22621부터 지원됩니다.
DWMWA_LAST 유효성 검사를 위해 사용되는 최대 인식 된 DWMWINDOWATTRIBUTE 값입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
머리글	dwmapi.h

추가 정보

• DwmGetWindowAttribute 함수
• DwmSetWindowAttribute 함수
• DWM 컴퍼지션 사용 및 제어