this program<\/a> because it’s useful on its own. It simply creates a 32bpp bitmap of the desired size and optionally returns a pointer to the resulting bits.<\/p>\nHBITMAP Create32bppBitmap(HDC hdc, int cx, int cy, <\/span>\r\n RGBQUAD **pprgbBits = nullptr) <\/span>\r\n{ <\/span>\r\n BITMAPINFO bmi = { 0 }; <\/span>\r\n bmi.bmiHeader.biSize = sizeof(bmi.bmiHeader); <\/span>\r\n bmi.bmiHeader.biWidth = cx; <\/span>\r\n bmi.bmiHeader.biHeight = cy; <\/span>\r\n bmi.bmiHeader.biPlanes = 1; <\/span>\r\n bmi.bmiHeader.biBitCount = 32; <\/span>\r\n bmi.bmiHeader.biCompression = BI_RGB; <\/span>\r\n void *pvBits; <\/span>\r\n HBITMAP hbm = CreateDIBSection(hdc, &bmi, <\/span>\r\n DIB_RGB_COLORS, &pvBits, NULL, 0); <\/span>\r\n if (pprgbBits) *pprgbBits = static_cast<RGBQUAD*>(pvBits);<\/span>\r\n return hbm; <\/span>\r\n} <\/span>\r\n<\/pre>\nNext, we take our Paint\u00adContent<\/code> function and make it render into a DC instead:<\/p>\nvoid\r\nRenderContent(HDC hdc, LPCRECT prc)<\/span>\r\n{\r\n LOGFONTW lf = { 0 };\r\n lf.lfHeight = prc-><\/span>bottom - prc-><\/span>top;\r\n wcscpy_s(lf.lfFaceName, L\"Verdana\");\r\n HFONT hf = CreateFontIndirectW(&lf);\r\n HFONT hfPrev = SelectFont(hdc<\/span>, hf);\r\n wchar_t wszCount[80];\r\n swprintf_s(wszCount, L\"%d\", g_iCounter);\r\n FillRect(hdc, prc, GetStockBrush(WHITE_BRUSH));<\/span>\r\n DrawTextW(hdc<\/span>, wszCount, -1, const_cast<LPRECT>(prc),\r\n DT_CENTER | DT_VCENTER | DT_SINGLELINE);\r\n SelectFont(hdc<\/span>, hfPrev);\r\n DeleteObject(hf);\r\n}\r\n<\/pre>\nIn our case, we will want to render into a bitmap:<\/p>\n
HBITMAP <\/span>\r\nGenerateContentBitmap(HWND hwnd, int cx, int cy)<\/span>\r\n{ <\/span>\r\n HDC hdc = GetDC(hwnd); <\/span>\r\n HDC hdcMem = CreateCompatibleDC(hdc); <\/span>\r\n HBITMAP hbm = Create32bppBitmap(hdcMem, cx,cy);<\/span>\r\n HBITMAP hbmPrev = SelectBitmap(hdcMem, hbm); <\/span>\r\n RECT rc = { 0, 0, cx, cy }; <\/span>\r\n RenderContent(hdcMem, &rc); <\/span>\r\n SelectBitmap(hdcMem, hbmPrev); <\/span>\r\n DeleteDC(hdcMem); <\/span>\r\n ReleaseDC(hwnd, hdc); <\/span>\r\n return hbm; <\/span>\r\n} <\/span>\r\n<\/pre>\nWe can use this function when DWM asks us to generate a custom thumbnail or a custom live preview bitmap.<\/p>\n
void\r\nUpdateThumbnailBitmap(HWND hwnd, int cx, int cy) <\/span>\r\n{ <\/span>\r\n HBITMAP hbm = GenerateContentBitmap(hwnd, cx, cy); <\/span>\r\n DwmSetIconicThumbnail(hwnd, hbm, 0); <\/span>\r\n DeleteObject(hbm); <\/span>\r\n} <\/span>\r\n\u00a0 <\/span>\r\nvoid <\/span>\r\nUpdateLivePreviewBitmap(HWND hwnd) <\/span>\r\n{ <\/span>\r\n RECT rc; <\/span>\r\n GetClientRect(hwnd, &rc); <\/span>\r\n HBITMAP hbm = GenerateContentBitmap(hwnd, rc.right - rc.left,<\/span>\r\n rc.bottom - rc.top); <\/span>\r\n DwmSetIconicLivePreviewBitmap(hwnd, hbm, nullptr, 0); <\/span>\r\n DeleteObject(hbm); <\/span>\r\n} <\/span>\r\n\r\n \/\/ WndProc\r\n case WM_DWMSENDICONICTHUMBNAIL: <\/span>\r\n UpdateThumbnailBitmap(hwnd, HIWORD(lParam), LOWORD(lParam));<\/span>\r\n break; <\/span>\r\n case WM_DWMSENDICONICLIVEPREVIEWBITMAP: <\/span>\r\n UpdateLivePreviewBitmap(hwnd); <\/span>\r\n break; <\/span>\r\n<\/pre>\nOne of the quirks of the WM_DWM\u00adSEND\u00adICONIC\u00adTHUMB\u00adNAIL<\/code> message is that it passes the x- and y-coordinates backwards. Most window messages put the x-coordinate in the low word and the y-coordinate in the high word, but WM_DWM\u00adSEND\u00adICONIC\u00adTHUMB\u00adNAIL<\/code> does it the other way around.<\/p>\nSince we’re generating a custom thumbnail and live preview bitmap, we need to let the window manager know that the custom rendering is out of date and needs to be re-rendered: Invalidate the custom bitmaps when the counter changes.<\/p>\n
void OnCommand(HWND hwnd, int id, HWND hwndCtl, UINT codeNotify)\r\n{\r\n switch (id) {\r\n case IDC_INCREMENT:\r\n ++g_iCounter;\r\n InvalidateRect(hwnd, nullptr, TRUE);\r\n DwmInvalidateIconicBitmaps(hwnd);<\/span>\r\n break;\r\n }\r\n}\r\n<\/pre>\nAnd finally, just to be interesting, we’ll also stop rendering content into our main window.<\/p>\n
void\r\nPaintContent(HWND hwnd, PAINTSTRUCT *pps)\r\n{\r\n \/\/ do nothing<\/span>\r\n}\r\n<\/pre>\nRun this program and observe that the window comes up blank. Ah, but if you hover over the taskbar button, the custom thumbnail will appear, and that custom thumbnail has the number 0 in it. Click on the button in the thumbnail, and the number in the custom thumbnail increments.<\/p>\n
As a bonus, move the mouse over the thumbnail to trigger Aero Peek. The live preview bitmap contains the magic number! Move the mouse away, and the magic number vanishes.<\/p>\n
Now, this was an artificial example, so the effect is kind of weird. However, you can imagine using this in less artificial cases where the result is useful. You application might be a game, and instead of using the default thumbnail which shows a miniature copy of the game window, you can have your thumbnail be a tiny scoreboard or focus on a section of the board. For example, if you are a card game, the thumbnail might show just the cards in your hand.<\/p>\n
I can’t think of a useful case for showing a live preview bitmap different from the actual window. The intended use for a custom live preview bitmap is for applications like Web browsers which want to minimize a tab’s memory usage when it is not active. When a tab becomes inactive, the browser can destroy all graphics resources except for a bitmap containing the last-known-valid contents of the window, and use that bitmap for the thumbnail and live preview.<\/p>\n","protected":false},"excerpt":{"rendered":"
Mini-me.<\/p>\n","protected":false},"author":1069,"featured_media":111744,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[25],"class_list":["post-5153","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
Mini-me.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/5153","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/users\/1069"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/comments?post=5153"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/5153\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media\/111744"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/media?parent=5153"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=5153"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=5153"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}