Click here to Skip to main content
15,868,340 members
Articles / Desktop Programming / MFC
Article

Auto-complete edit and combo, without Platform SDK

Rate me:
Please Sign up or sign in to vote.
4.13/5 (10 votes)
26 Feb 20022 min read 233.5K   70   42
How to enable file system and URL auto-complete for edit controls and combo-boxes, without downloading the entire Platform SDK

Introduction

Here's a quick article that shows how you can add the handy auto-completion effect that you see in the Win2K file-open dialog for your own edits and combo boxes - without having to download the entire Platform SDK (9 hours on a 56K modem!). If you already have the Platform SDK, this article is probably useless to you.

Demo

I'm not providing any demo project here, the code is small enough that you can just copy and paste (one function!).

Some constants

These would be defined in the Platform SDK, but since we're not using that, I'll include these here. You'll have to copy these to your app.

// See the MSDN for SHAutoComplete for a full 
// description of what these options do.
#define SHACF_DEFAULT                   0x00000000
#define SHACF_FILESYSTEM                0x00000001
#define SHACF_URLALL                    (SHACF_URLHISTORY | SHACF_URLMRU)
#define SHACF_URLHISTORY                0x00000002
#define SHACF_URLMRU                    0x00000004
#define SHACF_USETAB                    0x00000008
#define SHACF_FILESYS_ONLY              0x00000010

#define SHACF_AUTOSUGGEST_FORCE_ON      0x10000000
#define SHACF_AUTOSUGGEST_FORCE_OFF     0x20000000
#define SHACF_AUTOAPPEND_FORCE_ON       0x40000000
#define SHACF_AUTOAPPEND_FORCE_OFF      0x80000000

The simple wrapper function

typedef HRESULT (WINAPI *SHAUTOCOMPLETEFN) 
    (HWND hTarget, DWORD dwFlags);
static HINSTANCE hSHLWAPIDLL = NULL;

bool SetupForAutoComplete(HWND hTarget, DWORD dwFlags)
{
    if (hTarget == NULL)
    {
        return false;
    }

    bool ok = false;

    if (hSHLWAPIDLL == NULL)
    {
        hSHLWAPIDLL= LoadLibrary("SHLWAPI.DLL");
        if (hSHLWAPIDLL== NULL)
        {
            return false;
        }
    }

    SHAUTOCOMPLETEFN pSHAC = 
        (SHAUTOCOMPLETEFN)GetProcAddress(hSHLWAPIDLL, 
        "SHAutoComplete");

    if (pSHAC != NULL)
    {
        ok = SUCCEEDED(pSHAC(hTarget, dwFlags));
    }

    return ok;
}

Using it

First, make sure you've called ::CoInitialize(NULL); in your CWinApp's InitInstance. Without this, the call to SHAutoComplete will fail. You also need to call CoUninitialize(); in your CWinApp's ExitInstance. This initializes COM for your app.

I'd also recommend that you call FreeLibrary(hSHLWAPIDLL) in your CWinApp::ExitInstance(), just to be nice to the OS.

Now the good stuff

If you have an an edit control in your dialog class that's hooked up to a member variable, all you have to do is:

BOOL CMyDialog::OnInitDialog()
{
...
    // enable auto complete for m_myEdit
    SetupForAutoComplete(m_myEdit.m_hWnd, 
        SHACF_FILESYSTEM);
...
}

And that's it. Now, when you start typing a path, the edit control will drop down a list box with paths that match what you've typed so far - just like the file open dialog.

If you want to do this to a combo box, it's slightly more complicated:

BOOL CMyDialog::OnInitDialog()
{
...
    // the edit control of a CComboBox is always at dlg ID 1001
    CEdit * pMyEdit = (CEdit *)m_myCombo.GetDlgItem(1001);
    if (pMyEdit)
    {
        // enable auto complete for m_myCombo
        SetupForAutoComplete(pMyEdit->m_hWnd, SHACF_FILESYSTEM);
    }
...
}

And that's that.

Concerns

The heart of this whole thing is SHAutoComplete. This is a function that lives in Shlwapi.DLL and is only available on Win2K or on machines with IE 5.0 or higher installed. But, you can safely call my SetupForAutoComplete function on machines that don't meet those requirements because the function checks for the DLL and then for the particular function. If neither are there, the function leaves gracefully.

More info

