SHAutoComplete-Funktion (shlwapi.h)

Weist Die Steuerelemente für die Systembearbeitung an, autoVervollständigen zu verwenden, um URLs oder Dateisystempfade zu vervollständigen.

Syntax

LWSTDAPI SHAutoComplete(
  [in] HWND  hwndEdit,
       DWORD dwFlags
);

Parameter

[in] hwndEdit

Typ: HWND

Das Fensterhandle eines Systembearbeitungssteuerelements. In der Regel ist dieser Parameter das Handle eines Bearbeitungssteuerelements oder des Bearbeitungssteuerelements, das in ein ComboBoxEx-Steuerelement eingebettet ist.

dwFlags

Art: DWORD

Die Flags zum Steuern des Vorgangs von SHAutoComplete. Die ersten vier Flags werden verwendet, um die Registrierungseinstellungen des Internets Explorer außer Kraft zu setzen. Der Benutzer kann diese Einstellungen manuell ändern, indem er das Eigenschaftenblatt Internetoptionen im Menü Extras startet und auf die Registerkarte Erweitert klickt.

SHACF_AUTOAPPEND_FORCE_OFF (0x80000000)

Ignorieren Sie die Standardeinstellung der Registrierung, und erzwingen Sie die Ausschaltung der AutoAppend-Funktion. Dieses Flag muss in Kombination mit einem oder mehreren SHACF_FILESYS*- oder SHACF_URL*-Flags verwendet werden.

SHACF_AUTOAPPEND_FORCE_ON (0x40000000)

Ignorieren Sie den Registrierungswert, und erzwingen Sie die AutoAppend-Funktion. Die abgeschlossene Zeichenfolge wird im Bearbeitungsfeld mit hervorgehobenen hinzugefügten Zeichen angezeigt. Dieses Flag muss in Kombination mit einem oder mehreren SHACF_FILESYS*- oder SHACF_URL*-Flags verwendet werden.

SHACF_AUTOSUGGEST_FORCE_OFF (0x20000000)

Ignorieren Sie die Standardeinstellung der Registrierung, und erzwingen Sie die Einstellung der AutoSuggest-Funktion. Dieses Flag muss in Kombination mit einem oder mehreren SHACF_FILESYS*- oder SHACF_URL*-Flags verwendet werden.

SHACF_AUTOSUGGEST_FORCE_ON (0x10000000)

Ignorieren Sie den Registrierungswert, und erzwingen Sie die AutoSuggest-Funktion. Eine Auswahl möglicher abgeschlossener Zeichenfolgen wird als Dropdownliste unterhalb des Bearbeitungsfelds angezeigt. Dieses Flag muss in Kombination mit einem oder mehreren SHACF_FILESYS*- oder SHACF_URL*-Flags verwendet werden.

SHACF_DEFAULT (0x00000000)

Die Standardeinstellung entspricht SHACF_FILESYSTEM | SHACF_URLALL. SHACF_DEFAULT können nicht mit anderen Flags kombiniert werden.

SHACF_FILESYS_ONLY (0x00000010)

Schließen Sie nur das Dateisystem ein.

SHACF_FILESYS_DIRS (0x00000020)

Schließen Sie das Dateisystem und die Verzeichnisse, UNC-Server und UNC-Serverfreigaben ein.

SHACF_FILESYSTEM (0x00000001)

Schließen Sie das Dateisystem und den Rest der Shell ein (z. B. Desktop, Computer und Systemsteuerung).

SHACF_URLALL (SHACF_URLHISTORY | SHACF_URLMRU)

Schließen Sie die URLs in die Listen Benutzerverlauf und Zuletzt verwendet ein . Entspricht SHACF_URLHISTORY | SHACF_URLMRU.

SHACF_URLHISTORY (0x00000002)

Schließen Sie die URLs in die Verlaufsliste des Benutzers ein.

SHACF_URLMRU (0x00000004)

Schließen Sie die URLs in die Liste Zuletzt verwendet des Benutzers ein.

SHACF_USETAB (0x00000008)

Ermöglichen Sie dem Benutzer, aus der Liste der automatischen Erfassung auszuwählen, indem er die TAB-TASTE drückt. Wenn dieses Flag nicht festgelegt ist, wird durch Drücken der TAB-TASTE der Fokus auf das nächste Steuerelement verschoben, und die Liste der automatischen Einstellungen wird geschlossen. Wenn SHACF_USETAB festgelegt ist, wird durch Drücken der TAB-TASTE das erste Element in der Liste ausgewählt. Durch erneutes Drücken der TAB-TASTE wird das nächste Element in der Liste ausgewählt usw. Wenn der Benutzer das Ende der Liste erreicht, wird der Fokus beim nächsten Drücken der TAB-TASTE zurück zum Bearbeitungssteuerelement gerückt. Dieses Flag muss in Kombination mit mindestens einem der auf dieser Seite aufgeführten SHACF_FILESYS*- oder SHACF_URL*-Flags verwendet werden.

SHACF_VIRTUAL_NAMESPACE (0x00000040)

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

SHAutoComplete funktioniert mit jedem Systembearbeitungssteuerelement, einschließlich des Bearbeitungssteuerelements und der Steuerelemente, die Bearbeitungssteuerelemente wie ComboBoxEx-Steuerelemente enthalten. Um ein Handle für ein in ein ComboBoxEx-Steuerelement eingebettetes Bearbeitungssteuerelement abzurufen, senden Sie dem ComboBoxEx-Steuerelement eine CBEM_GETEDITCONTROL Nachricht.

Eine Anwendung muss vor dem Aufrufen dieser Funktion entweder CoInitialize oder OleInitialize aufgerufen haben. CoUninitialize oder OleUninitialize kann erst aufgerufen werden, wenn das Bearbeitungsfeld die Verarbeitung der WM_DESTROY Nachricht für hwndEdit abgeschlossen hat.

Die maximale Anzahl von Elementen, die in einem Dropdown-Listenfeld für die automatische Erfassung angezeigt werden können, beträgt 1000.

Bei Versionen von Windows vor Windows Vista und Serverversionen vor Windows Server 2008 sollte SHAutoComplete nicht mehr als einmal mit demselben HWND aufgerufen werden. Dies führt zu einem Speicherverlust. Es verhindert, dass die ursprünglichen Ressourcen freigegeben werden, einschließlich der vorherigen instance des AutoVervollständigen-Objekts, Enumeratorobjekte, auf die das vorherige AutoComplete-Objekt verwiesen wurde, und GDI-Ressourcen (Windows Graphics Device Interface). Anstatt SHAutoComplete erneut mit einem anderen Satz von Flags aufzurufen, um die AutoVervollständigen-Liste zu ändern, rufen Sie CoCreateInstance mit CLSID_AutoComplete auf, um das AutoComplete-Objekt abzurufen. Übergeben Sie dann den HWND an das -Objekt, um es zu initialisieren und Einen eigenen benutzerdefinierten Enumerator bereitzustellen. Sie können CLSID_ACLMulti verwenden, wenn AutoVervollständigen mehrere Listen verwenden soll.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlwapi.h
Bibliothek	Shlwapi.lib
DLL	Shlwapi.dll (Version 5.0 oder höher)

Weitere Informationen

Verwenden von AutoVervollständigen