AYUDA EN LÍNEA
 WINDEV, WEBDEV 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
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 Pantalla 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
PAGE_Welcome.Display(Name)
ELSE
PAGE_Error.Display("Access denied")
END
WEBDEV - Código Servidor
// In "PAGE_MyPage.AWP", displays the 150th element
// of "Instruments" category
PAGE_MyPage.Display("Instruments", 150)
// Displays a static page in the current frame
PAGE_PAGESTATIC.Display()
Sintaxis
WEBDEV - Código ServidorPHP
<Page>.Display([<Parameter 1> [... [, <Parameter N>]]])
<Page>: Nombre de la página
Nombre de la página a mostrar.
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 Page (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 Page (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 Pantalla 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
<Page>.Display([<Destination> [, <Browser window> [, <Options> [, <Width> [, <Height> [, <Horizontal position> [, <Vertical position> [, <JavaScript parameters>]]]]]]]])
<Page>: Nombre de la página
Nombre de la página a mostrar.
<Destination>: 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 Pantalla 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
      PAGE_MyPage.Display("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
      PAGE_MyPage.Display("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

Pantalla 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 Pantalla 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 <Página>.Refresh.
  • Para tener en cuenta un cambio de idioma (Nación), utilice .Use.
  • 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:
ComponentPage.Display()
Si se produce un conflicto con un elemento del proyecto, el nombre del elemento debe ir precedido del nombre del componente. Por ejemplo:
MyComponent.MyPage.Display()
Para utilizar el nombre de la página en un Variable, especifique el nombre del componente. Por ejemplo:
sPage is string = "MyComponent.MyPage"
sPage.Display()

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".
Componente: wd290page.dll
Ver también
Versión mínima requerida
  • Versión 24
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 22/06/2023

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