PC SOFT

AYUDA EN LÍNEA
DE WINDEV, WEBDEV Y WINDEV MOBILE

Este contenido proviene de una traducción automática.. Haga clic aquí para ver la versión original en inglés.
  • Panorama general
  • Desarrollo de un componente externo
  • señalar
  • Creación de un componente externo
  • Opciones avanzadas del componente externo
  • Modificación de las opciones avanzadas de los componentes
  • Derechos de acceso del componente en los elementos de aplicación que utilizan el componente.
  • peinar: Modo para gestionar las plantillas de skin en los elementos componentes.
  • Generación de un componente externo
  • Creación de un componente externo existente
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Otros
Procedimientos almacenados
Panorama general
Se debe crear un componente a partir de un proyecto que contenga todos los elementos necesarios para que el componente funcione.. Le recomendamos que utilice un proyecto específico para desarrollar cada componente externo.
La creación de un componente externo se realiza en varios pasos:
  1. Desarrollo de los elementos del componente externo.
  2. Creación del componente externo.
  3. Definición de las opciones avanzadas del componente externo.
  4. Generación del componente externo.
A continuación, el componente externo puede distribuirse y reutilizarse.. Vea Distribución de un componente externo y Utilización de un componente externo en una aplicación para más detalles.
señalar: A partir de la versión 19, HFSQL es el nuevo nombre de HyperFileSQL.
Desarrollo de un componente externo
El desarrollo de un componente externo se realiza a partir de un proyecto WINDEV, WEBDEV o WINDEV Mobile.. Le recomendamos que utilice un proyecto específico para desarrollar cada componente externo.
A la hora de desarrollar los diferentes elementos de un componente externo deben tenerse en cuenta los siguientes puntos:
  1. Comentarios sobre el código
    Al desarrollar los elementos del componente externo, no olvide insertar comentarios en su código. Estos comentarios se utilizarán para crear la documentación de su componente. Estos comentarios proporcionarán ayuda a los usuarios de sus componentes. Ver Documentación automática de los componentes para más detalles.
    Si estos comentarios no se encuentran en su códigoLos elementos accesibles del componente se documentarán automáticamente especificando los parámetros de entrada/salida esperados por cada elemento..
    Por ejemplo:
    Description of input/output parameters of 'Window1':
    Parameters:
    Param1: <specify the role of Param1>
    Return value:
    None
  2. Declaración y visibilidad de los elementos
    Dependiendo del modo de declaración de los elementos (clases, procedimientos, conjuntos de procedimientos), los elementos serán más o menos accesibles para el usuario del componente externo.. Ver Visibilidad del elemento que se encuentra en un componente externo para más detalles.
    señalar: Si un componente externo utiliza un análisis y archivos de datos, las funciones HFSQL manipular estos elementos en un contexto HFSQL independiente. Este modo de funcionamiento se puede modificar en las opciones avanzadas del componente.
  3. Para ejecutar, desde el componente externo, un procedimiento del proyecto que aloja el componente externo, utilice ExecuteProcess con la constante trtProjectProcedure.

señalar

Un componente externo puede incluir clases en su interfaz. Usted tiene la capacidad de derivar estas clases en el proyecto anfitrión, para sobrecargar los métodos virtuales, para proporcionar polimorfismo. La herencia está disponible entre varios niveles de componentes externos.
Creación de un componente externo
Para crear un componente externo:
  1. Seleccione "Taller .. Componente externo... Define un nuevo componente de este proyecto". Se inicia el asistente para crear el componente externo..
    Nota: Si no ha creado una configuración de proyecto específica para la creación de un componente externo, se inicia el asistente para crear una configuración de proyecto.. Para optimizar la organización de sus proyectos, le aconsejamos que utilice las configuraciones de proyecto. Ver Configuración del proyecto para más detalles.
    En este caso, el asistente pregunta por:
    • el nombre y la descripción de la configuración del proyecto.
    • las opciones de compatibilidad de la configuración:
      • Multiproducto: El componente externo se generará para un tipo específico de proyecto o para su uso en todos los productos (WINDEV, WEBDEV y WINDEV Mobile)..
      • Plataforma: Los errores de compilación se pueden habilitar (o no) para la compatibilidad con 64 bits o con Linux..
    • los elementos incluidos en la configuración del proyecto.
  2. Se inicia el asistente para generar un componente externo.
  3. En el asistente para crear el componente externo:
    • Especifique el nombre y el título del componente externo.
    • Seleccione los elementos del proyecto actual necesarios para que funcione el componente externo.
    • Para cada elemento del componente externo, especifique si este elemento debe ser accesible desde el proyecto que está utilizando el componente externo.. Si el elemento es accesible, el desarrollador (del proyecto que está utilizando el componente externo) podrá utilizar el elemento como cualquier otro elemento del proyecto.. Vea Visibilidad del elemento que se encuentra en un componente externo para más detalles.
  4. Validar. Se crea el componente externo. Para distribuirla, debe ser generada de antemano.
    El componente externo puede generarse inmediatamente. Esta opción se recomienda si todos los elementos del componente externo han sido desarrollados, comprobados y están listos para ser distribuidos.
