Club Builder

[morelo]

Wenas a todos, tengo un probelma para enlazar la ayuda en un proyecto, tengo el fichero de ayuda creado, lo he insertado en mi proyecto, pero no se como enlazar cada apartado de mi programa con su pagina de la ayuda correspondiente. Lo unico que se es Application->HelpCommand(HELP_CONTENTS, 0) que te lleva a la pagina indice de la ayuda, pero no se el codigo para que te lleve a la pagina que se llama por ejemplo "Modificar Datos" de la ayuda (*.hlp). Se que hay funciones como HelpContext() o HelpKeyWord(), etc pero no termino de comprender como usarlas.

a ver si alguien me exa un cable

asiasssssss

[Josh]

Hola. Para que durante la ejecución del programa se muestre la ayuda correspondiente al componente que está enfocado (tiene el control) o a un tema específico, se debe crear un archivo .map en el proyecto del archivo de ayuda en el Microsoft Help Work Shop. Puedes hacerlo en block de notas, por ejemplo. En este archivo .map se definen valores numéricos para cada uno de los nombres de las páginas que conforman el archivo de ayuda, por ejemplo, si el archivo de ayuda se compone de las páginas IDH_PRESENTACION, IDH_ARCHIVO y IDH_HERRAMIENTAS, el archivo .map podría quedar de la siguiente manera:

#define IDH_PRESENTACION 1
#define IDH_ARCHIVO 2
#define IDH_HERRAMIENTAS 3

Cada una de estos ítems corresponden a los nombres de las páginas de la ayuda que se colocan en los archivos .rtf anteponiéndoles la marca #. Este archivo .map lo añades en el proyecto en el Microsoft Help Work Shop utilizando el botón Map… . Una vez hecho esto compilas el proyecto.

Para enlazar la ayuda desde el builder puedes hacerlo de varias formas:
La primera es incluyendo el archivo .map de la siguiente forma:

#include “Mi_Archivo.map”

y para ver la ayuda correspondiente a cada tópico llamas la siguiente función:
Application->HelpContext( IDH_PRESENTACION );
o también
Application->HelpContext(IDH_HERRAMIENTAS );

Incluso con los valores numéricos también funciona
Application->HelpContext( 1 );

La segunda forma es modificar las propiedades en el inspector de objetos de cada componente, por ejemplo, para un TEdit debes poner:

Edit1->HelpContext = 1 ;
Edit1->HelpType = htContext ;

De esta forma cuando este objeto tenga el control y se presione F1, la ayuda mostrará la página de la presentación (porque #define IDH_PRESENTACION 1). Esto lo tienes que repetir para cada uno de los componentes de la forma.

Otra forma de desplegar una página específica del archivo de ayuda es llamar el siguiente método:

Application->HelpKeyword("Menú Archivo");

De esta forma se despliega la ayuda correspondiente al Menú Archivo.

Espero que esta información te pueda servir y te funcione.
Puedes encontrar ayuda en http://www.codepedia.com/1/CppBuilderHelp

Saludos.
_________________
Jaime Alberto López R.
www.geocities.com/jaimealopezr

[morelo]

ok, me ha servido de mucho

gracias

[bosoft]

Hola Josh:
He intentado seguir las instrucciones que explicas, y no hay forma. Me salta el error: No context-sensitive help installed.
El código de llamada (por clic en un botón y no por F1) es:

[Cesar C. Salazar Gonzalez]

Hola aun que puede variar un poco la información de como generar la ayuda yo lo he realizado de la siguiente Manera sin ningún problema pues el programa funciona correctamente y muestra la ayuda dependiendo de su contexto.

Los pasos son
1- Generar un archivo de ayuda al estilo de Windows XP esto es crear el programa de ayuda con el siguiente Software que permite crear archivos de ayuda estilo Windows XP y Windows Vista enlace, o si prefieres la descarga usa el siguiente enlace (nota: el programa es funcionable por 14 dias pero creo que son suficientes para crear tu proyecto) a parte es un software ideado para Delphi y C++ Builder

2.- despues de haber generado el archivo .chm con sus correspondientes apartados, espesifícas la dirección donde se encuentra tu proyecto.

3.- En el proyecto al cual le vas a establecer la ayuda, realizas lo siguiente: a).- Abres el Menu Proyect y te vas a Options. b).- dentro de la parte de Application y en Application Settings "buscas" el archivo de ayuda que esta dentro del mismo directorio del ejecutable (paso 2) y lo estableces en: Help File:

4.- Dentro de tu código realizas las siguientes modificaciones en cada uno de los archivos donde deseas ver la ayuda, buscas en la parte del inspector de objetos la propiedad HelpContext del Formulario o Componente y asiganle el numero que identifica la parte de la ayuda (HelpContext = 1) echa con el programa del paso 1 el manual tambien lo puedes ver en esta dirección.

y el en los archivos .CPP estableces este codigo

[bosoft]

Gracias Cesar por tu respuesta, pero acabas de darme la solución a mi problema y me he dado cuenta leyendo las news de borland.