Método IACList::Expand (shlobj_core.h)
Solicita que o cliente de preenchimento automático gere cadeias de caracteres candidatas associadas a um item especificado em seu namespace.
Sintaxe
HRESULT Expand(
[in] PCWSTR pszExpand
);
Parâmetros
[in] pszExpand
Tipo: PCWSTR
Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo a ser expandida pelo objeto de preenchimento automático.
Retornar valor
Tipo: HRESULT
Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.
Comentários
O objeto de preenchimento automático chama esse método quando um delimitador é inserido no controle de edição. Se a cadeia de caracteres apontada por pszExpand corresponder a um item no namespace do cliente de preenchimento automático, o cliente gerará cadeias de caracteres para os itens que se enquadram imediatamente em pszExpand em sua hierarquia de namespace. O cliente retorna essas cadeias de caracteres na próxima vez que o objeto de preenchimento automático chamar a interface IEnumString do cliente.
Por exemplo, supondo que o namespace do cliente consiste em todos os arquivos e pastas na unidade C: e pszExpand está definido como "C:\Arquivos de Programas", o cliente deve gerar uma lista de cadeias de caracteres correspondentes aos caminhos totalmente qualificados dos arquivos e subpastas de "C:\Arquivos de Programas".
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | shlobj_core.h |
| DLL | Shell32.dll (versão 5.0 ou posterior) |