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

Inicializa el objeto autocompletar.

Sintaxis

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

Parámetros

[in] hwndEdit

Tipo: HWND

Identificador de la ventana del control de edición del sistema para el que se habilitará la función de autocompletar.

[in] punkACL

Tipo: IUnknown*

Puntero a la interfaz IUnknown del objeto de lista de cadenas que genera candidatos para la cadena completada. El objeto debe exponer una interfaz IEnumString .

[in, optional] pwszRegKeyPath

Tipo: LPCWSTR

Puntero a una cadena Unicode opcional terminada en null que proporciona la ruta de acceso del Registro, incluido el nombre del valor, donde la cadena de formato se almacena como un valor de REG_SZ . El objeto autocompletar busca primero la ruta de acceso en HKEY_CURRENT_USER. Si se produce un error, intenta HKEY_LOCAL_MACHINE. Para obtener una explicación de la cadena de formato, consulte la definición de pwszQuickComplete.

[in, optional] pwszQuickComplete

Tipo: LPCWSTR

Puntero a una cadena Unicode terminada en NULL opcional que especifica el formato que se va a usar si el usuario escribe texto y presiona CTRL+ENTRAR. Establezca este parámetro en NULL para deshabilitar la finalización rápida. De lo contrario, el objeto autocompletar trata pwszQuickComplete como una cadena de formato StringCchPrintf y el texto del cuadro de edición como su argumento asociado, para generar una nueva cadena. Por ejemplo, establezca pwszQuickComplete en "http://www.%s.com/". Cuando un usuario escribe "MyURL" en el cuadro de edición y presiona CTRL+ENTRAR, el texto del cuadro de edición se actualiza a "http://www.MyURL.com/".

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shldisp.h
Archivo DLL	Shell32.dll (versión 5.0 o posterior)

Consulte también

IAutoComplete