Para crear un componente externo:
  1. Crear una configuración de proyecto para el componente externo: en el panel "Proyecto", en el grupo "Configuración del proyecto", ampliar "Nueva configuración" y seleccionar "Componente externo (.WDK)".. Se inicia el asistente para crear una configuración de proyecto y pregunta por:
    • el nombre y la descripción de la configuración del proyecto.
    • las opciones de compatibilidad de la configuración:
      • Multiproducto: El componente externo se generará para un tipo específico de proyecto o para su uso en todos los productos (WINDEV, WEBDEV y WINDEV Mobile)..
      • Plataforma: Los errores de compilación se pueden habilitar (o no) para la compatibilidad con 64 bits o con Linux..
    • los elementos incluidos en la configuración del proyecto.
  2. Desarrollar el componente externo.
Para distribuirla, debe ser generada de antemano. Ver Generación de un componente externo para más detalles.
Opciones avanzadas del componente externo
Las opciones avanzadas del componente externo se utilizan para definir:
  • los derechos de acceso del componente en los elementos de aplicación que utilizan el componente.
  • el modo de gestión de las plantillas de skin en los elementos componentes.

Modificación de las opciones avanzadas de los componentes

Para modificar las opciones avanzadas de los componentes:
  1. Seleccione "Taller .. Componente externo .. Lista de componentes generados a partir de este proyecto".En el panel "Proyecto", en el grupo "Proyecto", expanda "Lista de elementos" y seleccione "Lista de componentes generados".
  2. Seleccione el componente.
  3. Haga clic en el botón "Opciones...".

Derechos de acceso del componente en los elementos de aplicación que utilizan el componente.

Tres posibilidades:
  • el componente y su aplicación host utilizan contextos independientes (opción predeterminada):
    El componente no puede manipular los archivos de datos o los elementos del proyecto anfitrión.
    Versiones 15 y posteriores
    También puede definir el contexto de tiempo de ejecución del componente en el proyecto principal.. El contexto de tiempo de ejecución puede ser:
    • Global. En este caso, se utilizará el mismo contexto si el componente externo es cargado por el proyecto y por otro componente externo del proyecto.
    • aislado (por defecto). En este caso, si el mismo componente es cargado por el proyecto y por un componente del proyecto, cada componente utilizará un contexto específico.
    Nueva funcionalidad versión 15
    También puede definir el contexto de tiempo de ejecución del componente en el proyecto principal.. El contexto de tiempo de ejecución puede ser:
    • Global. En este caso, se utilizará el mismo contexto si el componente externo es cargado por el proyecto y por otro componente externo del proyecto.
    • aislado (por defecto). En este caso, si el mismo componente es cargado por el proyecto y por un componente del proyecto, cada componente utilizará un contexto específico.
    También puede definir el contexto de tiempo de ejecución del componente en el proyecto principal.. El contexto de tiempo de ejecución puede ser:
    • Global. En este caso, se utilizará el mismo contexto si el componente externo es cargado por el proyecto y por otro componente externo del proyecto.
    • aislado (por defecto). En este caso, si el mismo componente es cargado por el proyecto y por un componente del proyecto, cada componente utilizará un contexto específico.
  • el componente solo puede manipular los archivos de datos de la aplicación host. En este caso, los contextos HFSQL serán idénticos.
  • el componente está autorizado a to manipular los ficheros de datos de la aplicación host así como sus elementos (ventanas, informes,...). En este caso, los contextos de tiempo de ejecución serán idénticos.
