MSETCLIP()
 Define un área de inclusión
------------------------------------------------------------------------------
 Sintaxis

     MSETCLIP([<lista nCoord>], [<nModo>])

 Argumentos

     <lista nCoord> contiene las coordenadas de la región de inclusión
     expresada como una lista de cuatro coordenadas separadas por comas y
     cuya interpretación depende del modo elegido. Si <nModo> es
     LLM_COOR_TEXT, las coordenadas tienen la forma: <nSup>, <nIzq>, <nInf>,
     <nDer>. Si <nModo> es LLM_COOR_GRAPH, las coordenadas son <nX1>, <nY1>,
     <nX2>, <nY2>.

     <nModo> es una de las dos constantes siguientes:

     Constantes de tipo coordenadas
     ------------------------------------------------------------------------
     Constante                Descripción
     ------------------------------------------------------------------------
     LLM_COOR_TEXT            Las coordenadas representan líneas
                              y columnas de texto
     LLM_COOR_GRAPH           Las coordenadas representan píxeles
     ------------------------------------------------------------------------

 Devuelve

     MSETCLIP() devuelve una matriz con información de las coordenadas. Las
     coordenadas del área de inclusión se expresan en píxeles y, a
     continuación, en formato de líneas/columnas:

        aRegiones := {nIncX1, nIncY1, nIncX2, nIncY2,;   // en píxeles
           nIncF1, nIncC1, nIncF2, nIncC2,;              // en filas/columnas
           nTipoCoord}

 Descripción

     MSETCLIP() controla los movimientos del puntero del ratón limitándolos
     a una región de la pantalla. Si hay un área de inclusión definida y el
     usuario intenta mover el ratón más allá de sus límites, el puntero del
     ratón no desaparece pero se mantiene inmóvil en el borde del área. Esta
     función se utiliza para limitar las acciones del usuario con el ratón.

 Notas

     El valor inicial del área de inclusión es la pantalla entera. Para
     eliminar un área de inclusión se debe pasar el valor LLM_INCLUDE como
     primer parámetro o cuatro parámetros con los límites máximos de la
     pantalla: 0, 0, MAXCOL(), MAXROW().

 Ejemplos

      Este ejemplo muestra el funcionamiento de MSETCLIP():

        // Define un área de inclusión y guarda la anterior
        // en la matriz aAntInc

           aAntInc := MSETCLIP(5, 5, 20, 75,LLM_COOR_TEXT)
        // código para seleccionar objetos y botones
        // Restablecer el área de inclusión anterior
        MSETCLIP(aAntInc[5],;
           aAntInc[6],;
           aAntInc[7],;
           aAntInc[8],;
           LLM_COOR_TEXT)

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

 To download this example - click here.

See Also: MHIDE() MSETCURSOR() MSHOW()