ORDLISTADD()
 Añade órdenes a la lista de órdenes
------------------------------------------------------------------------------
 Sintaxis

     ORDLISTADD(<cNombreContenedorOrd> [, <cNombreOrden>])
        --> NIL

 Argumentos

     <cNombreContenedorOrd> es el nombre de un fichero en disco que
     contiene uno o más órdenes. La vía de acceso o la extensión del nombre
     del fichero es opcional. Si no se incluye la extensión, CA-Clipper
     utiliza la extensión por defecto del RDD actual.

     <cNombreOrden> es el nombre del orden incluido en el contenedor de
     órdenes que se va a añadir a la lista de órdenes del área de trabajo
     actual. Si no se especifica <cNombreOrden>, se añaden a la lista todos
     los órdenes del contenedor de órdenes.

 Devuelve

     ORDLISTADD() devuelve siempre NIL.

 Descripción

     ORDLISTADD() es una función de gestión de órdenes que añade el
     contenido de un contenedor de órdenes, o sólo uno de sus órdenes, a una
     lista de órdenes. Esta función permite ampliar la lista de órdenes sin
     utilizar el mandato SET INDEX, lo que evita que se eliminen los índices
     activos de la lista de órdenes.

     Todos los órdenes que ya estuviesen asociados con el área de trabajo
     continúan activos. Si el contenedor de órdenes abierto recientemente es
     el único asociado al área de trabajo, se convierte en el orden de
     control. En caso contrario, el orden de control permanece sin cambios.

     Al abrir órdenes nuevos, el puntero del área de trabajo se sitúa en el
     primer registro lógico del orden de control.

     ORDLISTADD() es similar al mandato SET INDEX o a la cláusula INDEX del
     mandato USE. La única diferencia es que no vacía la lista de órdenes
     antes de añadir nuevos órdenes.

     ORDLISTADD() reemplaza a la función DBSETINDEX().

     El RDD activo determina la capacidad de un contenedor de órdenes. Los
     controladores DBFNTX y DBFNDX sólo admiten contenedores con un único
     orden. Existen otros RDDs que admiten varios órdenes (p. ej., el
     controlador DBFCDX). Al utilizar RDDs que admitan contenedores con
     varios órdenes, se debe establecer explícitamente el orden de control
     deseado utilizando SET ORDER (o ORDSETFOCUS()). Si no se especifica un
     orden de control, el fichero de datos se procesará de acuerdo con el
     primer orden primero.

 Ejemplos

      En este ejemplo Cliente.cdx contiene tres órdenes, ClCuenta,
        ClNombre y ClDomic. ORDLISTADD() abre Cliente.cdx pero sólo utiliza
        el orden ClCuenta:

        USE Cliente VIA "DBFCDX" NEW
        ORDLISTADD( "Cliente", "ClCuenta" )

 To download this example - click here.

See Also: INDEX SET INDEX USE