EDIT ITEM

El comando EDIT ITEM le permite editar el elemento actual o el elemento de número elemento del Array o la lista designada por el parámetro objeto.

Esto significa que el elemento seleccionado puede modificarse; la entrada de un carácter reemplazará totalmente el contenido del elemento.

Si pasa el parámetro opcional *, indica que el parámetro objeto es un nombre de objeto (en este caso, pase una cadena en objeto). Si no pasa el parámetro, indica que el parámetro objeto es una tabla o una variable. En este caso, no pasa una cadena sino una referencia de una tabla o variable.

Este comando aplica a los siguientes objetos editables:

• Listas jerárquicas
• List boxes
• Subformularios (en este caso, sólo un nombre de objeto, el subformulario, puede pasarse en objeto),
• Formularios listados mostrados utilizando los comandos MODIFY SELECTION o DISPLAY SELECTION.

Si el comando se utiliza con un objeto editable que no está en la lista, actúa de la misma forma que el comando GOTO OBJECT.
El comando no hace nada si la lista o el array están vacíos o son invisibles. Igualmente, si la lista o el array no son editables, el comando sólo selecciona el elemento especificado sin cambiar a modo edición. En el caso de las list boxes, si la columna no permite la entrada de texto (entrada por casillas de selección o por listas deplegables únicamente), el elemento especificado toma el foco.

El parámetro opcional elemento le permite designar la posición del elemento (lista jerárquica) o el número de línea (list box, formularios listados y subformulario en modo “selección múltiple”) para cambiar a modo de edición. Si no pasa este parámetro, el comando se aplica al elemento actual de objeto. Si no hay elemento actual, el primer elemento de objeto cambia a modo edición.

Notas:

• En subformularios y formularios listados, el comando pasa a modo edición el primer campo de la fila especificada, en el orden de entrada.

• En listboxes mostrados en modo jerárquico, si el elemento objetivo pertenece a un nivel jerárquico colapsado, este nivel (como también los posibles niveles padres) se desplegarán automáticamente para que la línea sea visible.

Este comando puede ser particularmente útil cuando crea un nuevo elemento en una lista jerárquica. Cuando se llama el comando, el último elemento añadido o insertado en la lista se convierte automáticamente en editable, sin que el usuario tenga que efectuar alguna acción especifica.

El siguiente código puede ser el método de un botón que le permite insertar un nuevo elemento en una lista existente. El texto por defecto “Nuevo_elemento” está listo automáticamente para ser cambiado:

Dadas dos columnas de un list box donde los nombres de las variables asociadas son respectivamente “Array1” y “Array2”. El siguiente ejemplo inserta un nuevo elemento en dos arrays y pasa el nuevo elemento de Array2 a modo edición: