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 / WLanguage / Funciones WLanguage / Funciones específicas de la Web / Funciones de páginas
  • Recuperación de los parámetros en las "Declaraciones globales" de Event
  • Recuperación de los parámetros con PageParameter
  • Principio para abrir una página
  • Las operaciones se ejecutan cuando se muestra la página
  • Casos especiales
  • Abrir una página de un componente
  • Sesiones preiniciadas
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
Muestra una página web en el navegador del usuario.
WEBDEV - Código Servidor La página mostrada puede ser una página WEBDEV estática, una página en modo sesión o una página WEBDEV de Active.
WEBDEV - Código Navegador La página mostrada puede ser una página WEBDEV estática o una página WEBDEV de Active. Para mostrar una página de Active WEBDEV mientras se pasan parámetros, utilice FileDisplay.
PHP La página mostrada es otra página PHP del proyecto.
Observaciones:
  • Si se utiliza la función PageDisplay en el código de un control Botón, la página se abrirá en el destino definido para este control Botón(pestaña "General" de la descripción del control o función ChangeTarget).
  • Para visualizar cualquier página en un navegador, utilice una de las siguientes funciones: BrowserRunApp o NavegadorAbrir.
Ejemplo
WEBDEV - Código ServidorPHP
// Display a page according to the authorization
IF bAuthorize(Name) THEN
PageDisplay(PAGE_Welcome, Name)
ELSE
PageDisplay(PAGE_Error, "Access denied")
END
WEBDEV - Código Servidor
// In "PAGE_MyPage.AWP", displays the 150th element
// of "Instruments" category
PageDisplay(PAGE_MyPage, "Instruments", 150)
// Displays a static page in the current frame
PageDisplay(PAGE_STATICPAGE)
// Displays any page in the current frame
IF Nation() = nationEnglish THEN
PageDisplay("US/PAGE_Example.HTM")
ELSE
PageDisplay("FR/PAGE_Example.HTM")
END
// Displays a static page in a new resizable browser
// (500x400). This browser will be closed if the calling browser is closed.
sPageName is string = "STATICPAGE"
PageDisplay(sPageName, NewBrowser, ...
"NEWBRW", ONDimension + ONScrollBar, 500, 400, 10, 20, "dependent=1")
Sintaxis
WEBDEV - Código ServidorPHP
PageDisplay(<Page> [, <Parameter 1> [... [, <Parameter N>]]])
<Page>: Nombre de la página
Nombre de la página a mostrar.
Si este parámetro es igual a una cadena vacía (""), el nombre de la página corresponde a la página a la que pertenece el actual Process.
En el modo de prueba, especifique la ruta completa de la página si la página que desea abrir se encuentra en un directorio que no sea el directorio del proyecto.
<Parameter 1>: Tipo de valor enviado a la página (opcional)
Parámetros esperados por la apertura Process de la página a mostrar. Estos parámetros son pasados por reference y son considerados como variables globales a la página. En el caso de una página AWP o PHP, estos parámetros se convierten en cadena.
<Parameter N>: Tipo de valor enviado a la página (opcional)
Parámetros esperados por la apertura Process de la página a mostrar. Estos parámetros son pasados por reference y son considerados como variables globales a la página. En el caso de una página AWP o PHP, estos parámetros se convierten en cadena.
En el entorno, al definir la acción de un botón o enlace, se puede seleccionar la página a mostrar para evitar programar la función PageDisplay en el código de clic. También tiene la posibilidad de definir los parámetros pasados a la página haciendo clic en el botón "Parámetros".
Los parámetros también se pueden definir como:
  • Valor fijo,
  • reference a una página control,
  • reference a un Variable.
WEBDEV - Código Navegador
PageDisplay(<Page> [, <Target> [, <Browser window> [, <Options> [, <Width> [, <Height> [, <Horizontal position> [, <Vertical position> [, <JavaScript parameters>]]]]]]]])
<Page>: Nombre de la página o cadena de caracteres
Nombre de la página a mostrar:
  • Página estática del proyecto o Active Página WEBDEV:
    El nombre de la página se especifica sin extensión. La página se muestra de acuerdo con los parámetros del idioma del proyecto.
    Ejemplo: La siguiente sintaxis se utiliza para mostrar la página estática llamada "CompanyPage".:
    PageDisplay(CompanyPage)
  • Cualquier página HTML que se encuentre en el directorio <Nombre del proyecto>_WEB (o en uno de sus subdirectorios):
    El nombre de la página a mostrar debe corresponderse con el ruta completo de la página a partir del directorio <Nombre del proyecto>_WEB y debe incluir la extensión del archivo.. En este caso, la función multilingüe debe gestionarse.
    Ejemplo: Para mostrar "C:\Mis Proyectos\MiSitio\MiSitio_WEB\Misc\HTMLPage.htm", utilice la siguiente sintaxis:
    PageDisplay("Misc\HTMLPage.htm")
