IAutoComplete2 (Interfaces)
Last changed: -217.85.252.206

.
Summary
A little bit more advaced autocomplete

C# Definition:

[ComImport]
[InterfaceType(ComInterfaceType.InterfaceIsIUnknown)]
[Guid("EAC04BC0-3791-11D2-BB95-0060977B464C")]
public interface IAutoComplete2 {
    [PreserveSig] int Init(
        // Handle to the window for the system edit control that is to
        // have autocompletion enabled.
        IntPtr hwndEdit,

        // Pointer to the IUnknown interface of the string list object that
        // is responsible for generating candidates for the completed
        // string. The object must expose an IEnumString interface.
        [MarshalAs(UnmanagedType.IUnknown)] object punkACL,

        // Pointer to an optional null-terminated Unicode string that gives
        // the registry path, including the value name, where the format
        // string is stored as a REG_SZ value. The autocomplete object
        // first looks for the path under HKEY_CURRENT_USER . If it fails,
        // it then tries HKEY_LOCAL_MACHINE . For a discussion of the
        // format string, see the definition of pwszQuickComplete.
        [MarshalAs(UnmanagedType.LPWStr)] string pwszRegKeyPath,

        // Pointer to an optional string that specifies the format to be
        // used if the user enters some text and presses CTRL+ENTER. Set
        // this parameter to NULL to disable quick completion. Otherwise,
        // the autocomplete object treats pwszQuickComplete as a sprintf
        // format string, and the text in the edit box as its associated
        // argument, to produce a new string. For example, set
        // pwszQuickComplete to "http://www. %s.com/". When a user enters
        // "MyURL" into the edit box and presses CTRL+ENTER, the text in
        // the edit box is updated to "http://www.MyURL.com/".
        [MarshalAs(UnmanagedType.LPWStr)] string pwszQuickComplete
    );

    // Enables or disables autocompletion.
    [PreserveSig] int Enable(bool value);

    // Sets the current autocomplete options.
    [PreserveSig] int SetOptions(AUTOCOMPLETEOPTIONS dwFlag);

    // Retrieves the current autocomplete options.
    [PreserveSig] int GetOptions(out AUTOCOMPLETEOPTIONS pdwFlag);
}

User-Defined Types:

[Flags]
public enum AUTOCOMPLETEOPTIONS {
    // No autocomplete.
    ACO_NONE = 0,

    // Enable the autosuggest drop-down list.
    ACO_AUTOSUGGEST = 0x1,

    // Enable autoappend.
    ACO_AUTOAPPEND = 0x2,

    // Add a search item to the list of completed strings. Selecting this item launches a search engine.
    ACO_SEARCH = 0x4,

    // Don't match common prefixes, such as "www.", "http://", and so on.
    ACO_FILTERPREFIXES    = 0x8,        

    // Use the TAB key to select an item from the drop-down list.
    ACO_USETAB = 0x10,

    // Use the UP ARROW and DOWN ARROW keys to display the autosuggest drop-down list.
    ACO_UPDOWNKEYDROPSLIST = 0x20,

    // If ACO_RTLREADING is set, the text reads in the opposite direction from the text in the parent window.
    ACO_RTLREADING = 0x40
}

Notes:

None.

Tips & Tricks:

Please add some!

Sample Code:

static readonly Guid CLSID_AutoComplete = new Guid("{00BB2763-6A77-11D0-A535-00C04FD7D062}");

private IAutoComplete2 GetAutoComplete() {
    Type CAutoComplete = Type.GetTypeFromCLSID(CLSID_AutoComplete);

    return (IAutoComplete2)Activator.CreateInstance(CAutoComplete);
}

Alternative Managed API:

Do you know one? Please contribute it!

Documentation