Value (Property)

AYUDA EN LÍNEA
WINDEV, WEBDEV Y WINDEV MOBILE

Versión:

Inicio | Iniciar sesión | Español

Este contenido se ha traducido automáticamente. Haga clic aquí para ver la versión en inglés.

Ayuda / WLanguage / Propiedades WLanguage / Propiedades varias

Valor de control Estático
Valor de control calculado en un reporte
Valor de control Código de barras
Valor de control Imagen
Valor de control Estático o control preestablecido encontrado en un reporte
Valor de RTF control
Valor de la ventana o Page
Valor de control Campo de entrada
Valor de control Botón
Valor de control Casilla de verificación o valor de la opción en una control Casilla de verificación
Valor de control Botón de opción
Valor de List Box, ListView o control Tabla
Valor de la celda en una control Tabla
Valor de control Combo Box
Valor de control Pestaña
Valor de control Gráfico
Valor de control Valoración
Valor de control Cajón de navegación
Valor de HTML control
Valor de control Mapa
Valor del Mapa del Sitio Camino control
Botón, Link e iFrame: Propiedades URL y Value
Control Upload
Control deslizante de rango
Valor de la pancarta deslizante control
Limitaciones

WINDEV

WEBDEV

WINDEV Mobile

Otros

Ver también

Value (Property)

La propiedad Value permite:

Averigua y modifica el valor de un reporte control.
Averiguar y modificar el valor de una control o el título de una ventana.
Averiguar el identificador de una secuencia.
Averiguar y modificar el valor de una control o el título de una Page.
Descubra los archivos gestionados por una control Upload.
Averigüe y modifique el plano que se muestra actualmente en una pancarta deslizante control.
Centrar el mapa que se encuentra en una control Mapa en una posición específica.
Averigua y modifica el valor inferior del interval seleccionado actualmente en un Control deslizante de rango.
Obtener el valor asociado a un valor de un Variable de tipo Enumeración.

Observación: El Value Property se utiliza raramente y puede ser sustituido por una sintaxis equivalente (ver Observaciones).

Ejemplo

// Modify the image file associated with the "IMG_Image" control
IMG_Image.Value = "C:\MyImages\Image.BMP"

Sintaxis

Descubrir el valor de un elemento Ocultar los detalles

<Result> = <Element used>.Value

<Result>: Cualquier tipo

Este resultado depende del tipo de elemento.

<Element used>: Tipo de elemento

Nombre del elemento a utilizar.

Modificar el valor de un elemento Ocultar los detalles

<Element used>.Value = <New value>

<Element used>: Tipo de elemento

Nombre del elemento a utilizar.

<New value>: Cualquier tipo

Nuevo valor para el elemento especificado. Este parámetro depende del tipo de elemento especificado.

Observaciones

Valor de control Estático

El Value Property se utiliza para recuperar o modificar el texto de un control Estático.

<Resultado> es una cadena de caracteres.

Para recuperar el texto de un control Estático, las siguientes sintaxis son equivalentes:

ResCaption = <Static control>.Value
ResCaption = <Static control>
ResCaption = <Static control>.Caption

Valor de control calculado en un reporte

El Value Property se utiliza para recuperar o modificar el valor de un control calculado en un reporte.

El tipo del <Resultado> depende del tipo del control Calculado.

Para recuperar el valor de una control calculada, utilice una de las siguientes sintaxis:

ResValue = <Calculated control>.Value

ResValue = <Calculated control>

Valor de control Código de barras

El Value Property se utiliza para recuperar o modificar el valor de un control Código de barras. El valor de una control Código de barras corresponde al string representado en el código de barras.

<Resultado> es una cadena de caracteres.

Para recuperar el texto de un control Código de barras, utilice una de las siguientes sintaxis:

ResValue = <Bar Code control>.Value

ResValue = <Bar Code control>

Valor de control Imagen

El Value Property se utiliza para identificar o modificar el archivo de imagen asociado a un control Imagen.

<Resultado> es una cadena de caracteres que contiene el ruta del archivo Image.

Para identificar el archivo de imagen associated con un control Imagen, utilice una de las siguientes sintaxis:

ResImage = <Image control>.Value

ResImage = <Image control>

Valor de control Estático o control preestablecido encontrado en un reporte

El Value Property se utiliza para identificar o modificar el contenido del control.

En una asignación, el tipo del valor que se pasa al Value Property depende del tipo del elemento associated con el control.

Si el elemento es numérico, debe asignarle un número y asegurarse de utilizar la máscara de entrada correcta (InputMask Property).

Una fecha debe ser asignada a una fecha control.

Valor de RTF control

El Value Property se utiliza para recuperar o modificar el contenido de un RTF control. Este contenido está compuesto por caracteres específicos de RTF.

<Resultado> es una cadena de caracteres.

Para recuperar el contenido de un RTF control, utilice una de las siguientes sintaxis:

ResRTF = <RTF control>.Value

ResRTF = <RTF control>

Valor de la ventana o Page

