Méthode IAutoComplete ::Init (shldisp.h)

Article
08/26/2023

Initialise l’objet de saisie semi-automatique.

Syntaxe

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

Paramètres

[in] hwndEdit

Type : HWND

Handle de la fenêtre pour le contrôle d’édition système pour lequel l’autocomplétion sera activée.

[in] punkACL

Type : IUnknown*

Pointeur vers l’interface IUnknown de l’objet de liste de chaînes qui génère des candidats pour la chaîne terminée. L’objet doit exposer une interface IEnumString .

[in, optional] pwszRegKeyPath

Type : LPCWSTR

Pointeur vers une chaîne Unicode facultative et terminée par une valeur null qui donne le chemin d’accès du Registre, y compris le nom de la valeur, où la chaîne de format est stockée en tant que valeur REG_SZ . L’objet de saisie semi-automatique recherche d’abord le chemin d’accès sous HKEY_CURRENT_USER. En cas d’échec, il tente d’HKEY_LOCAL_MACHINE. Pour plus d’informations sur la chaîne de format, consultez la définition de pwszQuickComplete.

[in, optional] pwszQuickComplete

Type : LPCWSTR

Pointeur vers une chaîne Unicode null facultative qui spécifie le format à utiliser si l’utilisateur entre du texte et appuie sur CTRL+ENTRÉE. Définissez ce paramètre sur NULL pour désactiver l’exécution rapide. Sinon, l’objet de saisie semi-automatique traite pwszQuickComplete comme une chaîne au format StringCchPrintf et le texte de la zone d’édition comme argument associé pour produire une nouvelle chaîne. Par exemple, définissez pwszQuickComplete sur « http://www.%s.com/". Lorsqu’un utilisateur entre « MyURL » dans la zone d’édition et appuie sur Ctrl+Entrée, le texte de la zone d’édition est mis à jour en «http://www.MyURL.com/" ;.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shldisp.h
DLL	Shell32.dll (version 5.0 ou ultérieure)

Voir aussi

IAutoComplete

Partager via