@...GET CHECKBOX
 Crea un objeto Get consistente en un cuadro de selección y lo muestra
 en pantalla
------------------------------------------------------------------------------
 Sintaxis

     @ <nFila>, <nColumna>
        GET <lVar>
        CHECKBOX
           [CAPTION <cTítulo>]
           [MESSAGE <cMensaje>]
           [WHEN <lCondiciónPrevia>]
           [VALID <lCondiciónPosterior>]
           [COLOR <cCadenaColor>]
           [FOCUS <fbloque>
           [STATE <bBloque>]
           [STYLE <cEstilo>]
           [SEND <mensaje>]
           [GUISEND <mensajeGUI>]
           [BITMAPS <aMapaBits>]

 Argumentos

     <nFila> y <nColumna> especifican las coordenadas de pantalla
     para el cuadro de selección y su título. No se visualizará la parte del
     objeto que exceda de los límites de la pantalla.

     GET <lVar> especifica el nombre de la variable asociada al mandato
     GET. <lVar> debe contener un valor de tipo lógico. Un valor verdadero
     (.T.) indica que el cuadro de selección está marcado, y un valor falso
     (.F.) indica que no lo está.

     CAPTION <cTítulo> especifica una cadena de caracteres que describe
     en pantalla, de forma concisa, el significado del GET. Existen dos
     diferencias entre CAPTION y SAY. La primera es que el título aparece
     cada vez que el GET se muestra en pantalla. La segunda es que el
     título y su posición en pantalla se almacenan en el objeto Get. Esto
     permite que el GET pueda recibir la entrada del usuario al hacer clic
     en el título con el botón izquierdo del ratón. Por defecto, el título
     aparece a la izquierda del GET. Es posible utilizar las variables
     capRow y capCol del objeto Get para modificar la posición en pantalla
     del título.

     Si en la cadena de caracteres del título está presente el carácter &,
     el carácter que le sigue se utiliza como tecla aceleradora del cuadro
     de selección. La tecla aceleradora es un método rápido para pasar el
     foco de entrada al cuadro de selección. Para seleccionarlo se pulsará
     la tecla Alt en combinación con la tecla aceleradora. En las teclas
     aceleradoras no se distingue entre mayúsculas y minúsculas.

     MESSAGE <cMensaje> especifica la cadena de caracteres que aparece
     en la barra de la línea de estado del sistema del Get cuando el GET
     tiene el foco de entrada. Normalmente, contiene una breve descripción
     o una respuesta al usuario acerca del GET. Consulte el mandato READ
     para obtener detalles del funcionamiento de la barra de estado del
     sistema Get.

     WHEN <lCondiciónPrevia> especifica una expresión que debe
     satisfacerse antes de que el cursor entre en el GET durante un mandato
     READ. La expresión puede ser, opcionalmente, un bloque de código. El
     objeto Get se pasa como parámetro al bloque de código.

     VALID <lCondiciónPosterior> especifica una expresión que debe
     satisfacerse antes de que el cursor pueda salir del GET durante un
     mandato READ. La expresión puede ser, opcionalmente, un bloque de
     código. El objeto Get se pasa como parámetro al bloque de código.

     COLOR <cCadenaColor> define los colores seleccionados para el
     cuadro de selección. <cCadenaColor> es una expresión de caracteres que
     contiene cuatro parámetros de color.

     Atributos de color para el cuadro de selección 
     ------------------------------------------------------------------------
     Posición       Se aplica a                         Valor por defecto
     en colorSpec                                       (parámetros de color
                                                        del sistema)
     ------------------------------------------------------------------------
     1                El cuadro de selección cuando       No seleccionado
                      no tiene el foco de entrada
     2                El cuadro de selección cuando       Mejorado
                      tiene el foco de entrada
     3                El título del cuadro de selección   Estándar
     4                La tecla aceleradora del título     Fondo
                      del cuadro de selección
        ---------------------------------------------------------------------

     Nota:  En modo gráfico, las posiciones 1 y 2 de colorSpec no tienen
     ningún efecto y se ignoran.

     FOCUS <fbloque> especifica un bloque de código que se evalúa cada
     vez que el cuadro de selección recibe el foco de entrada. El bloque de
     código no tiene argumentos implícitos. La variable de instancia
     CheckBox:hasFocus se utiliza para determinar si el cuadro de selección
     tiene el foco.

     STATE <bBloque> especifica un bloque de código que se evalúa cada
     vez que cambia el estado del cuadro de selección. El bloque de código
     no tiene argumentos implícitos. La variable de instancia
     CheckBox:buffer se utiliza para determinar si el cuadro de selección
     está o no marcado. Un valor verdadero (.T.) indica que está marcado y
     un valor falso (.F.) indica que no lo está.

     STYLE <cEstilo> especifica una cadena de caracteres con los
     delimitadores del cuadro de selección. La cadena debe contener cuatro
     caracteres. El primero es el delimitador izquierdo. Su valor por
     defecto es el carácter corchete izquierdo ([). El segundo es el
     carácter de marcado. Su valor por defecto es el carácter raíz cuadrada
     (). El tercero es el carácter de no marcado. Su valor por defecto es
     el carácter espacio en blanco (" "). El cuarto es el delimitador
     derecho. Su valor por defecto es el carácter corchete derecho (]).

     Nota:  La cláusula STYLE no se tiene en cuenta en el modo gráfico.

     SEND <mensaje> envía el mensaje especificado al objeto Get.
     <mensaje> se envía antes de la visualización del mandato GET. Es
     posible enviar cualquier mensaje, incluidas las llamadas a métodos y
     asignaciones de variables de instancia. Las llamadas a métodos deben
     incluir paréntesis aunque no se pasen argumentos.

     GUISEND <mensajeGUI> se puede utilizar para enviar un mensaje (por
     ejemplo, el método Display()) a un objeto GUI. Los objetos GUI en
     CA-Clipper son cuadros de selección, cuadros de lista, botones y grupos
     de botones de opción. Para enviar un mensaje a un objeto que no sea
     GUI, por ejemplo objetos Get y TBrowse, se utiliza la cláusula SEND.

     BITMAPS <aMapaBits> Contiene una matriz de dos elementos. El
     primero contiene el nombre del fichero del mapa de bits que se
     visualiza al activar el cuadro de selección. El segundo contiene el
     nombre del fichero del mapa de bits que se visualiza al desactivar el
     cuadro de selección.

     El nombre del fichero del mapa de bits no debe incluir ni la unidad ni
     el directorio; en cambio, la extensión es obligatoria. Un mapa de bits
     se puede almacenar tanto en un fichero de disco como en una biblioteca
     de mapa de bits. En el primer caso se debe almacenar en el directorio
     de la aplicación. Si se guarda en una biblioteca, ésta debe estar en el
     directorio de la aplicación, debe tener el mismo nombre y la extensión
     .BML.

     CA-Clipper busca primero el nombre del fichero en el disco y, si no lo
     encuentra, busca en la biblioteca de mapas de bits. Si no encuentra el
     fichero ni en el disco ni en la biblioteca, no visualiza ningún mapa de
     bits.

     Este argumento sólo afecta a las aplicaciones que se ejecuten en modo
     gráfico y se ignora en modo texto.

 Ejemplos

      Este ejemplo demuestra cómo añadir un cuadro de selección a
        una pantalla de entrada de datos:

        @ 5, 20 GET lSoloLectura CHECKBOX

      Este ejemplo muestra cómo añadir un título y un mensaje a un
        cuadro de selección:

        @ 5, 20 GET lSoloLectura CHECKBOX ;
               CAPTION "&Sólo Lectura " ;
               MESSAGE "Para abrir el archivo en modo sólo lectura"

      Este ejemplo muestra cómo reemplazar el carácter de marcado ()
        por otro carácter (X).

        @ 5, 20 GET lSoloLectura CHECKBOX ;
               CAPTION "&Sólo Lectura " ;
               MESSAGE "Para abrir el archivo en modo sólo lectura" ;
               STYLE "[X ]"

 Ficheros   Las bibliotecas asociadas son CLIPPER.LIB y LLIBG.LIB.

 To download this example - click here.

See Also: @...GET Get CheckBox READ