ORDSETFOCUS()
 Establece el foco en un orden de la lista de órdenes
------------------------------------------------------------------------------
 Sintaxis

     ORDSETFOCUS([<cNombreOrden> | <nOrden>]
        [,<cNombreContenedorOrd>])
        --> cNombreOrdenAntConFoco

 Argumentos

     <cNombreOrden> es el nombre del orden seleccionado, un orden lógico
     de una base de datos. ORDSETFOCUS() ignora los valores incorrectos
     especificados en <cNombreOrden>.

     <nOrden> es un número que representa la posición del orden
     seleccionado en la lista de órdenes.

     <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.

 Devuelve

     ORDSETFOCUS() devuelve el nombre del anterior orden de control.

 Descripción

     ORDSETFOCUS() es una función de gestión de órdenes que devuelve el
     nombre del anterior orden de control y, opcionalmente, establece un
     nuevo orden de control.

     Si <cNombreOrden> o <nOrden> no se especifican, devuelve el nombre del
     orden de control actual y el orden de control permanece igual.

     El hecho de establecer <cNombreOrden> como el orden de control no
     impide que se sigan actualizando convenientemente el resto de órdenes
     de la lista de órdenes. Después de cambiar el orden de control, el
     puntero del registro sigue apuntando al mismo registro.

     El RDD activo determina la capacidad de un contenedor de órdenes. El
     controlador por defecto DBFNTX sólo admite contenedores con un único
     orden, mientras que otros RDDs pueden admitir varios órdenes (p. ej.,
     los controladores DBFCDX y DBFMDX).

     Nota: ORDSETFOCUS() sustituye a la función INDEXORD().

 Ejemplos

     USE Cliente VIA "DBFNTX" NEW
     SET INDEX TO ClCuenta, ClNombre, ClDomic
     ? ORDSETFOCUS( "ClNombre" )         // Muestra: "ClCuenta"
     ? ORDSETFOCUS()                     // Muestra: "ClNombre"

 To download this example - click here.

See Also: SET INDEX SET ORDER