SHAutoComplete can do more than file system auto-complete. It can also do URL auto-complete (like the navigation bar in IE), and it can do it all with various other fun options. See the MSDN for SHAutoComplete for a full description of what these options are.

And that's that. Enjoy responsibly. Oh yeah, thanks Michael Dunn, for your invaluable input :)

License

This article has no explicit license attached to it but may contain usage terms in the article text or the download files themselves. If in doubt please contact the author via the discussion board below.

A list of licenses authors might use can be found here


Written By
Software Developer
United States United States
Chris Losinger was the president of Smaller Animals Software, Inc. (which no longer exists).

Comments and Discussions

 
GeneralI do just like that, but unuseful!! Pin
fdmakk2-Feb-05 15:44
fdmakk2-Feb-05 15:44 
Generalcombo box Pin
Anonymous10-Jul-04 21:46
Anonymous10-Jul-04 21:46 
GeneralRe: combo box Pin
toxcct4-Dec-04 3:32
toxcct4-Dec-04 3:32 
Questionhow can enter key close the drop down box? Pin
Danny Neijns1285-Jul-04 0:28
Danny Neijns1285-Jul-04 0:28 
GeneralWith Platform SDK Pin
Anakin_Skywalker17-Jan-04 12:43
Anakin_Skywalker17-Jan-04 12:43 
GeneralHelp! Locks program Pin
blindcop8-Jan-04 7:12
blindcop8-Jan-04 7:12 
GeneralRe: Help! Locks program Pin
blindcop9-Jan-04 4:25
blindcop9-Jan-04 4:25 
GeneralVC++ using edit box and dialog Pin
Wasimhc5-Jan-03 20:59
Wasimhc5-Jan-03 20:59 
GeneralRe: VC++ using edit box and dialog Pin
Chris Losinger6-Jan-03 14:54
professionalChris Losinger6-Jan-03 14:54 
QuestionSHACF_FILESYSTEM ? Pin
me27-Mar-02 14:24
me27-Mar-02 14:24 
AnswerRe: SHACF_FILESYSTEM ? Pin
Chris Losinger27-Mar-02 14:52
professionalChris Losinger27-Mar-02 14:52 
here are the MSDN docs for SHAutoComplete.

it doesn't give much info, but it's all i could find. Google didn't have much more.

-c



Ah, but a programmer's reach should exceed his grasp, or what are late nights for?

Smaller Animals Software, Inc.

Questionhow to make the Edit on the htmlpages has the auto-completion effect? Pin
benben8-Mar-02 0:41
benben8-Mar-02 0:41 
QuestionHow to add strings in auto complete droplist Pin
1-Mar-02 3:25
suss1-Mar-02 3:25 
Generali was wondering how that worked... Pin
Shog927-Feb-02 5:40
sitebuilderShog927-Feb-02 5:40 
GeneralRe: i was wondering how that worked... Pin
Chris Losinger27-Feb-02 5:44
professionalChris Losinger27-Feb-02 5:44 
GeneralProblems Pin
Derek Price27-Feb-02 2:14
Derek Price27-Feb-02 2:14 
GeneralRe: Problems Pin
Chris Losinger27-Feb-02 3:05
professionalChris Losinger27-Feb-02 3:05 
GeneralRe: Problems Pin
Chris Losinger27-Feb-02 3:06
professionalChris Losinger27-Feb-02 3:06 
GeneralRe: Problems Pin
Derek Price27-Feb-02 3:29
Derek Price27-Feb-02 3:29 
GeneralRe: Problems Pin
_Magnus_27-Feb-02 3:07
_Magnus_27-Feb-02 3:07 
GeneralGreat stuff! Pin
Jörgen Sigvardsson26-Feb-02 22:01
Jörgen Sigvardsson26-Feb-02 22:01 
GeneralMore optimization Pin
Ravi Bhavnani27-Feb-02 2:31
professionalRavi Bhavnani27-Feb-02 2:31 
GeneralRe: More optimization Pin
Jörgen Sigvardsson27-Feb-02 2:46
Jörgen Sigvardsson27-Feb-02 2:46 
GeneralRe: More optimization Pin
27-Feb-02 3:46
suss27-Feb-02 3:46 
GeneralAlmost there... Pin
Chris Losinger27-Feb-02 3:02
professionalChris Losinger27-Feb-02 3:02 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.