|
|
|
|
- Presentación
- Creación de elementos de Enumeración y Combinación en el editor de análisis
- Creación de una posición de enumeración
- Creación de una posición de combinación
- "Convertir" un elemento existente al tipo Enumeración o Combinación
- "Convertir" un elemento en una Enumeración o Combinación Variable
- Usando un número entero o una cadena de caracteres
Enumeración y Combinación de ítems
WINDEV, WEBDEV y WINDEV Mobile proponen los tipos Enumeración y Combinación. Los tipos se utilizan para gestionar conjuntos de valores. Esta página de ayuda explica: Creación de elementos de Enumeración y Combinación en el editor de análisis Creación de una posición de enumeración Para crear un elemento de Enumeración: - Cree un nuevo campo en la ventana de descripción de los campos del archivo de datos (opción "Descripción de los campos" en el menú contextual del archivo de datos en el editor.
- Elija el tipo "Enumeración, Combinación.
- En la pestaña "General" del elemento description, haga clic en el botón que se encuentra a la derecha del cuadro combinado "Tipo" y seleccione "Crear una nueva enumeración".
- Aparece la ventana para editar una enumeración:
- Especifique el nombre de la enumeración.
- Añada valores (botón ) o escriba los valores en el tabla.
- Para cada valor, especifique (si es necesario) el valor associated o el alias (un alias es un valor de enumeración que tiene el mismo valor que otro valor de enumeración pero con un nombre diferente).
Esta enumeración puede ser usada como cualquier Enumeración Variable definida en el editor de código. Para obtener más información, consulte El tipo Enumeración. Observación: Si se definió una enumeración Variable en el editor de código, para usar este Variable en un ítem de análisis, esta enumeración debe ser recreada en el editor de análisis. Creación de una posición de combinación Para crear una posición de combinación: - Cree un nuevo campo en la ventana de descripción de los campos del archivo de datos (opción "Descripción de los campos" en el menú contextual del archivo de datos en el editor.
- Elija el tipo "Enumeración,Combinación
- En la pestaña "General" del elemento description, haga clic en el botón que se encuentra a la derecha del cuadro combinado "Tipo" y seleccione "Crear una nueva combinación".
- Aparece la ventana para tratar una combinación:
- Especifique el nombre de la combinación.
- Añada valores (botón ) o escriba los valores en el tabla.
- Para cada valor, especifique (si es necesario) el valor associated o el alias.
Esta combinación puede ser usada como cualquier combinación Variable definida en el editor de código. Para obtener más información, consulte El tipo de combinación. Observación: Si se definió una combinación Variable en el editor de códigos, para usar este Variable en un elemento de análisis, esta combinación debe ser recreada en el editor de análisis. "Convertir" un elemento existente al tipo Enumeración o Combinación Si sus archivos de datos existentes utilizan elementos que deben transformarse en Enumeración o Combinación (para simplificar el mantenimiento del código, para evitar la asignación de valores no deseados, etc.), puede hacerlo: - "convertir" el elemento existente en la Enumeración o Combinación Variable. Esta solución es estricta pero es compleja de implementar (especialmente si tiene archivos de datos en producción).
- usar un número entero o una cadena de caracteres para almacenar el valor o el nombre de los elementos que se encuentran en la enumeración o en la combinación. Esta solución es más fácil de implementar, pero no impide que se almacenen valores no deseados.. También se puede utilizar para almacenar un valor de enumeración o un valor de combinación en una base de datos que no sea en formato HFSQL (MySQL, Oracle,...) donde los tipos Enumeración y Combinación no están disponibles.
"Convertir" un elemento en una Enumeración o Combinación Variable La "conversión" debe realizarse en varios pasos: - Añada un nuevo elemento de "Enumeración, Combinación" en la description del archivo de datos deseado (ver párrafos anteriores).
- Modificar los archivos de datos físicos. Esta modificación se puede hacer:
- desde el editor de análisis a través de la "Sincronización de la estructura y los datos desplegados". Utilice esta solución si puede acceder directamente a los archivos de datos desde el ordenador de desarrollo.
- mediante la programación a través de HModifyStructure. Utilice esta solución si no puede acceder a los archivos de datos (aplicaciones implementadas, por ejemplo).
- Rellene el nuevo elemento Enumeración o Combinación a partir del contenido de un entero de origen o de un elemento de cadena.. Sólo tiene que utilizar EnumerationFromValue o CombinationFromValue. Esta función devuelve la opción de enumeración o combinación a partir de un valor dado.
Atención: se debe haber definido un valor para cada opción de la enumeración o combinación. Si el nombre de la opción representa el valor, utilice EnumerationFromName o CombinationFromName.
// If the Status item (integer) contains a valid value for the enumeration IF EnumerationCheckValue(EOrderStatus, Order.Status) THEN // Fills the Enumeration item with the corresponding value Order.EnumStatus = EnumerationFromValue(EOrderStatus, Order.Status) // Modifies the record HModify(Order) END
- Eliminar el número entero o la cadena de caracteres anterior.
- Renombrar (si es necesario) el nuevo elemento con el nombre del anterior.
Usando un número entero o una cadena de caracteres También puede utilizar una enumeración o combinación sin modificar su análisis actual. Puede almacenar el valor o el nombre de la opción de enumeración o combinación en un número entero o en la cadena Variable. En este caso, las conversiones se realizan durante las operaciones de lectura y escritura mediante las funciones WLanguage. Por ejemplo, para la siguiente enumeración: // Enumeration with associated values EOrderStatus is Enumeration WaitingForValidation = 1 Prepared = 2 Shipped = 3 InDelivery = 4 Delivered = 5 END
El status del pedido puede almacenarse en una posición cuya clase es: - integer: en este caso, el valor de la opción (1, 2, ...) será almacenado,
- cadena de caracteres: en este caso, se almacenará el nombre de la opción (WaitingForValidation, Prepared, ...).
Atención: por Default, si no se define explícitamente ningún valor para las opciones, el valor de la opción será equivalente a su nombre. Para recuperar la enumeración o la combinación del elemento, utilice las siguientes funciones de WLanguage: Por ejemplo: // Reads the desired record HReadFirst(Order) // Defines an Enumeration variable eMyOrder is EOrderStatus // Retrieves the enumeration from the item eMyOrder = EnumerationFromValue(EOrderStatus, Order.OrderStatus)
Para asignar un elemento de una enumeración o de una combinación, tiene la posibilidad de especificar directamente la Enumeración o Combinación Variable. Esto permite asignar directamente el valor definido para la opción (equivalente a Valor). // Defines an Enumeration variable eMyOrder is EOrderStatus // Applies a value to the variable eMyOrder = WaitingForValidation // Assigns the Enumeration variable to the item // Equivalent to Order.OrderStatus = eMyOrder.Value Order.OrderStatus= eMyOrder
Para almacenar el texto de la opción, se puede utilizar el denominar Property. // Stores the name of the option in the item Order.OrderStatus= eMyOrder..Name
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|