El Value Property se utiliza para recuperar o cambiar el título de una ventana o Page.

<Resultado> es una cadena de caracteres.

Las propiedades Value y Título son equivalentes.

Para averiguar el título de una ventana o el título de una Page, utilice una de las sintaxis siguientes:

ResTitle = <Name of window or page>.Value

ResTitle = <Name of window or page>

ResTitle = <Name of window or page>.Title

Valor de control Campo de entrada

El Value Property se utiliza para recuperar o cambiar el valor introducido en un control.

<El resultado tiene el siguiente tipo:

cadena de caracteres si el subtipo de la control de edición corresponde a "Texto", "Fecha" u "Hora",
entero o real si el subtipo de la Edición control corresponde a "Numérico",
numérico si el subtipo de la Edición control corresponde a "Moneda" o "Moneda + Euro".

Para averiguar el valor escrito en una control Campo de entrada, utilice una de las siguientes sintaxis:

ResValue = <Edit control>.Value

ResValue = <Edit control>

Valor de control Botón

El Value Property se utiliza para recuperar y modificar el texto de un control Botón.

Si el control Botón contiene un Image, sólo se devuelve el texto. No es posible asignar un dibujo a un control Botón.

<Resultado> es una cadena de caracteres.

Las propiedades Value y Pie de foto son equivalentes.

Para conocer el texto de una control Botón, utilice una de las siguientes sintaxis:

ResButton = <Button control>.Value

ResButton = <Button control>

ResButton = <Button control>.Caption

El Value Property se utiliza para cambiar el Image de una imagen control Botón sin un hover Image. Se recomienda utilizar el Image Property en su lugar para cambiar la imagen del control Botón.

Valor de control Casilla de verificación o valor de la opción en una control Casilla de verificación

El Value Property se utiliza para:

Marcar o desmarcar una opción en un control Casilla de verificación.
Averiguar si una opción encontrada en una control Casilla de verificación está marcada o no.

<El resultado es booleano:

True si la opción está seleccionada,
False en caso contrario.

Para saber si una opción encontrada en una control Casilla de verificación está marcada o no, utilice una de las siguientes sintaxis:

ResChecked = <Check Box control>[<Option number>].Value

ResChecked = <Check Box control>[<Option number>]

ResChecked = <Option name>.Value

ResChecked = <Option name>

Observación: Si no se especifica <Número de opción>, la primera opción es seleccionada por Default.

Valor de control Botón de opción

El Value Property se utiliza para:

Averigua la opción Active en un control Botón de opción.
Seleccione una opción.

<Resultado> es un número entero.

Para conocer la opción Active en una control Botón de opción, utilice una de las siguientes sintaxis:

ResOption = <Radio Button control>.Value

ResOption = <Radio Button control>

Observación: Un control Botón de opción siempre se posiciona en una posición (1 por Default). Para visualizar una control Botón de opción sin opción de Default, sólo hay que asignar -1 al valor de control durante su inicialización:

// Initialize the value of "RADIO_Customer" with its initial value
RADIO_Customer.InitialValue = -1

Valor de List Box, ListView o control Tabla

Se pueden presentar dos casos distintos.

El cuadro de lista, ListView o control Tabla se rellena mediante programación O el StoredItem Property corresponde a una cadena vacía ("").
El Value Property se utiliza para:
- Obtener la fila seleccionada. Si no se selecciona fila, el Value Property devuelve -1. Si el control permite la selección múltiple, se devuelve el número del último fila seleccionado.
  Para averiguar la fila seleccionada, utilice una de las siguientes sintaxis:
  ResRow = <Control name>.Value
  
  ResRow = <Control name>
- Seleccione otra fila especificando el número de la nueva fila a seleccionar. Las filas seleccionadas previamente se deseleccionan.
El List Box, ListView, o controles Tabla se basan en un archivo de datos Y el StoredItem Property no está vacío.
La propiedad Value se utiliza para identificar el elemento almacenado para el Record asociado al fila seleccionado. Si no se selecciona fila, el Value Property devuelve una cadena vacía ("").
Para averiguar el elemento almacenado associated con el fila seleccionado, utilice una de las siguientes sintaxis:
ResStoredItem = <Control name>.Value

ResStoredItem = <Control name>.StoredItem

Recordatorio: la control ListView no está disponible para WEBDEV.

Valor de la celda en una control Tabla

El Value Property se utiliza para determinar o modificar el valor de una celda en un control Tabla.

<Resultado> es una cadena de caracteres.

Para averiguar el valor de una celda, utilice una de las siguientes sintaxis:

ResCell = <Table control>[<Row number>][<Column number>].Value

ResCell = <Table control>[<Row number>][<Column number>]

ResCell = <Column>[<Row number>].Value

ResCell = <Column>[<Row number>]

Caso especial: Valor de la celda en el fila actual
Si sólo se especifica el nombre de la columna, se puede utilizar el Value Property:

