Metodo IAutoComplete::Init (shldisp.h)

Articolo
03/02/2024

Inizializza l'oggetto completamento automatico.

Sintassi

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

Parametri

[in] hwndEdit

Tipo: HWND

Handle della finestra per il controllo di modifica del sistema per il quale verrà abilitato il completamento automatico.

[in] punkACL

Tipo: IUnknown*

Puntatore all'interfaccia IUnknown dell'oggetto elenco di stringhe che genera i candidati per la stringa completata. L'oggetto deve esporre un'interfaccia IEnumString .

[in, optional] pwszRegKeyPath

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione null facoltativa che fornisce il percorso del Registro di sistema, incluso il nome del valore, in cui la stringa di formato viene archiviata come valore REG_SZ . L'oggetto completamento automatico cerca innanzitutto il percorso in HKEY_CURRENT_USER. Se ha esito negativo, prova a HKEY_LOCAL_MACHINE. Per una discussione sulla stringa di formato, vedere la definizione di pwszQuickComplete.

[in, optional] pwszQuickComplete

Tipo: LPCWSTR

Puntatore a una stringa Unicode con terminazione null facoltativa che specifica il formato da utilizzare se l'utente immette testo e preme CTRL+INVIO. Impostare questo parametro su NULL per disabilitare il completamento rapido. In caso contrario, l'oggetto di completamento automatico considera pwszQuickComplete come stringa di formato StringCchPrintf e il testo nella casella di modifica come argomento associato per produrre una nuova stringa. Ad esempio, impostare pwszQuickComplete su "http://www.%s.com/". Quando un utente immette "MyURL" nella casella di modifica e preme CTRL+INVIO, il testo nella casella di modifica viene aggiornato a "http://www.MyURL.com/".

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shldisp.h
DLL	Shell32.dll (versione 5.0 o successiva)

Vedi anche

IAutoComplete

Condividi tramite