UPDATELAYEREDWINDOWINFO 구조체(winuser.h)

UpdateLayeredWindowIndirect에서 계층화된 창에 대한 위치, 크기, 모양, 콘텐츠 및 반투명 정보를 제공하는 데 사용됩니다.

구문

typedef struct tagUPDATELAYEREDWINDOWINFO {
  DWORD               cbSize;
  HDC                 hdcDst;
  const POINT         *pptDst;
  const SIZE          *psize;
  HDC                 hdcSrc;
  const POINT         *pptSrc;
  COLORREF            crKey;
  const BLENDFUNCTION *pblend;
  DWORD               dwFlags;
  const RECT          *prcDirty;
} UPDATELAYEREDWINDOWINFO, *PUPDATELAYEREDWINDOWINFO;

멤버

cbSize

형식:DWORD

이 구조체의 크기(바이트)입니다.

hdcDst

형식: HDC

화면의 DC에 대한 핸들입니다. 이 핸들은 UpdateLayeredWindowIndirect를 호출할 때 이 멤버에서 NULL을 지정하여 가져옵니다. 핸들은 창 내용이 업데이트되는 경우 색상표 색 일치에 사용됩니다. hdcDst가 NULL이면 기본 팔레트가 사용됩니다.

hdcSrc가 NULL인 경우 hdcDst는 NULL이어야 합니다.

pptDst

형식: const POINT*

계층화된 창의 새 화면 위치입니다. 새 위치가 현재 위치에서 변경되지 않은 경우 pptDst 는 NULL일 수 있습니다.

psize

형식: const SIZE*

계층화된 창의 새 크기입니다. 창의 크기가 변경되지 않으면 이 매개 변수는 NULL일 수 있습니다. hdcSrc가 NULL인 경우 psize는NULL이어야 합니다.

hdcSrc

형식: HDC

계층화된 창을 정의하는 표면의 DC에 대한 핸들입니다. 이 핸들은 CreateCompatibleDC 함수를 호출하여 가져올 수 있습니다. 창의 셰이프 및 시각적 컨텍스트가 변경되지 않으면 hdcSrc 는 NULL일 수 있습니다.

pptSrc

형식: const POINT*

디바이스 컨텍스트에서 계층의 위치입니다. hdcSrc가 NULL인 경우 pptSrc는 NULL이어야 합니다.

crKey

형식: COLORREF

계층화된 창을 작성할 때 사용할 색 키입니다. COLORREF를 생성하려면 RGB 매크로를 사용합니다.

pblend

형식: const BLENDFUNCTION*

계층화된 창을 작성할 때 사용할 투명도 값입니다.

dwFlags

형식:DWORD

이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
ULW_ALPHA 0x00000002	혼합 함수로 pblend 를 사용합니다. 디스플레이 모드가 256색 이하인 경우 이 값의 효과는 ULW_OPAQUE 효과와 동일합니다.
ULW_COLORKEY 0x00000001	투명도 색으로 crKey 를 사용합니다.
ULW_OPAQUE 0x00000004	불투명 계층화된 창을 그립니다.
ULW_EX_NORESIZE 0x00000008	현재 창 크기가 psize에 지정된 크기와 일치하지 않으면 UpdateLayeredWindowIndirect 함수가 강제로 실패합니다.

 

hdcSrc가 NULL이면 dwFlags는 0이어야 합니다.

prcDirty

형식: const RECT*

업데이트할 영역입니다. 이 매개 변수는 NULL일 수 있습니다. NULL이 아닌 경우 이 사각형의 영역만 원본 DC에서 업데이트됩니다.

요구 사항

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

추가 정보

개념

참조

UpdateLayeredWindow

창 기능