{"id":2303,"date":"2013-12-23T07:00:00","date_gmt":"2013-12-23T07:00:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/oldnewthing\/2013\/12\/23\/creating-custom-tasks-on-a-jump-list\/"},"modified":"2013-12-23T07:00:00","modified_gmt":"2013-12-23T07:00:00","slug":"creating-custom-tasks-on-a-jump-list","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20131223-00\/?p=2303","title":{"rendered":"Creating custom tasks on a jump list"},"content":{"rendered":"

\nToday’s Little Program adds a custom task to the application’s\njump list.\nTake the\n\nscratch program<\/a>\nand make the following changes.\n(Remember, Little Programs do very little error checking\nbecause that’s how they roll.)\n<\/p>\n

\n#include <shlobj.h>\n#include <propkey.h>\n#include <wrl\/client.h>\nusing namespace Microsoft::WRL;\nComPtr<IShellLink>\nCreateShellLinkForTask(\n    PCWSTR pszTitle,\n    PCTSTR pszArgs,\n    int idIcon)\n{\n    ComPtr<IShellLink> spsl;\n    CoCreateInstance(CLSID_ShellLink, nullptr, CLSCTX_ALL, IID_PPV_ARGS(&spsl));\n    wchar_t szBuf[MAX_PATH];\n    GetModuleFileName(g_hinst, szBuf, ARRAYSIZE(szBuf));\n    spsl->SetPath(szBuf);\n    spsl->SetArguments(pszArgs);\n    spsl->SetIconLocation(szBuf, idIcon);\n    PROPVARIANT pvar;\n    pvar.vt = VT_LPWSTR;\n    pvar.pwszVal = const_cast<PWSTR>(pszTitle);\n    ComPtr<IPropertyStore> spps;\n    spsl.As(&spps);\n    spps->SetValue(PKEY_Title, pvar);\n    spps->Commit();\n    return spsl;\n}<\/font>\n<\/pre>\n
\nThis helper function creates an\n\nin-memory shell link object<\/a>\nwith the specified title, command line arguments, and icon.\nThe underlying executable is assumed to be the running executable.\n<\/p>\n
\nBOOL\nOnCreate(HWND hwnd, LPCREATESTRUCT lpcs)\n{\n  ComPtr<ICustomDestinationList> spcdl;\n  CoCreateInstance(CLSID_DestinationList, nullptr, CLSCTX_ALL,\n                   IID_PPV_ARGS(&spcdl));\n  ComPtr<IObjectCollection> spoc;\n  UINT cMinSlots;\n  spcdl->BeginList(&cMinSlots, IID_PPV_ARGS(&spoc));\n  spoc->Clear();\n  spoc->AddObject(CreateShellLinkForTask(L\"New frob\",\n                   TEXT(\"\/frob\"), -2).Get());\n  spcdl->AddUserTasks(spoc.Get());\n  spcdl->CommitList();<\/font>\n  return TRUE;\n}\n<\/pre>\n
\nWhen our window is created,\nwe get the destination list for our application\nand ask it for an object collection so we can fill it with tasks.\nWe empty the existing collection and add a single shortcut\ncalled “New frob” and which passes the \/frob<\/code> command line\nargument.\nThe icon here is given as a negative number to indicate\n\nthat it is an icon ID rather than an icon index<\/a>.\nWe then tell the destination list that this is our new task collection.\n<\/p>\n
\nBefore we forget, let’s add the icon to our resource file.\n<\/p>\n
\n\/\/ scratch.rc\n1 ICON icon1.ico\n2 ICON icon2.ico\n<\/pre>\n
\nI’ll leave you to find some icons to use.\nIcon number 2 is the one that will be used for the jump list.\n(Icon number 1 I left to represent the application itself.)\n<\/p>\n
\nFinally, we respond to the command line switch.\n<\/p>\n
\nint WINAPI WinMain(HINSTANCE hinst, HINSTANCE hinstPrev,\n                   LPSTR lpCmdLine, int nShowCmd)\n{\n  if (strcmp(lpCmdLine, \"\/frob\") == 0) {\n    MessageBox(nullptr, L\"Frob!\", L\"Title\", MB_OK);\n    return 0;\n  }<\/font>\n  ...\n}\n<\/pre>\n
\nIf the command line switch \/frob<\/code> is passed,\nthen we say something silly.\nIn real life, we would create a new frob,\npossibly by looking for an existing running copy of the program\nand asking it to do the creation.\n<\/p>\n
\nOkay, run this program and then right-click on the taskbar icon.\nObserve that there is now a New frob<\/i> task,\nand if you select it,\nyou get the silly message.<\/p>\n","protected":false},"excerpt":{"rendered":"
Today’s Little Program adds a custom task to the application’s jump list. Take the scratch program and make the following changes. (Remember, Little Programs do very little error checking because that’s how they roll.) #include <shlobj.h> #include <propkey.h> #include <wrl\/client.h> using namespace Microsoft::WRL; ComPtr<IShellLink> CreateShellLinkForTask( PCWSTR pszTitle, PCTSTR pszArgs, int idIcon) { ComPtr<IShellLink> spsl; CoCreateInstance(CLSID_ShellLink, […]<\/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-2303","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"
Today’s Little Program adds a custom task to the application’s jump list. Take the scratch program and make the following changes. (Remember, Little Programs do very little error checking because that’s how they roll.) #include <shlobj.h> #include <propkey.h> #include <wrl\/client.h> using namespace Microsoft::WRL; ComPtr<IShellLink> CreateShellLinkForTask( PCWSTR pszTitle, PCTSTR pszArgs, int idIcon) { ComPtr<IShellLink> spsl; CoCreateInstance(CLSID_ShellLink, […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/2303","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=2303"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/2303\/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=2303"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=2303"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=2303"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}