<Target>: Cadena de caracteres opcional o constante
Nombre del marco de destino o alias del iFrame de destino control.
<Target> también puede tomar los siguientes valores:
CurrentBrowserel objetivo es el navegador actual.
Este parámetro también puede corresponder a la cadena "_top" (compatibilidad con WEBDEV 1.5).
CurrentFrameel objetivo es el cuadro actual (valor de Default).
Este parámetro también puede corresponder a la cadena "_self" (compatibilidad con WEBDEV 1.5).
NewBrowserel objetivo es un nuevo navegador (se abre una nueva ventana del navegador). Los siguientes parámetros de la función PageDisplay permiten configurar esta nueva ventana.
Este parámetro también puede corresponder a la cadena "_blank" (compatibilidad con WEBDEV 1.5).
ParentFrameel objetivo es el contenedor de la página actual (conjunto de marcos padre, navegador padre).
Este parámetro también puede corresponder a la cadena "_parent" (compatibilidad con WEBDEV 1.5).
<Browser window>: Cadena de caracteres opcional
Nombre de la ventana en el nuevo navegador si <Target> se establece en la constante NewBrowser. Este parámetro permite volver a mostrar una página en un navegador con el mismo nombre (si se abren varios navegadores en la el equipo del usuario de la web).
<Options>: Constante o combinación de constantes de tipo Integer (opcional)
Parámetros de la ventana en el nuevo navegador si <Destino> es igual a la constante NewBrowser:
ONFull
(Valor predeterminado)
La ventana del nuevo navegador incluirá todas las opciones (equivalente a la combinación de todas las constantes)
ONLinkSe mostrará la barra de enlaces
ONLocationLa barra de Address será mostrada
ONMenuBarAparecerá la barra de menú
ONResizableLa ventana del nuevo navegador será redimensionable
ONSatusBarAparecerá la barra de estado
ONScrollBarAparecerán las barras de desplazamiento
ONSimpleLa ventana del nuevo navegador será una ventana simple (sin combinación de constantes).
ONToolBarAparecerá la barra de herramientas
<Width>: Entero opcional
Ancho de ventana en el nuevo navegador (en píxeles).
<Height>: Entero opcional
Altura de la ventana en el nuevo navegador (en píxeles).
<Horizontal position>: Entero opcional
Posición horizontal (en píxeles) de la ventana en el nuevo navegador (en relación con la Corner superior izquierda de la pantalla).
<Vertical position>: Entero opcional
Posición vertical (en píxeles) de la ventana en el nuevo navegador (en relación con la Corner superior izquierda de la pantalla).
<JavaScript parameters>: Cadena de caracteres opcional
Otros parámetros de JavaScript que deben utilizarse al abrir un nuevo navegador si <Target> es igual a la constante NewBrowser.
Observaciones
WEBDEV - Código ServidorPHP

Recuperación de los parámetros en las "Declaraciones globales" de Event

Para recuperar los parámetros en las "Declaraciones globales" Event de la página, especifique el siguiente Line al principio del código:
PROCEDURE <Page name> (<Parameter 1> [, ...[, <Parameter N>]]])
Estos parámetros pueden ser cadenas, reales o enteros. Los parámetros recuperados en las "Declaraciones globales" Event de la página son cadenas de caracteres (sólo páginas AWP y PHP)
WEBDEV - Código ServidorPHP

Recuperación de los parámetros con PageParameter

