DwmUpdateThumbnailProperties 함수(dwmapi.h)

아티클
08/23/2023

DWM(데스크톱 창 관리자) 썸네일의 속성을 업데이트.

구문

HRESULT DwmUpdateThumbnailProperties(
       HTHUMBNAIL                     hThumbnailId,
  [in] const DWM_THUMBNAIL_PROPERTIES *ptnProperties
);

매개 변수

hThumbnailId

업데이트할 DWM 축소판 그림에 대한 핸들입니다. Null 또는 잘못된 썸네일과 다른 프로세스가 소유한 썸네일은 반환 값이 E_INVALIDARG.

[in] ptnProperties

새 썸네일 속성을 포함하는 DWM_THUMBNAIL_PROPERTIES 구조체에 대한 포인터입니다.

반환 값

이 함수가 성공하면 S_OK 반환합니다. 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

DwmRegisterThumbnail 함수에서 만든 미리 보기 관계는 이 함수가 호출될 때까지 대상 창으로 렌더링되지 않습니다. 후속 호출은 제공된 속성에 따라 썸네일을 업데이트합니다.

예제

다음 예제에서는 데스크톱 썸네일을 등록하고 표시하는 방법을 보여 줍니다.


HRESULT UpdateDesktop(HWND hwnd)
{
	HRESULT hr = S_OK;

	// Register the thumbnail
	SIZE size = {100,100};
	HTHUMBNAIL thumbnail = NULL;

	hr = DwmRegisterThumbnail(hwnd, FindWindow(_T("Progman"), NULL), &size, &thumbnail);
	if (SUCCEEDED(hr))
	{
		// The destination rectangle size
		RECT dest = {0,50,100,150};

		// Set the thumbnail properties for use
		DWM_THUMBNAIL_PROPERTIES dskThumbProps;
		dskThumbProps.dwFlags = DWM_TNP_RECTDESTINATION | DWM_TNP_VISIBLE | DWM_TNP_SOURCECLIENTAREAONLY;

		// Use the window frame and client area
		dskThumbProps.fSourceClientAreaOnly = FALSE;
		dskThumbProps.fVisible = TRUE;
		dskThumbProps.opacity = (255 * 70)/100;
		dskThumbProps.rcDestination = dest;

		// Display the thumbnail
		hr = DwmUpdateThumbnailProperties(thumbnail,&dskThumbProps);
		if (SUCCEEDED(hr))
		{
			// ...
		}
	}
	return hr;	
}

요구 사항


지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	dwmapi.h
라이브러리	Dwmapi.lib
DLL	Dwmapi.dll