AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / Desarrollar una aplicación o un sitio web / Componente / Componente externo
  • Presentación
  • Incluir el componente en el proyecto
  • Incluir el componente en un proyecto
  • Archivos copiados automáticamente cuando el componente se incluye en un proyecto
  • Manejar los elementos de los componentes a través de la programación
  • Observación: la documentación técnica sobre el componente
  • Conflictos de nombres
  • Usando un componente Procedure en la compilación dinámica
  • Clases y componentes
  • Actualización de un componente
  • Desplegar una aplicación que utiliza un componente
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Presentación
Un componente externo puede reutilizarse en cualquier momento en cualquier aplicación: sólo necesita conocer el directorio que contiene los archivos de los componentes externos.
Esta página de ayuda explica cómo hacerlo:
Incluir el componente en el proyecto

Incluir el componente en un proyecto

Para incluir un componente en un proyecto:
  1. Abra el proyecto en WINDEV, WEBDEV o WINDEV Mobile.
  2. En la pestaña "Proyecto", en el grupo "Proyecto", despliegue "Importar" y seleccione "Un componente externo .. Desde un archivo". Un selector de archivos se abre.
  3. Seleccione el fichero WDI del componente a importar. Dependiendo del modo de distribución seleccionado, se puede encontrar este archivo:
    • en el directorio de creación del componente si el equipo donde se crea el componente y el equipo donde se utiliza el componente son idénticos,
    • en el directorio donde se han puesto a disposición los archivos de componentes,
    • en el directorio donde la instalación Procedure del componente ha copiado los archivos del componente.
      Para obtener más información, consulte Distribución de un componente.
  4. Validar. Aparece la ventana de description del componente seleccionado. Esta ventana presenta:
    • el componente description (compañía, versión, ...).
      Tiene la posibilidad de elegir el modo de carga del componente (al iniciar el proyecto o al utilizar un elemento de componente por primera vez).. Por Default, el componente se carga cuando un elemento del componente se utiliza por primera vez.
    • la documentación del componente. Esta documentación explica cómo utilizar los diferentes elementos del componente.
  5. Validar. Los elementos de los componentes accesibles y utilizables se muestran en el panel "Explorador de proyectos. Una Icon específica indica que el elemento proviene de un componente.

Archivos copiados automáticamente cuando el componente se incluye en un proyecto

Cuando se incluye un componente en el proyecto, todos los archivos requeridos por el componente se copian automáticamente en el directorio del proyecto:
  • El archivo <nombre del componente>.WDI se copia en el directorio del proyecto.
  • El archivo <nombre del componente>.WDK se copia en el subdirectorio EXE del proyecto.
  • Si se han especificado algunos archivos en el archivo opcional (<nombre del componente>.WDO), estos archivos se copian en el directorio EXE del proyecto (respetando la estructura de árbol especificada en el archivo WDO).
Manejar los elementos de los componentes a través de la programación
Los elementos de Visible de un componente incluido en un proyecto pueden manejarse únicamente mediante programación.
Para manipular un elemento componente (ventana, etc.) a través de la programación, manipular el elemento como cualquier otro elemento creado en el proyecto.
  1. Véase la documentación sobre el elemento.
    Para ello, realice una de las siguientes operaciones:
    • Haga doble clic en el elemento del panel "Explorador de proyectos".
    • pulsar F2 desde el código del elemento.
  2. La documentación del elemento se visualiza en el editor de código. Esta documentación presenta los parámetros necesarios para la utilización del elemento (parámetros de entrada/salida, ....).
  3. Utilizar el elemento según la información especificada en la documentación como si este elemento perteneciera al proyecto..
    • Para abrir una ventana, utilice entablar y pase (si es necesario) los parámetros esperados por esta ventana.
      Open(ComponentWindow [, Param1, Param2])
    • Para imprimir un reporte, utilice iPrintReport y pase (si es necesario) los parámetros esperados por este reporte.
      iPrintReport(ComponentReport [, Param1, Param2])
    • Para llamar a una Procedure, utilice la sintaxis habitual.
      ComponentProcedure(Param1,Param2)
    • Para usar una clase, declare una Variable del tipo de clase.
      MyVariable is object ComponentClass

      La variable se utiliza como cualquier otra variable de objeto.