PageParameter se utiliza para recuperar el valor de los parámetros pasados a la página. Existen varias posibilidades según el tipo de página:
  • Recuperación según el nombre del parámetro
    El nombre del parámetro se especificó en la URL de la página.
    Para una página de AWP o PHP, los parámetros son renombrados automáticamente por WEBDEV (P1, P2, ..., P256). En este caso, no se debe encontrar ningún control llamado P1, P2, ...., P256 en la página.
    1. Código utilizado para mostrar la página pasando los parámetros:
      // In the "MyPage.AWP" page, displays the 350th element
      // of "Instruments" category
      PageDisplay(PAGE_MyPage, "Instruments", 350)
    2. Código utilizado para recuperar los parámetros:
      // Retrieve the parameters
      SoughtCategory is string = PageParameter("P1")
      SoughtID is int = PageParameter("P2")
  • Retrieval según el índice del parámetro
    El índice del parámetro corresponde al orden en que los parámetros fueron pasados en la URL de la página.
    1. Código utilizado para mostrar la página pasando los parámetros:
      // In the "PAGE_MyPage.AWP" page, displays the 350th element
      // of "Instruments" category
      PageDisplay(PAGE_MyPage, "Instruments", 350)
    2. Código utilizado para recuperar los parámetros:
      // Retrieve the parameters
      SoughtCategory is string = PageParameter(1)
      // SoughtCategory = "P1=Instruments"
      SoughtCategory = Right(Length(SoughtCategory)-3)
      SoughtID is int = PageParameter(2)
      // SoughtID = "P2=350"
      SoughtID = Right(Length(SoughtID)-3)
WEBDEV - Código ServidorPHP

Principio para abrir una página

PageDisplay hace lo siguiente:
  • Crear un contexto de página en el servidor (excepto cuando se muestran páginas PHP).
  • Devuelve la página al navegador del usuario web.
PHP PageDisplay devuelve sólo la página en el navegador del usuario.
WEBDEV - Código ServidorPHP

Las operaciones se ejecutan cuando se muestra la página

Las siguientes operaciones se ejecutan cuando se visualiza la página:
  • Ejecutando las "Declaraciones Globales" Event de plantillas y páginas internas de control.
  • Ejecutando las "Declaraciones Globales" Event de la página.
  • Inicialización en los controles hijo directos de la página (y recursivamente en los controles y objetos de la página):
    • Código de declaración de variables (si existe y aún no se ha ejecutado: página, supercontrol, popup,...).
    • Inicialización de niños directos.
    • Solicitud de actualización del código de visualización (si existe).
    • Código de inicialización (si existe).
  • Para todos los controles de página (en función de una búsqueda en profundidad):
    • Llenando la control (para el cuadro de la lista, el cuadro combinado, la tabla o la navegación por los control s de Looper)
    • Fin del código de inicialización (si existe).
  • Ejecutando la Event "Solicitud de refresco de la pantalla" de la página (si existe).
  • Ejecutando el "Iniciando" Event de la página.
Además, para una página que hereda de una modelo, el código de modelo(s) se ejecuta justo antes del código de la página.. Para los controles que heredan de un modelo, se debe utilizar EjecutarAncestor para llamar al código modelo (excepto el código de declaración).
WEBDEV - Código ServidorPHP

Casos especiales

  • Para volver a mostrar una página, se recomienda utilizar PageRefresh.
  • Para tener en cuenta un cambio de idioma (Nación), utilice PageUse.
  • Si ya existe un contexto de página con el mismo nombre, se borra (y se ejecuta su código de cierre) antes de que se abra el nuevo.
  • Para mostrar cualquier página (no necesariamente encontrada en el sitio), utilice, por ejemplo, NavegadorAbrir.
WEBDEV - Código Servidor

Abrir una página de un componente

Para abrir una página de un componente, utilice el nombre de la página del componente (el componente que se incluye en el proyecto). Por ejemplo:
PageDisplay(ComponentPage)
Si se produce un conflicto con un elemento del proyecto, el nombre del elemento debe ir precedido del nombre del componente. Por ejemplo:
PageDisplay(MyComponent.MyPage)
Para utilizar el nombre de la página en un Variable, especifique el nombre del componente. Por ejemplo:
sPage is string = "MyComponent.MyPage"
PageDisplay(sPage)

Sesiones preiniciadas

Si el proyecto utiliza sesiones preiniciadas, esta función no debe utilizarse en el evento "Inicialización" del proyecto. Debe utilizarse en el evento "Inicialización del proyecto después de la conexión al sitio".
Clasificación Lógica de negocio / UI: Código UI
Componente: wd290page.dll
Versión mínima requerida
  • Versión 9
Comentarios
Video Page Display
https://youtu.be/TQoQuKxLELA
amarildo
26 10 2018

Última modificación: 04/06/2022

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