Compartir a través de

Función HtmlHelpW (htmlhelp.h)

  • Artículo

Muestra una ventana de ayuda.

Con los comandos de API, puede especificar qué tema se va a mostrar en la ventana de ayuda, si la ventana de ayuda es un Visor de ayuda de tres paneles o una ventana emergente, y si se debe tener acceso al archivo de tema HTML a través de un identificador de contexto, una dirección URL de ayuda HTML o una búsqueda de vínculo de palabra clave (KLink).

Sintaxis

HWND HtmlHelpW(
  [in, optional] HWND      hwndCaller,
  [in]           LPCWSTR   pszFile,
  [in]           UINT      uCommand,
  [in]           DWORD_PTR dwData
);

Parámetros

[in, optional] hwndCaller

Especifica el identificador (hwnd) de la ventana que llama a HtmlHelp. La ventana de ayuda es propiedad de esta ventana.

Cuando se cierra la ventana de ayuda, HtmlHelp devolverá el foco al propietario a menos que el propietario sea el escritorio. Si hwndCaller es el escritorio, el sistema operativo determina dónde se devuelve el foco.

Además, si htmlHelp envía mensajes de notificación desde la ventana de ayuda, se envían a hwndCaller siempre que haya habilitado mensaje de notificación seguimiento en la definición de la ventana de ayuda.

[in] pszFile

Según el valor de uCommand, especifica la ruta de acceso del archivo a un archivo de ayuda compilado (.chm) o a un archivo de tema dentro de un archivo de ayuda especificado.

También se puede especificar un tipo de ventana de nombre, precedido de un carácter mayor que (>).

Si el comando especificado no requiere un archivo, este valor puede ser NULL.

[in] uCommand

Especifica el comando que se va a completar.

[in] dwData

Especifica los datos que puedan ser necesarios, en función del valor del parámetro uCommand.

Valor devuelto

Según el uCommand especificado y el resultado, htmlHelp devuelve uno o ambos de los siguientes:

  • Identificador (hwnd) de la ventana de ayuda.
  • NULL. En algunos casos, NULL indica un error; en otros casos, NULL indica que la ventana de ayuda aún no se ha creado.

Observaciones

La sintaxis se aplica a los conjuntos de caracteres ANSI. Cuando se usa un juego de caracteres Unicode, el tipo del parámetro pszFile debe ser "LPCTSTR".

Al usar la API de ayuda HTML, establezca el tamaño de pila del archivo ejecutable de hospedaje en al menos 100 000. Si el tamaño de pila definido es demasiado pequeño, el subproceso creado para ejecutar la Ayuda HTML también se creará con este tamaño de pila y podría producirse un error. Opcionalmente, puede quitar /STACK de la línea de comandos del vínculo y quitar cualquier configuración de STACK en el archivo DEF del ejecutable (el tamaño de pila predeterminado es de 1 MB en este caso). También puede establecer el tamaño de la pila mediante el comando del compilador /Fnumber (el compilador lo pasará al enlazador como /STACK).

Ejemplos

En el ejemplo siguiente se llama al comando HH_DISPLAY_TOPIC para abrir el archivo de ayuda denominado Help.chm y mostrar su tema predeterminado en la ventana de ayuda denominada Mainwin. Por lo general, la ventana de ayuda especificada en este comando es una visor de ayuda HTML estándar.

HWND hwnd =
   HtmlHelp(
            GetDesktopWindow(),
            "c:\\Help.chm::/Intro.htm>Mainwin",
            HH_DISPLAY_TOPIC,
            NULL) ;

Nota

El encabezado htmlhelp.h define HtmlHelp como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
de la plataforma de destino de Windows
encabezado de htmlhelp.h
biblioteca de Htmlhelp.lib
DLL de hhctrl.ocx

Consulte también

Acerca de la API de ayuda DE HTML