{"id":99745,"date":"2018-09-17T07:00:00","date_gmt":"2018-09-17T21:00:00","guid":{"rendered":"https:\/\/blogs.msdn.microsoft.com\/oldnewthing\/?p=99745"},"modified":"2021-01-10T19:59:34","modified_gmt":"2021-01-11T03:59:34","slug":"20180917-00","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/oldnewthing\/20180917-00\/?p=99745","title":{"rendered":"What defines an old-style common dialog?"},"content":{"rendered":"

In the documentation for the OPEN\u00adFILE\u00adNAME<\/code> structure, there are many references to “old-style” dialogs. What is an old-style dialog, how do you get one, and how is it different from a new-style dialog?<\/p>\n

So-called “old-style” dialogs are the File Open and File Save dialogs from Windows 3.1. Here’s roughly what they looked like:<\/p>\n

\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Open<\/b><\/td>\n<\/tr>\n
<\/td>\n<\/tr>\n
<\/td>\nFile n<\/u>ame:<\/td>\n<\/td>\nF<\/u>olders:<\/td>\n<\/td>\n<\/p>\n
\n
OK<\/div>\n<\/div>\n
\u00a0<\/div>\n
\n
Cancel<\/div>\n<\/div>\n<\/td>\n
\u00a0<\/td>\n<\/tr>\n
 <\/td>\n\n
\n
file.txt<\/div>\n<\/div>\n<\/td>\n
 <\/td>\nC:\\WINDOWS<\/td>\n\u00a0<\/td>\n<\/tr>\n
<\/td>\n<\/tr>\n
 <\/td>\n\n
\n
CONFIG.TXT
\nDISPLAY.TXT
\nEXCHANGE.TXT
\nEXTRA.TXT
\nFAQ.TXT
\nGENERAL.TXT<\/div>\n
\n
\n
\u25b4<\/div>\n<\/div>\n
\n
\u00a0<\/div>\n<\/div>\n
\u00a0<\/div>\n
\n
\u25be<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/td>\n
\u00a0<\/td>\n\n
\n
\ud83d\udcc1 C:\\
\n\u00a0\ud83d\udcc1 WINDOWS
\n\u00a0\u00a0\ud83d\udcc1COMMAND
\n\u00a0\u00a0\ud83d\udcc1CONFIG
\n\u00a0\u00a0\ud83d\udcc1CURSORS
\n\u00a0\u00a0\ud83d\udcc1Desktop<\/div>\n
\n
\n
\u25b4<\/div>\n<\/div>\n
\n
\u00a0<\/div>\n<\/div>\n
\u00a0<\/div>\n
\n
\u25be<\/div>\n<\/div>\n<\/div>\n<\/div>\n<\/td>\n
\u00a0<\/td>\n<\/tr>\n
<\/td>\n<\/tr>\n
\u00a0<\/td>\nList files of t<\/u>ype:<\/td>\n\u00a0<\/td>\nDriv<\/u>es:<\/td>\n\u00a0<\/td>\n\u00a0<\/td>\n<\/tr>\n
<\/td>\n<\/tr>\n
\u00a0<\/td>\n\n
\n
Text files (*.txt)<\/div>\n
\n
\u25be<\/div>\n<\/div>\n<\/div>\n<\/td>\n
\u00a0<\/td>\n\n
\n
\ud83d\uddb4 C:<\/div>\n
\n
\u25be<\/div>\n<\/div>\n<\/div>\n<\/td>\n
\u00a0<\/td>\n<\/tr>\n
<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/div>\n

These are not the “new” style dialogs that resemble an Explorer window. They are the old-fashioned dialogs that scream “I was written in the early 1990s!”<\/p>\n

When you use an old-style dialog, Windows basically uses the code that was originally written for Windows 3.1, because programs from that era don’t support fancy things like long file names, and when they try to customize the dialog, they are expecting to customize a Windows 3.1-style dialog, so that’s what we give them.<\/p>\n

Here are the main differences between the old style and new style dialogs:<\/p>\n\n\n\n\n\n\n\n\n\n
Feature<\/th>\nOld-style<\/th>\nNew-style<\/th>\n<\/tr>\n
Long file names<\/td>\nNo<\/td>\nYes<\/td>\n<\/tr>\n
Resizability<\/td>\nNot resizable<\/td>\nResizable<\/td>\n<\/tr>\n
Multiselect<\/td>\nSpace-separated file names<\/td>\nNull-separated file names<\/td>\n<\/tr>\n
Template<\/td>\nReplaces entire dialog<\/td>\nEmbedded into existing dialog<\/td>\n<\/tr>\n
Default extension<\/td>\nMaximum 3 characters<\/td>\nCan exceed 3 characters<\/td>\n<\/tr>\n
Hooks<\/td>\nWindows 3.1-style<\/td>\nWindows 95-style<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

The system decides whether you get an old-style or new-style dialog based on the following rules:<\/p>\n

    \n
  • If you say OFN_EXPLORER<\/code>, then you get a new-style dialog.<\/li>\n
  • If you don’t say OFN_EXPLORER<\/code>, and you do say OFN_<\/code>ENABLE\u00adTEMPLATE<\/code>, OFN_<\/code>ENABLE\u00adTEMPLATE\u00adHANDLE<\/code>, OFN_<\/code>ENABLE\u00adHOOK<\/code>, or OFN_<\/code>ALLOW\u00adMULTI\u00adSELECT<\/code>, then you get an old-style dialog.<\/li>\n
  • If you don’t say anything on the above list, then you get a new-style dialog.<\/li>\n<\/ul>\n

    In words: You get an old-style dialog if you ask for any of OFN_<\/code>ENABLE\u00adTEMPLATE<\/code>, OFN_<\/code>ENABLE\u00adTEMPLATE\u00adHANDLE<\/code>, OFN_<\/code>ENABLE\u00adHOOK<\/code>, or OFN_<\/code>ALLOW\u00adMULTI\u00adSELECT<\/code>, since those are the things that affect the programmatic behavior of the dialog. However, you can override this by saying OFN_EXPLORER<\/code> to say, “No really, I’m okay with the new hotness.”<\/p>\n","protected":false},"excerpt":{"rendered":"

    Going back into the Before Time.<\/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-99745","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-oldnewthing","tag-code"],"acf":[],"blog_post_summary":"

    Going back into the Before Time.<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/99745","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=99745"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/posts\/99745\/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=99745"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/categories?post=99745"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/oldnewthing\/wp-json\/wp\/v2\/tags?post=99745"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}