Partager via


Méthode IACList ::Expand (shlobj_core.h)

Demande que le client autocompletion génère des chaînes candidates associées à un élément spécifié dans son espace de noms.

Syntaxe

HRESULT Expand(
  [in] PCWSTR pszExpand
);

Paramètres

[in] pszExpand

Type : PCWSTR

Pointeur vers une chaîne Unicode terminée par null à développer par l’objet de saisie semi-automatique.

Valeur retournée

Type : HRESULT

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

Remarques

L’objet de saisie semi-automatique appelle cette méthode lorsqu’un délimiteur est entré dans le contrôle d’édition. Si la chaîne pointée par pszExpand correspond à un élément dans l’espace de noms du client autocompletion, le client génère des chaînes pour les éléments qui tombent immédiatement sous pszExpand dans sa hiérarchie d’espaces de noms. Le client retourne ces chaînes la prochaine fois que l’objet autocomplétion appelle l’interface IEnumString du client.

Par exemple, en supposant que l’espace de noms du client se compose de tous les fichiers et dossiers sur le lecteur C :, et que pszExpand a la valeur « C :\Program Files », le client doit générer une liste de chaînes correspondant aux chemins complets des fichiers et sous-dossiers de « C :\Program Files ».

Configuration requise

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

Voir aussi

IACList