¿Cuándo se debe permitir que el componente manipule archivos de datos de la aplicación host?
Por ejemplo, si la aplicación contiene una aplicación principal y algunas opciones suministradas como componentes. En este caso, los componentes manipular los ficheros de datos de la aplicación principal.
Nota: Si el componente está permitido en manipular los archivos de datos y si tiene su propio análisis, el análisis del componente será ignorado.. El componente utilizará el análisis del proyecto anfitrión.
En nuestro ejemplo, al desarrollar un componente, este componente puede asociarse con el análisis de la aplicación principal. Por lo tanto, no hay necesidad de utilizar las declaraciones externas a manipular los ficheros de datos. Además, la finalización se realizará automáticamente en el editor de código.
Vea Contexto HFSQL para más detalles.

peinar: Modo para gestionar las plantillas de skin en los elementos componentes.

Por defecto, el plantilla del proyecto anfitrión se puede aplicar a los diferentes elementos del componente externo. Vea Plantilla para más detalles.
comentario:
  • La pestaña "Estilo" de las opciones del componente externo se utiliza para permitir (o no) que el proyecto cliente aplique la plantilla..
  • Versiones 23 y posteriores
    Para evitar la aplicación del plantilla del proyecto cliente a una ventana de componente externo:
    1. Visualizar la ventana de descripción del componente.
    2. En la pestaña "Estilo", compruebe "Mantener siempre el estilo inicial/plantilla".
    3. Validar.
    Nueva funcionalidad versión 23
    Para evitar la aplicación del plantilla del proyecto cliente a una ventana de componente externo:
    1. Visualizar la ventana de descripción del componente.
    2. En la pestaña "Estilo", compruebe "Mantener siempre el estilo inicial/plantilla".
    3. Validar.
    Para evitar la aplicación del plantilla del proyecto cliente a una ventana de componente externo:
    1. Visualizar la ventana de descripción del componente.
    2. En la pestaña "Estilo", compruebe "Mantener siempre el estilo inicial/plantilla".
    3. Validar.
Generación de un componente externo
Un componente externo puede distribuirse y reutilizarse una vez generado.. La generación del componente externo se utiliza para crear los ficheros necesarios para distribuir el componente externo..
Esta generación puede ser realizada:
  • al crear el componente externo.
  • en cualquier momento:
    • a través de "Workshop .. Componente externo... Generar un componente",
    • de la lista de componentes que se encuentran en el proyecto ("Workshop .. Componente externo .. Lista de componentes generados a partir de este proyecto").
Esta generación puede realizarse en cualquier momento:
  • desde la configuración del proyecto del componente:
    • en el panel "Proyecto", en el grupo "Generación", haga clic en "Generar"..
    • en los botones de acceso rápido, haga clic en el icono para generar el componente:
  • de la lista de componentes encontrados en el proyecto: En el panel "Proyecto", en el grupo "Proyecto", amplíe "Lista de elementos" y seleccione "Lista de componentes generados".. Seleccione el componente y haga clic en "Generar".
Nota: Si se ha modificado el componente externo, se debe volver a generar antes de que se pueda volver a distribuir.. Vea Modificación de un componente externo para más detalles.

Creación de un componente externo existente

