IAutoComplete::Init-Methode (shldisp.h)

Artikel
03/04/2024

Initialisiert das Autovervollständigen-Objekt.

Syntax

HRESULT Init(
  [in]           HWND     hwndEdit,
  [in]           IUnknown *punkACL,
  [in, optional] LPCWSTR  pwszRegKeyPath,
  [in, optional] LPCWSTR  pwszQuickComplete
);

Parameter

[in] hwndEdit

Typ: HWND

Ein Handle für das Fenster für das Systembearbeitungssteuerelement, für das die automatische Vervollständigung aktiviert wird.

[in] punkACL

Typ: IUnknown*

Ein Zeiger auf die IUnknown-Schnittstelle des Zeichenfolgenlistenobjekts , das Kandidaten für die abgeschlossene Zeichenfolge generiert. Das Objekt muss eine IEnumString-Schnittstelle verfügbar machen.

[in, optional] pwszRegKeyPath

Typ: LPCWSTR

Ein Zeiger auf eine optionale, mit NULL beendete Unicode-Zeichenfolge, die den Registrierungspfad einschließlich des Wertnamens angibt, in dem die Formatzeichenfolge als REG_SZ Wert gespeichert wird. Das Autovervollständigen-Objekt sucht zuerst nach dem Pfad unter HKEY_CURRENT_USER. Wenn ein Fehler auftritt, versucht es HKEY_LOCAL_MACHINE. Eine Erläuterung der Formatzeichenfolge finden Sie in der Definition von pwszQuickComplete.

[in, optional] pwszQuickComplete

Typ: LPCWSTR

Ein Zeiger auf eine optionale Unicode-Zeichenfolge mit NULL-Beendigung, die das Format angibt, das verwendet werden soll, wenn der Benutzer Text eingibt und STRG+EINGABETASTE drückt. Legen Sie diesen Parameter auf NULL fest, um die Schnellvervollständigung zu deaktivieren. Andernfalls behandelt das Autovervollständigen-Objekt pwszQuickComplete als StringCchPrintf-Formatzeichenfolge und den Text im Bearbeitungsfeld als zugeordnetes Argument, um eine neue Zeichenfolge zu erzeugen. Legen Sie beispielsweise pwszQuickComplete auf ";"http://www.%s.com/" fest. Wenn ein Benutzer "MyURL" in das Bearbeitungsfeld eingibt und STRG+EINGABETASTE drückt, wird der Text im Bearbeitungsfeld auf "http://www.MyURL.com/"" aktualisiert.

Rückgabewert

Typ: HRESULT

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

Anforderungen

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

Weitere Informationen

IAutoComplete

Freigeben über