\nToday’s Little Program will show a property sheet that covers multiple\nfiles,\njust like the one you get from Explorer if you multi-select a bunch\nof files and right-click them all then select Properties<\/I>.\n<\/P>\n
\nIn fact, that description of how you do the operation interactively\nmaps directly to how you do the operation programmatically!\n<\/P>\n
\n#define UNICODE\n#define _UNICODE<\/A>\n#define STRICT_TYPED_ITEMIDS<\/A>\n#include <windows.h>\n#include <ole2.h>\n#include <shlobj.h>\n#include <atlbase.h>\n#include <atlalloc.h><\/p>\nHRESULT GetUIObjectOf(\n IShellFolder *psf,\n HWND hwndOwner,\n UINT cidl,\n PCUITEMID_CHILD_ARRAY apidl, REFIID riid, void **ppv)\n{\n return psf->GetUIObjectOf(hwndOwner, cidl, apidl, riid, nullptr, ppv);\n}\n<\/PRE>\n
\nThe
GetUIObjectOf<\/CODE> helper function\nmerely wraps the\nIShellFolder::GetUIObjectOf<\/CODE>\nmethod to insert the peskynullptr<\/CODE> parameter\nbetween theriid<\/CODE> andppv<\/CODE>.\nTheriid<\/CODE> andppv<\/CODE> parameters\nby convention go right next to each other,\nand theIID_PPV_ARGS<\/CODE> macro assumes\nthat the function you’re calling follows that convention.\nUnfortunately, the people who designed\nIShellFolder::GetUIObjectOf<\/CODE>\ndidn’t get the memo, and we’ve been stuck with it ever since.\n<\/P>\n\nHRESULT InvokeCommandByVerb(\n IContextMenu *pcm,\n HWND hwnd,\n LPCSTR pszVerb)\n{\n HMENU hmenu = CreatePopupMenu();\n HRESULT hr = hmenu ? S_OK : E_OUTOFMEMORY;\n if (SUCCEEDED(hr)) {\n hr = pcm->QueryContextMenu(hmenu, 0, 1, 0x7FFF, CMF_NORMAL);\n if (SUCCEEDED(hr)) {\n CMINVOKECOMMANDINFO info = { 0 };\n info.cbSize = sizeof(info);\n info.hwnd = hwnd;\n info.lpVerb = pszVerb;\n hr = pcm->InvokeCommand(&info);\n }\n DestroyMenu(hmenu);\n }\n return hr;\n}\n<\/PRE>\n\nThe
InvokeCommandByVerb<\/CODE> function\nmerely\n\nhosts anIContextMenu<\/CODE> and invokes a single verb<\/A>.\n<\/P>\n\nOkay, those are the only two helper functions we need this week.\nThe rest we can steal from earlier articles.\n<\/P>\n
\nFor the purpose of illustration,\nthe program will display a multi-file property sheet for the first\ntwo files in your\nMy Documents folder folder.\nRemember, Little Programs do little to no error checking.\n<\/P>\n
\nint __cdecl wmain(int, wchar_t **)\n{\n CCoInitialize<\/A> init;\n ProcessReference<\/A> ref;\n CComPtr<IShellFolder> spsf;\n BindToCsidl<\/A>(CSIDL_MYDOCUMENTS, IID_PPV_ARGS(&spsf));\n CComPtr<IEnumIDList> speidl;\n spsf->EnumObjects(nullptr, SHCONTF_NONFOLDERS, &speidl);\n if (!speidl) return 0;\n CComHeapPtr<ITEMID_CHILD> spidl1;\n CComHeapPtr<ITEMID_CHILD> spidl2;\n if (speidl->Next(1, &spidl1, nullptr) != S_OK) return 0;\n if (speidl->Next(1, &spidl2, nullptr) != S_OK) return 0;\n PCUITEMID_CHILD rgpidl[2] = { spidl1, spidl2 };\n CComPtr<IContextMenu> spcm;\n GetUIObjectOf(spsf, nullptr, 2, rgpidl, IID_PPV_ARGS(&spcm));\n if (!spcm) return 0;\n InvokeCommandByVerb(spcm, “properties”);\n return 0;\n}\n<\/PRE>\n\nBecause everybody freaks out if I write code that doesn’t\nrun on Windows XP,\nI used the\n
BindToCSIDL<\/CODE> function\ninstead of one of its more modern equivalents\nto get access to the My Documents folder.\n<\/P>\n\nOnce we have My Documents,\nwe ask to enumerate its non-folders.\nIf the enumeration fails or says that there are no items (by returning\n
S_FALSE<\/CODE>), then we bail immediately.\n<\/P>\n\nNext, we enumerate two items from the folder.\nIf we can’t get both, then we bail.\n<\/P>\n
\nWe then create a two-item array and\nget the
IContextMenu<\/CODE> UI object\nfor the collection.\n<\/P>\n\nFinally, we invoke the
“properties”<\/CODE> verb on the context menu.\n<\/P>\n\nAnd that’s it.\nIf you run this program, you’ll see a context menu for the first\ntwo files in your My Documents folder.\n<\/P><\/p>\n","protected":false},"excerpt":{"rendered":"
Today’s Little Program will show a property sheet that covers multiple files, just like the one you get from Explorer if you multi-select a bunch of files and right-click them all then select Properties. In fact, that description of how you do the operation interactively maps directly to how you do the operation programmatically! #define […]<\/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-4073","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
Today’s Little Program will show a property sheet that covers multiple files, just like the one you get from Explorer if you multi-select a bunch of files and right-click them all then select Properties. In fact, that description of how you do the operation interactively maps directly to how you do the operation programmatically! #define […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/4073","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=4073"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/4073\/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=4073"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=4073"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=4073"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}