Para generar un componente externo existente:
  1. Seleccione "Taller .. Componente externo... Generar un componente".Visualizar la configuración del proyecto del componente; a continuación, en el panel "Proyecto", en el grupo "Generación", haga clic en "Generar"..
  2. Se inicia el asistente para generar el componente externo..
  3. Seleccione (si es necesario) el nombre del componente externo a generar.
  4. Seleccione los elementos del proyecto actual necesarios para que funcione el componente externo.
  5. Para cada elemento del componente externo, especifique si este elemento debe ser accesible desde el proyecto que está utilizando el componente externo.. Si el elemento es accesible, el desarrollador (del proyecto que está utilizando el componente externo) podrá utilizar el elemento como cualquier otro elemento del proyecto.. Vea Visibilidad del elemento que se encuentra en un componente externo para más detalles.
  6. Especificar si se puede traducir el componente externo. Si la opción "Permitir traducir el componente" está marcada, seleccione los diferentes elementos del componente externo que se van a traducir. Los elementos marcados pueden ser traducidos, mientras que los elementos no marcados no serán propuestos para su traducción..
    Ver Traducción de un componente externo para más detalles.
  7. Seleccione los idiomas soportados por el proyecto que deben incluirse en el componente externo.. Cuanto menor sea el número de idiomas soportados por el componente externo, menor será el tamaño del componente externo..
  8. Si los componentes se encuentran en el proyecto, estos componentes pueden incluirse en el componente que se genera actualmente (componentes anidados, por ejemplo).
  9. Especifique si se debe modificar el número de versión del componente externo (al modificar un componente externo).. Vea Modificación de un componente externo para más detalles.
  10. Especifique (si es necesario) la información sobre el componente externo.: Propietario, leyenda, derechos de autor, ... La información será visible:
    • al incluir el componente externo en un proyecto WINDEV o WEBDEV.
      Esta información también se muestra en la descripción del componente externo, accesible desde el panel "Asistentes, ejemplos y componentes" ("Descripción" desde el menú emergente del componente)..
    • en las propiedades de los archivos WDI y WDK en el explorador de Windows (pestaña"PC SOFT").
  11. Seleccione la imagen del componente externo. Esta imagen se utilizará en el explorador de Windows y en el panel "Asistentes, ejemplos y componentes.
    Recordatorio: Los componentes que se encuentran en el ordenador actual son accesibles desde el panel "Asistentes, Ejemplos y Componentes" (opción"Componentes").. Vea Gestionar los componentes desde el panel "Asistentes, ejemplos y componentes para más detalles.
    Seleccione la imagen del componente externo. Esta imagen se utilizará en el explorador de Windows.
  12. Escriba el resumen general del componente externo.
    Esta vista general se mostrará automáticamente en WINDEV cuando el componente externo que se encuentra en el panel "Wizards, Examples and Components" (Asistentes, Ejemplos y Componentes) se encuentre sobre el cursor del ratón..
    Recordatorio: Los componentes que se encuentran en el ordenador actual son accesibles desde el panel "Asistentes, Ejemplos y Componentes" (opción"Componentes").. Vea Gestionar los componentes desde el panel "Asistentes, ejemplos y componentes para más detalles.
    Escriba el resumen general del componente externo.
    Este resumen general se incluirá automáticamente en la descripción del componente externo..
  13. El asistente de generación presenta automáticamente la documentación técnica asociada al componente externo..
    Vea Documentación automática de los componentes para más detalles.
  14. Especificar si se debe generar un sistema de ayuda (en formato CHM). Este sistema de ayuda se copiará junto al componente. Este sistema de ayuda contiene la documentación técnica del componente externo.
  15. Especifique si se permite la entrada de UMC (User Macro-Code). Vea Gestión de los macrocódigos de usuario para más detalles.
  16. Especifique si el componente externo debe:
    • Ser publicado en un directorio de la SCM. Esta opción se utiliza para poner el componente externo a disposición de los proyectos de SCM. Vea componente externo y SCM para más detalles.
    • Guardarse en el centro de reutilización. En este caso, se puede poner a disposición de los demás desarrolladores (tanto si utilizan SCM como si no)..
  17. Especifique el nombre físico del componente externo. Este nombre se asignará a los ficheros correspondientes al componente externo.
  18. Validar. Se genera el componente externo.
Los siguientes archivos se crean en el directorio EXE del proyecto actual:Los siguientes ficheros se crean en el directorio de generación de la configuración del proyecto:
<Nombre del componente>.WDKEste fichero contiene todos los elementos que deben distribuirse (ventanas, informes,...).
Este archivo es necesario cuando se despliegan aplicaciones que utilizan el componente externo.
<Nombre del componente>.WDIInterfaz del componente externo. Este archivo contiene:
  • una ayuda para utilizar el componente externo cuando se vuelve a facturar.
  • los elementos necesarios para utilizar el componente externo en el proyecto (información de compilación, ....).
Atención: La generación del componente externo puede ser bastante larga si el componente externo contiene varios elementos accesibles.
Versión mínima requerida
  • Versión 9
Esta página también está disponible para…
Comentarios
Haga clic en [Agregar] para publicar un comentario