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

Voir aussi

IACList