¡Ayuda urgente! ¿Qué tipo de archivo es la extensión BML?
Tú usas, cad ky dai kai
Te lo explicaré
de la siguiente manera:
Para un sistema de aplicación maduro que Dicho esto, un sistema de ayuda conveniente y detallado es esencial. El sistema de ayuda gráfica en el entorno Windows 95/98 puede incluir gráficos, texto formateado, sonidos, animaciones, etc., lo que aporta mucho a la aplicación.
En el entorno Windows95/98, puede crear un sistema de ayuda de aplicaciones más completo utilizando la herramienta Microsoft Help Workshop proporcionada por Visual Foxpro.
Al crear un sistema de ayuda en Windows 95/98, primero debe aclarar los siguientes conceptos:
(1) Tema de ayuda: el tema de ayuda se refiere a la información en la ventana de ayuda. que generalmente es información que comienza con un título y contiene una tarea, comando o cuadro de diálogo específico. La ayuda se compone de "temas" conectados en serie. Cada tema se puede identificar por su título, cadena de identificación del tema y número de secuencia de navegación.
(2) Título: el título puede estar compuesto por varias palabras con espacios y es texto descriptivo. La primera línea del "tema" generalmente se usa como título. Diferentes temas deben tener títulos diferentes. Si varios temas tienen el mismo título, el sistema emitirá una advertencia.
(3) Cadena de identificación del tema: La cadena de identificación del tema es la única cadena utilizada para determinar el tema. Solo puede estar compuesta por letras, números o guiones bajos.
(4) Palabras clave: en el archivo de ayuda generado, puede buscar según palabras clave e ir al tema correspondiente.
(5) Número de secuencia de exploración: el número de secuencia de exploración se utiliza para crear archivos de ayuda sensibles al contexto. No se puede repetir como la cadena de identificación de tema.
Los pasos para crear un sistema de ayuda son los siguientes:
(1) Edite el archivo del tema de ayuda (extensión: .RTF), que contiene información de ayuda específica y varias codificaciones requeridas. puede estar compuesto por uno o más archivos;
(2) Archivo de proyecto de ayuda de edición (extensión .HPJ), este archivo contiene la información necesaria para compilar el archivo del tema
(3; ), edite el archivo del directorio de ayuda (extensión: .CNT), que contiene la información del marco del directorio de la ayuda
(4), edite y genere el archivo de ayuda (extensión: .HLP), este archivo; contiene diversa información de ayuda requerida por el sistema
(5) Escriba código en una aplicación (como VB, VFP u otro lenguaje de programación de alto nivel) para llamar al sistema de ayuda (WinHelp) para proporcionar información de ayuda; .
1. Editar archivos de temas de ayuda
1. Crear archivos en formato RTF
Word se usa generalmente para crear archivos RTF. Los archivos pueden contener texto, mapas de bits o. Los metarchivos pueden incluso incluir sonidos, animaciones, etc. Se deben tener en cuenta dos puntos: (1) Se debe insertar un salto de página después de que finalice un tema como demarcación entre temas (2) Al guardar el archivo del tema completo después de editarlo, se debe seleccionar RTF (Rico) en el "Tipo de archivo"; cuadro de lista Formato de texto), el archivo se guardará con la extensión .RTF y lo utilizará el compilador auxiliar.
2. Establecer notas al pie
Mueva el cursor al extremo izquierdo del tema, seleccione "Insertar | Notas al pie y notas finales" en el menú, seleccione "Notas al pie" y haga clic en "Personalizar". Marcadores de notas al pie" "Ingrese el símbolo de la nota al pie en " y luego presione la tecla Enter. Se activará la ventana de la nota al pie y luego ingrese el contenido de la nota al pie.
Los diferentes símbolos de notas al pie tienen diferentes significados. Los significados y símbolos comunes de las notas al pie se muestran en la Tabla 1:
Además, hay otras notas al pie. En todas las notas a pie de página, la cadena de identificación del sujeto (#) es obligatoria y otras notas a pie de página pueden ser opcionales según las circunstancias reales.
3. Establezca puntos de acceso y establezca conexiones entre temas
Otra codificación importante en el tema de ayuda es especificar "puntos de acceso" para el texto. Haga clic en el "punto caliente" con el mouse para saltar al tema correspondiente o abra una ventana de ayuda para proporcionar información de ayuda para el texto en el "punto caliente".
El primero se llama "Jump Hotspot", que aparece en forma de un subrayado único verde; el segundo se llama "Popup Hotspot", que aparece en forma de un subrayado de un solo punto verde.
(1) Especificar puntos de acceso de salto. Los puntos de acceso de salto son texto doble subrayado en los archivos de temas de ayuda. Primero seleccione el formato de doble subrayado del carácter. Luego escriba el texto del punto de acceso de salto, borre el formato de doble subrayado, seleccione el formato de texto oculto y escriba la cadena de identificación del tema en el destino del salto. Después de borrar el formato de texto oculto, escriba texto adicional. Nota: Al ajustar el texto después de ocultarlo, asegúrese de borrar primero el formato del texto oculto y luego presione la tecla Intro.
(2). Especificar puntos de acceso emergentes. Los puntos de acceso emergentes aparecen como texto subrayado en los archivos de temas de ayuda. Primero seleccione el formato de subrayado único del carácter, ingrese el texto del punto de acceso emergente, borre el formato de subrayado único, seleccione el formato de texto oculto y escriba la cadena de identificación del sujeto en el tema de descripción adicional emergente. Borre el formato de texto oculto antes de escribir otro texto. Del mismo modo, al ajustar el texto después de ocultarlo, asegúrese de borrar primero el formato del texto oculto y luego presione la tecla Intro.
Los dos textos de puntos de acceso anteriores pueden tener formato, como fuente, tamaño de fuente y diferentes estilos (negrita o cursiva). No debe haber espacios entre el texto oculto y el texto subrayado (simple o doble). El texto oculto se muestra como texto con puntos (cuando el botón "Ocultar|Mostrar" en la barra de herramientas de Word está resaltado, se puede mostrar el texto oculto).
Además del texto que puede tener características de punto de acceso, los gráficos también pueden tener las dos características de punto de acceso anteriores. Los puntos calientes en los gráficos solo se pueden especificar utilizando un software de herramienta especial: Hot Spot Editor.
4. Cree un área de título no desplazable
En la ventana de ayuda de Windows, a menudo puede ver que el área de título (a veces con gráficos) en la parte superior de la ventana es no desplazable. De esta forma, cuando se muestra un tema más extenso, el usuario siempre podrá ver el título del tema. Cuando utilice Word para crear un archivo de tema, puede lograr fácilmente las funciones anteriores utilizando los siguientes métodos.
Al editar cada tema, la primera línea suele ser el título del tema, luego pasa a otra línea y luego ingresa el texto principal del tema. En este momento, coloque el cursor en la primera línea y seleccione el comando "Párrafo" del menú "Formato". Word abrirá el cuadro de diálogo de formato de párrafo. En este cuadro de diálogo, seleccione la pestaña "Disposición del texto" y agrúpela. en "Salto de página". Utilice el mouse para seleccionar la casilla de verificación "En la página con el siguiente párrafo" y luego cierre el cuadro de diálogo Formato de párrafo. De esta manera, la primera fila se compilará en un área no desplazable. Por supuesto, el área no desplazable puede tener varias filas. En este caso, simplemente seleccione varias filas y luego configure el formato "misma página que el siguiente párrafo".
5. Uso de gráficos e imágenes
Los gráficos e imágenes utilizados en los archivos del tema de ayuda están en formato de mapa de bits (BMP). Se pueden utilizar los dos métodos siguientes para hacer referencia a gráficos de mapa de bits:
(1) Coloque directamente el mapa de bits en el archivo del tema. Dado que Word admite gráficos y texto mixtos, puede utilizar el método OLE para hacer referencia a gráficos o imágenes de otras aplicaciones o seleccionar el comando "Imagen" en el menú "Insertar" de Word para insertar directamente archivos gráficos en formato BMP.
(2) Utilice el método de indexación de mapa de bits. Es decir, si se agrega una de las siguientes declaraciones a la posición donde aparece el mapa de bits, se agregará el siguiente índice de mapa de bits al archivo de tema:
● {nombre de archivo gráfico bmc}: trata un mapa de bits como un carácter Procesamiento, la altura de la fila está determinada por el mapa de bits.
● {nombre de archivo gráfico bml}: el mapa de bits se coloca en el lado izquierdo de una línea y el texto se puede ajustar a la derecha.
● {nombre de archivo gráfico bmr}: el mapa de bits se coloca en el lado derecho de una línea y el texto se puede ajustar a la izquierda.
Entre ellos, se debe añadir el nombre del archivo de gráficos con la extensión BMP. Un mapa de bits se puede indexar en varios lugares. Cabe señalar que no proporcione el nombre de la ruta del archivo. Si necesita indicarle al compilador que busque archivos de mapa de bits en un directorio que no funciona en el momento de la compilación, puede proporcionar la ruta completa del mapa de bits en el campo [BITMAP] del archivo de proyecto de ayuda.
2. Cree un archivo de proyecto de Ayuda
El archivo de proyecto de Ayuda (extensión .HPJ) contiene todo lo que necesita el compilador de Ayuda de Microsoft para sintetizar archivos de temas y otros elementos en un archivo de Ayuda. información.
El archivo del proyecto es un archivo de texto sin formato que se puede crear con cualquier editor de texto u otras herramientas. Cada archivo de proyecto consta de una o más secciones. Cada sección tiene un nombre de sección, entre corchetes ([]), que define el propósito y el formato de las declaraciones y opciones de la sección. Por ejemplo:
(1), [OPCIONES]: Especifique opciones para controlar el proceso de creación. Esta sección es opcional, si se usa debe usarse en la primera sección.
(2), [FILES]: Especifica el archivo de tema de la ayuda, con una extensión de RTF. Esta sección es obligatoria y puede tener uno o más archivos de temas.
(3), [MAP]: conecte la cadena de contexto y el número de contexto para convertirse en ayuda relacionada con el contexto.
(4), [CONFIGS]: Especifica las macros utilizadas en la creación de archivos de ayuda. Estas macros son llamadas por el sistema de ayuda o utilizadas para crear menús y botones de ayuda no estándar. Por ejemplo, los botones """ y "" para pasar páginas hacia adelante y hacia atrás son creados por la macro especificada en este campo.
(5), [MAPAS DE BIT]: Especifique el nombre del archivo del mapa de bits al que se hace referencia en el archivo del tema, incluida su ruta.
(6), [WINDOWS]: Define el título, posición, tamaño y color de la ventana principal y ventanas secundarias utilizadas por el sistema de ayuda. En el archivo del tema de ayuda, si el diseño utiliza una ventana secundaria para saltar al tema, se debe incluir este párrafo.
Es muy intuitivo y conveniente utilizar el Taller de ayuda de Microsoft proporcionado por VFP para crear archivos de proyecto. Seleccione el menú Archivo|Nuevo, luego seleccione Proyecto de ayuda y aparecerá la pantalla para crear un archivo de proyecto de ayuda. .
3. Cree un archivo de directorio de ayuda
El archivo de directorio de ayuda proporciona una vista jerárquica de los temas en el sistema de ayuda. Puede crear fácilmente un archivo de directorio de ayuda mediante la edición visual. Función del Taller de ayuda de Microsoft. Seleccione el menú Archivo|Nuevo y luego seleccione Contenido de ayuda y aparecerá la pantalla para crear un archivo de directorio.
4. Compile y genere archivos de ayuda
Existen varias versiones del compilador de ayuda con diferentes funciones. Aquí, HCW en Microfoft Help Workshop se utiliza para la compilación. Seleccione el menú Archivo|Compilar en Microfoft Help Workshop para compilar. Si ocurre algún error durante el proceso de compilación, el sistema dará un mensaje de error para que el usuario pueda modificarlo hasta que sea correcto. Al compilar, el sistema solicitará información relevante sobre el sistema de ayuda. Si no hay errores fatales, el sistema compilará y generará un archivo de ayuda con la extensión HLP. Este también es un archivo binario al que puede llamar el sistema de ayuda de Windows. . Seleccione Archivo|Ejecutar Winhelp para disfrutar del sistema de ayuda generado.
5. Escriba código en la aplicación para llamar al sistema de ayuda (WinHelp) y proporcionar información de ayuda
En la aplicación, hay tres formas para que los usuarios accedan al sistema de ayuda:
(1). Menú de ayuda: un menú que se muestra en la barra de menú principal de la aplicación.
(2) Ayuda sensible al contexto: cuando se selecciona un objeto, control u opción de menú; y presionado La Ayuda se muestra cuando se presiona la tecla F1;
(3) Ayuda "¿Qué es esto?": un mensaje emergente simple que aparece cuando el usuario busca ayuda sobre un objeto o control específico.
A continuación se toma FVP como ejemplo para explicar cómo escribir código en la aplicación para llamar al sistema de ayuda.
1. Menú Ayuda
Para especificar un título de ayuda para un título de menú o comando de menú, debe incluir el comando SET TOPIC TO en el proceso asociado con el título de menú o menú, y luego use Ayuda para activar.
2. Ayuda contextual
La "Ayuda contextual" permite a los usuarios acceder a temas de ayuda relacionados con lo que hacen y ven en la aplicación en cualquier momento. Por ejemplo, si el usuario está viendo un formulario de entrada de datos, la ayuda contextual puede proporcionar temas de ayuda relacionados con ese formulario de entrada de datos.
Generalmente, puede acceder a la "ayuda contextual" presionando la tecla F1. También puede usar ON KEY LABEL para especificar cualquier tecla para activar la "ayuda contextual".
Al utilizar la Ayuda contextual en formularios, debe especificar un archivo de Ayuda para su aplicación y luego asociar temas de Ayuda específicos con diferentes objetos en la aplicación.
Los pasos para agregar "ayuda contextual" son los siguientes:
(1) Especifique un archivo de ayuda para la aplicación.
Si el comando SET HELP TO FILE (donde ARCHIVO es el nombre del archivo de ayuda) está incluido en el código, se puede seleccionar el archivo de ayuda al que puede acceder la aplicación. Por ejemplo, si el archivo de ayuda se llama MYHELP.HLP, puede utilizar el siguiente comando:
SET HELP TO MYHELP.HLP
Este comando generalmente se incluye en el programa principal de su aplicación en el código de configuración.
(2) Especifique un tema de ayuda para el objeto al que desea proporcionar "ayuda contextual".
1) Abra el objeto para el cual desea especificar la función de "ayuda contextual" en el estado "Diseño", como un formulario, control o barra de herramientas; 2) Ver los atributos del objeto;
3) Establecer el atributo HelpContextID en la codificación que representa un tema específico en el archivo de ayuda.
3. Ayuda "¿Qué es esto?"
La ayuda "¿Qué es esto?" es similar a la ayuda contextual en el sentido de que proporciona ayuda para el objeto o control específico que se encuentra actualmente. tiene foco. Pero en lugar de mostrar el tema de ayuda en la ventana de Ayuda de tamaño predeterminado después de activar la ayuda, la ayuda "¿Qué es esto?" muestra el tema de ayuda en una pequeña ventana emergente que aparece cuando el usuario hace clic en cualquier lugar de la pantalla.
La ayuda "¿Qué es esto?" es útil cuando se proporcionan descripciones sencillas o definiciones de controles específicos, porque el tema de ayuda "¿Qué es esto?" es conciso y preciso, y la ventana no se vuelve demasiado grande. Enmascare la característica que el usuario está describiendo.
Para asociar WhatsThisHelpID con un formulario, control de formulario o barra de herramientas específicos, establezca su propiedad WhatsThisHelpID en una codificación que represente un tema específico en la ayuda.
Utilice las propiedades que se muestran en la Tabla 2 para implementar la función de ayuda "¿Qué es esto?".
Si desea implementar la ayuda "¿Qué es esto?", debe hacer lo siguiente:
(1) Abra el programa que desea habilitar "¿Qué es esto?" en modo de diseño? Formulario;
(2) Establezca el atributo WhatsThisHelp del formulario en "Verdadero" (.T.); ? "Botón de ayuda, puede establecer la propiedad WhatsThisButton del formulario en "True" (.T.);
(4), asocie un tema de ayuda "¿Qué es esto?" con el formulario. puede establecer el atributo WhatsThisHelpID del formulario en el código de identificación correspondiente al tema en la ayuda.
(5) Para asociar un tema de ayuda "¿Qué es esto?" con un control específico en el formulario; debe establecer su propiedad WhatsThisHelpID en la codificación de ID correspondiente al tema en la ayuda después de seleccionar el control.
4. Utilice la función WinHelp
Otra forma de utilizar la ayuda a través de la programación es llamar a la función WinHelp. La función WinHelp solo está disponible en la plataforma Windows y forma parte de la interfaz de programación de aplicaciones (API) de Windows.
Los pasos para utilizar la función WinHelp son los siguientes:
(1) Defina los parámetros del comando que pasará su aplicación.
Consulte los parámetros de wCmd más adelante para obtener una descripción de estos parámetros.
(2) Utilice SET LIBRARY TO para configurar la biblioteca y definir las variables que se utilizarán. Este trabajo generalmente se completa en el código de inicialización del archivo principal de la aplicación.
ESTABLECER BIBLIOTECA EN SYS (2004) + ADITIVO “FOXTOOLS.FLL”
Ayuda=RegFn(“Ayuda”,“LCIC”, “I”)
La biblioteca debe estar configurada en FOXTOOLS.FLL. SYS (2004) devuelve el directorio raíz de Visual FoxPro donde está instalado FOXTOOLS.DLL.
Si desea enviar la palabra clave K para abrir un tema de ayuda, puede usar RegFn() para definir una variable (como la variable de Ayuda en el ejemplo anterior). Si desea abrir un tema de ayuda asignado con una codificación, use RegFn para definir una variable similar a la Ayuda en el ejemplo anterior, reemplazando la cadena en dwData con una codificación. Si se van a pasar codificaciones, se deben asignar en la sección [MAP] del archivo .HPJ con una cadena de contexto única definida en el pie de página de la marca de codificación (#).
(3) Utilice CallFn() para llamar a la función.
El siguiente código utiliza CallFn() para abrir el tema de ayuda. El código contiene la palabra clave del tema.
#define HELP_KEY 0x0101
wCmd=HELP_KEY
cFileName=HOME()+"Miprograma\Miayuda.hlp"
dwData= "AGREGAR elementos de menú en tiempo de ejecución"
CallFn(Help,MainNWND(),cFileName,wCmd,dwData)
Para obtener más detalles sobre las funciones de FoxTools, consulte VFP, HERRAMIENTAS directorio del archivo FOXTOOLS.HLP.
(4) Especificar los parámetros de WinHelp
Los siguientes parámetros especifican las opciones de parámetros de la función WinHelp.
1) Parámetro hWnd
El parámetro hWnd identifica la ventana que solicita ayuda. La ayuda utiliza este identificador para rastrear qué aplicación ha solicitado ayuda. Utilice la función MainHWND() contenida en la biblioteca FOXTOOLS.FLL en Visual FoxPro para pasar el parámetro hWnd.
2) Parámetro lpzFileName
El parámetro lpzFileName es una cadena de campo que especifica la ruta válida y el nombre del archivo que contiene ayuda sobre el tema requerido. Se pasa por valor.
3) Parámetro wCmd
El parámetro wCmd especifica el tipo de búsqueda del usuario para un tema específico o indica que la aplicación ya no necesita ayuda. Se puede establecer en cualquiera de los valores de la Tabla 3.
4) Parámetro dwData
El parámetro dwData representa el tema que la aplicación necesita encontrar. Su contenido y formato dependen del valor wCmd pasado cuando la aplicación llama a la función WinHelp.
Pase el parámetro dwData por valor en la mayoría de las llamadas de ayuda, que es la configuración predeterminada para Visual FoxPro.
Dependiendo de la configuración del entorno, el dwData en la línea anterior representa una cadena de texto que indica la palabra clave que se encontrará o un valor numérico que indica la codificación de contexto que identifica un tema específico.
La Tabla 4 enumera el formato dwData correspondiente a cada valor de wCmd.
Debido a que WinHelp puede especificar una codificación de contexto o una palabra clave, puede admitir "ayuda sensible al contexto" y buscar temas en la ayuda.
Nota: Si el sistema de ayuda contiene más de dos índices, uno de ellos debe designarse como índice predeterminado en la aplicación. Para garantizar que se establezca el índice correcto, wCmd debe configurarse en HELP_SETINDEX (donde dwData especifica el identificador de contexto correspondiente) cuando la aplicación llama al sistema de ayuda. Cada llamada de ayuda debe ir seguida de la configuración del comando HELP_CONTEXT.
Nunca utilice HELP_SETINDEX junto con HELP_INDEX.
(5). Conservar la función de la tecla F1
Cuando el usuario presiona la tecla F1 en la aplicación, Vlsual FoxPro mostrará un tema de "ayuda contextual". Para ello, especifique un valor de ID relacionado con la Ayuda en la tabla de ayuda para el tema que requiere "ayuda contextual" y asigne este valor a la propiedad HelpContextID del formulario o control. De esta manera, cuando el formulario o control recibe el foco y el usuario presiona la tecla F1, Vlsual FoxPro se adapta al tema.
(6). Incluir un botón de "Ayuda" en el formulario.
Agregar un botón de Ayuda a su formulario facilita a los usuarios el acceso a la información de ayuda. Si el usuario es nuevo, debería considerar agregar un botón de "Ayuda" al formulario.
Para configurar la ayuda contextual y agregar un botón "Ayuda", debe hacer lo siguiente:
1) En el evento Init del formulario, establezca el atributo HelpContextID de todos Los objetos del formulario se establecen en el valor de ID del tema de ayuda. Por ejemplo, si el valor es 7, puede utilizar el siguiente comando:
THIS.SetALL("HelpContextID",7)
2) Agregue un botón de comando al formulario.
3) Establezca la propiedad Título del botón de comando en "Ayuda".
4) Agregue el siguiente comando en el evento Click del botón de comando:
HELP ID THIS.HelpContextID
Para mayor comodidad, el botón "Ayuda" puede guardarse como una clase para que pueda agregarse fácilmente a cualquier formulario.
(7) Salir de la ayuda gráfica.
El sistema de ayuda es el recurso más compartido para todas las aplicaciones de Windows. Como también es una aplicación independiente, los usuarios pueden ejecutarla como cualquier otra aplicación. De esta forma, tu aplicación tiene un control limitado sobre el sistema de ayuda.
Aunque su aplicación no puede cerrar la ventana del sistema de ayuda directamente, puede notificar al sistema de ayuda que ya no necesita ayuda. Antes de cerrar la ventana principal, su aplicación debe configurar el parámetro wCmd en HELP_QUIT para notificar a la Ayuda que su aplicación ya no la necesita.
Si la aplicación llama al sistema de ayuda en algún momento durante su ejecución, el parámetro wCmd debe establecerse en HELP_QUIT antes de finalizar la aplicación.
Si una aplicación tiene más de un sistema de ayuda abierto, debe llamar a la función WinHelp para cada archivo de ayuda para salir de su sistema de ayuda. Si una aplicación o biblioteca de vínculos dinámicos (DLL) ha abierto un sistema de ayuda pero no desea que la instancia asociada del sistema de ayuda permanezca activa, la aplicación o DLL debe configurar el parámetro wCmd en HELP_QUIT para que pueda salir del sistema de ayuda. Ejemplo.
Descripción: Antes de finalizar, una aplicación o DLL debe llamar al archivo de ayuda de cualquier sistema de ayuda abierto. Cada vez que se llama a un archivo de ayuda con el nombre de ayuda, se abre el sistema de ayuda correspondiente.
El sistema de ayuda se cerrará sólo después de que todas las ventanas que llaman a ayuda hayan configurado wCmd en HELP_QUIT. Si una aplicación no logra hacer esto, el sistema de ayuda continuará ejecutándose incluso después de que todas las aplicaciones que solicitan ayuda hayan finalizado.
La introducción anterior es el método básico para crear el sistema de ayuda de Windows95/98. De hecho, ha habido muchas herramientas de software utilizadas específicamente para crear sistemas de ayuda. Sus principales similitudes son la visualización, WYSIWYG, procesamiento integrado, etc. Su interfaz operativa es similar a Word y, en general, agregan su propio diseño visual que se puede realizar a través de barras de herramientas. y elementos de menú, y puntos de acceso de salto, puntos de acceso emergentes, puntos de acceso gráficos, etc. se pueden crear fácilmente, y el archivo de ayuda también se puede imprimir en un libro.