Averiguar el valor de la celda identificada por la columna especificada y por el fila actual en el control Tabla. Si no hay ninguna fila actual, se devuelve una cadena vacía ("").
Modificar el valor de la celda identificada por la columna especificada y por el fila actual en el control Tabla.

<Resultado> es una cadena de caracteres.

Para averiguar el valor de la celda identificada por la columna especificada y por la fila actual en el control Tabla, utilice una de las siguientes sintaxis:

ResColumn = <Column name>.Value

ResColumn = <Column name>

Valor de control Combo Box

Se pueden presentar dos casos distintos.

El control Combo Box es editable Y el StoredItem Property corresponde a una cadena vacía ("").
El Value Property se utiliza para:
- Averiguar el valor del elemento seleccionado. Si no se selecciona ningún elemento, el Value Property devuelve una cadena vacía ("").
  Para conocer el valor del elemento seleccionado, utilice una de las siguientes sintaxis:
  ResValue = <Combo Box control>.Value
  
  ResValue = <Combo Box control>
- Modificar el valor del elemento seleccionado.
El Combo Box no es editable O el StoredItem Property no está vacío.
El Value Property se utiliza para determinar el número del elemento seleccionado.
Para conocer el número del elemento seleccionado, utilice una de las siguientes sintaxis:
ResElement = <Combo Box control>.Value
ResElement = <Combo Box control>[<Combo Box control>]
ResElement = <Combo Box control>

Valor de control Pestaña

El Value Property se utiliza para habilitar un panel en un control Pestaña o para determinar el número del panel Active.

<Resultado> es un número entero.

Para conocer el número de la ficha de Active, utilice una de las siguientes sintaxis:

ResPane = <Tab control>.Value

ResPane = <Tab control>

El Value Property se utiliza para determinar el número del panel Active en el código del navegador.

Valor de control Gráfico

El Value Property sólo puede utilizarse para obtener el nombre de un control Gráfico.

<Resultado> es una cadena de caracteres.

Para averiguar el nombre de una control Gráfico, utilice una de las siguientes sintaxis:

Res_ChartName = <Chart control>.Value

Res_ChartName = <Chart control>

Valor de control Valoración

El Value Property se utiliza para inicializar y determinar el valor de un control Valoración.

Este valor se corresponde con el número de iconos que aparecen en control.

Ejemplo:

RATE_Nation1.Value = 4.5

Valor de control Cajón de navegación

El Value Property se utiliza para determinar si el control Cajón de navegación está expandido (1) o colapsado (0) y para cambiar entre los dos estados.

Ejemplo:

// Collapses the Drawer control if it is expanded
IF DRW_Drawer1.Value = 1 THEN DRW_Drawer1.Value = 0

Valor de HTML control

El Value Property se utiliza para get el Address associated con la página HTML que se muestra en el control. Si el Page:

es una Page construida en HTML directamente, el valor corresponde a "about:blank".
es un Page de un sitio, el valor corresponde al Address del Page (www.windev.com por ejemplo).
es un archivo HTML, el valor corresponde a la Address del archivo.

Valor de control Mapa

El Value Property se utiliza para centrar el mapa (en un control Mapa) en la posición que corresponde a un geoPosition Variable.

Ejemplo:

// Centers the map displayed by the "MAP_Position" control on a geographical position
MyPosition is geoPosition

MAP_Position.Value = MyPosition

Observaciones:

La propiedad Value es equivalente a la función MapDisplayPosition. La única diferencia es que: cuando se utiliza MapDisplayPosition, se muestra una animación al fijar la posición en el lugar deseado.
El Value Property sólo puede utilizarse para cambiar la posición en un control Mapa.
El Value Property se utiliza para obtener y cambiar la posición en un control Mapa.

Valor del Mapa del Sitio Camino control

El Value Property se utiliza para get el índice del elemento en el control Migas de pan que el usuario ha pulsado.

Botón, Link e iFrame: Propiedades URL y Value

Las propiedades URL y Value tienen el mismo efecto en los controles Button, Link e iFrame. Estas propiedades se utilizan para averiguar la dirección associated con la control.

Control Upload

El Value Property se utiliza para get la lista de archivos seleccionados en un control Upload de archivos múltiples. Los nombres de los archivos están separados por caracteres CR (Carriage Return). Para un archivo único control Upload, sólo se devuelve el nombre del archivo seleccionado..

El nombre de los archivos corresponde a la ruta y al nombre del archivo cargado temporalmente.. Por ejemplo: C\WebDep\Temp\Archivo.upl
Esta propiedad debe utilizarse en la Process para recibir los archivos cargados. En los otros casos, este Property devuelve una cadena vacía ("").

Este Property es equivalente al Contenido en código de servidor en el control Upload.

El nombre de los archivos corresponde al nombre del archivo que aparece en el navegador. Por ejemplo: MiImagen.jpg

Control deslizante de rango

La propiedad Value se utiliza para obtener y cambiar el límite inferior del intervalo actualmente seleccionado en un Control deslizante de rango. En este caso, esta Property es equivalente a la LowerValue Property.

Se aplican las mismas reglas.