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

Artigo
08/26/2023

Inicializa o objeto de preenchimento automático.

Sintaxe

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

Parâmetros

[in] hwndEdit

Digite: HWND

Um identificador para a janela do controle de edição do sistema para o qual a preenchimento automático será habilitada.

[in] punkACL

Tipo: IUnknown*

Um ponteiro para a interface IUnknown do objeto de lista de cadeias de caracteres que gera candidatos para a cadeia de caracteres concluída. O objeto deve expor uma interface IEnumString .

[in, optional] pwszRegKeyPath

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres Unicode opcional terminada em nulo que fornece o caminho do Registro, incluindo o nome do valor, em que a cadeia de caracteres de formato é armazenada como um valor REG_SZ . O objeto de preenchimento automático procura primeiro o caminho em HKEY_CURRENT_USER. Se falhar, tentará HKEY_LOCAL_MACHINE. Para obter uma discussão sobre a cadeia de caracteres de formato, consulte a definição de pwszQuickComplete.

[in, optional] pwszQuickComplete

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo opcional que especifica o formato a ser usado se o usuário inserir texto e pressionar CTRL+ENTER. Defina esse parâmetro como NULL para desabilitar a conclusão rápida. Caso contrário, o objeto de preenchimento automático trata pwszQuickComplete como uma cadeia de caracteres de formato StringCchPrintf e o texto na caixa de edição como seu argumento associado, para produzir uma nova cadeia de caracteres. Por exemplo, defina pwszQuickComplete como "http://www.%s.com/". Quando um usuário insere "MyURL" na caixa de edição e pressiona CTRL+ENTER, o texto na caixa de edição é atualizado para "http://www.MyURL.com/".

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.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	shldisp.h
DLL	Shell32.dll (versão 5.0 ou posterior)

Confira também

IAutoComplete

Compartilhar via