Si se produce un conflicto con un elemento del proyecto, el nombre del elemento debe ir precedido del nombre del componente. Por ejemplo:
Open(MyComponent.MyWindow)
Para usar el nombre del elemento en una Variable, el nombre del componente debe ser especificado. Por ejemplo:
sWindow is string = "MyComponent.MyWindow"
Open(sWindow)
No se requiere ninguna función WLanguage específica para manipular el componente.

Observación: la documentación técnica sobre el componente

La documentación técnica del componente está disponible:
  • al incluir el componente en el proyecto: en la pestaña "Proyecto", en el grupo "Proyecto", despliegue "Importar" y seleccione "Un componente externo .. Desde un archivo".
  • en la description de los componentes incluidos en el proyecto:
    • En el panel "Explorador de proyectos", seleccione la carpeta "Componentes externos.
    • Abra el menú contextual y seleccione "Lista de componentes externos importados en el proyecto".
    • El botón [ Descripción] se utiliza para get información y documentación sobre el componente.

Conflictos de nombres

Atención: Si un elemento de proyecto y un elemento de componente tienen el mismo nombre, el elemento de componente debe ir precedido por el nombre del componente.
Por ejemplo, la ventana "Menú" está disponible en el proyecto actual y en el componente "Email" utilizado por el proyecto.. La siguiente sintaxis permite abrir la ventana "Menú" del componente "Email":
Open("Email.Menu")

Usando un componente Procedure en la compilación dinámica

Para usar un componente Procedure en la compilación dinámica:
  1. El componente debe estar necesariamente cargado. El componente puede definirse como "Cargado cuando se inicia la aplicación" o puede ser cargado por Carga de componentes.
  2. Se debe utilizar el nombre completo para identificar la Procedure y este nombre debe ir seguido de paréntesis para indicar que se debe utilizar una Procedure (en lugar de una Variable global):
    ComponentName.SetName.ProcedureName()

    Observación: También se puede utilizar la función Ejecute:
    Exécute("ComponentName.SetName.ProcedureName")

Clases y componentes

Un componente puede contener clases en su interfase. Tienes la capacidad de derivar estas clases en el proyecto anfitrión, a overload los métodos virtuales, para proporcionar polimorfismo. La herencia está disponible entre varios niveles de componentes.
Actualización de un componente
  • Cuando una nueva versión de un componente está disponible, todo lo que tiene que hacer es instalar los nuevos archivos de esta actualización en el directorio instalación del componente (según el modo instalación utilizado). Para obtener más información sobre los diferentes modos para instalar un componente, consulte Distribución de un componente.
  • Al abrir un proyecto que utiliza este componenteel cambio de versión de los componentes se detectará automáticamente y se propondrá una actualización del proyecto.. Recomendamos que recompile el proyecto.
    Observación: Puede forzar la actualización de un componente de la lista de componentes encontrados en el proyecto:
    • En el panel "Explorador de proyectos", seleccione la carpeta "Componentes externos.
    • Abra el menú contextual y seleccione "Lista de componentes externos importados en el proyecto".
    • Haga clic en el botón "Actualizar".
  • Si el componente se distribuyó con una aplicación WINDEVel componente debe actualizarse. Para obtener más información, consulte Desplegar una aplicación que utiliza un componente.
Desplegar una aplicación que utiliza un componente
Una aplicación que utiliza uno o más componentes se despliega de la misma manera que una aplicación estándar.
Para obtener más información, consulte Desplegar una aplicación que utiliza un componente.
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

Última modificación: 01/09/2022

Señalar un error o enviar una sugerencia | Ayuda local