GFRAME()
 Dibuja un borde en relieve
------------------------------------------------------------------------------
 Sintaxis

     GFRAME(<nXInic>, <nYInic>, <nXFin>, <nYFin>, <nColorFondo>,
        <nColorClaro>, <nColorOscuro>, <nAnchuraSup>, <nAnchuraDer>,
        <nAnchuraInf>, <nAnchuraIzq>, [<nModo>], [<nEstilo>]) --> NIL

 Argumentos

     <nXInic>, <nYInic>, <nXFin> y <nYFin> definen las
     coordenadas del borde en píxeles.

     <nColorFondo> es un valor numérico que representa el color de fondo
     del borde.

     <nColorClaro> es un valor numérico que representa el color claro
     del borde.

     <nColorOscuro> es un valor numérico que representa el color oscuro
     del borde.

     Este valor está limitado por el número de colores disponibles en el
     modo de vídeo seleccionado. En un modo de 16 colores, los valores
     válidos están comprendidos entre 0 y 15. En un modo de 256 colores,
     entre 0 y 255.

     <nAnchuraSup>, <nAnchuraDer>, <nAnchuraInf>,
      <nAnchuraIzq> son valores numéricos que representan el grosor de
     las líneas del borde.

     <nModo> representa el modo de visualización del borde. Toma uno de
     los siguientes valores:

     Constantes del modo de visualización del borde
     ------------------------------------------------------------------------
     Constante                Descripción
     ------------------------------------------------------------------------
     LLG_MODE_SET             Se utiliza el modo SET (se cubren los
                              píxeles del fondo). Es el modo de
                              visualización más habitual.
     LLG_MODE_AND             Se utiliza el modo AND (se realiza un AND
                              entre los píxeles del dibujo y los del fondo).
     LLG_MODE_OR              Se utiliza el modo OR (se realiza un OR
                              entre los píxeles del dibujo y los del fondo).
     LLG_MODE_XOR             Se utiliza el modo XOR (se realiza un XOR
                              entre los píxeles del dibujo y los del fondo).
                              Consulte la nota más adelante.
     ------------------------------------------------------------------------

     <nEstilo> define el estilo del borde. Se establece en una de las
     constantes de la tabla siguiente:

     Constantes del estilo de borde
     ------------------------------------------------------------------------
     Constante                Descripción
     ------------------------------------------------------------------------
     LLG_FILL                 Se rellena el borde con el color especificado
                              en <nColorFondo>. Es el valor por defecto.
     LLG_FRAME                Se dibuja en relieve sólo el contorno
                              del borde.
     ------------------------------------------------------------------------

     Nota:  Este método permite mover objetos por la pantalla sin
     afectar al dibujo del fondo. Para restaurar el dibujo del fondo se debe
     repetir la misma llamada con el modo de visualización XOR. Si se omite
     el modo de visualización, se utiliza el último modo especificado en una
     llamada a una función de CA-Clipper.

 Devuelve

     GFRAME() devuelve siempre NIL.

 Descripción

     GFRAME() dibuja bordes rectangulares en relieve utilizando tres
     colores. Por ejemplo, gris para el fondo, negro como color oscuro y
     blanco como color claro. Esta función sólo puede utilizarse si se ha
     establecido el modo gráfico para la pantalla con GMODE(). Esta función
     respeta las restricciones definidas con GSETCLIP().

 Ejemplos

      Este ejemplo muestra cómo visualizar una serie de bordes de 3
        píxeles de grosor:

        Cambia a modo gráfico
        SET VIDEOMODE TO LLG_VIDEO_VGA_640_480_16
        // Botones
        GFRAME(0, 0, 53, 399, 7, 15, 8, 3, 3, 3, 3, LLG_MODE_SET)
        // Coordenadas
        GFRAME(0, 400, 53, 456, 7, 15, 8, 3, 3, 3, 3, LLG_MODE_SET)
        // Dibujo
        GFRAME(54, 0, 639, 399, 7, 15, 8, 3, 3, 3, 3, LLG_MODE_SET)
        // Paleta
        GFRAME(54, 400, 639, 456, 7, 15, 8, 3, 3, 3, 3, LLG_MODE_SET)
        // Mensajes
        GFRAME(0, 457, 639, 479, 7, 15, 8, 3, 3, 3, 3, LLG_MODE_SET)
        QUIT                        // Fin de la aplicación

 Ficheros   La biblioteca asociada es LLIBG.LIB,
            el fichero de cabecera asociado es Llibg.ch.

 To download this example - click here.

See Also: DISPBOX() GBMPDISP() GLINE() GRECT() GWRITEAT()