_EdScrollToPos( ) (Rutina de biblioteca API)

Se asegura de que esté visible la posición de desplazamiento especificada en el archivo en la ventana de edición designada.

void _EdScrollToPos(WHANDLE wh, EDPOS thePos, int Center)
WHANDLE wh;            /* Handle of editing window. */
EDPOS thePos;               /* Offset position to make visible. */
int Center;                  /* Whether or not to center position
 in window. */

Observaciones

_EdScrollToPos( ) no mueve el punto de inserción. Especifique Center como verdadero para centrar la posición verticalmente en la ventana o como falso para no centrarla verticalmente.

Para obtener más información acerca de cómo crear una biblioteca API e integrarla con Visual FoxPro, vea Acceso a la API de Visual FoxPro.

Ejemplo

El siguiente ejemplo abre un archivo especificado por un parámetro para su modificación. Tras desplazarse a la parte superior del archivo mediante una llamada a _EdScrollToPos( ), el procedimiento llama a _EdPosInView( ) para comprobar si el principio y el final del archivo están en la vista, e imprime el resultado en la pantalla. A continuación, se desplaza al final del archivo mediante una llamada a _EdScrollToPos( ) y vuelve a llamar a _EdPosInView( ) para comprobar si el principio y el final del archivo están en la vista.

Código Visual FoxPro

SET LIBRARY TO EDSCTOPO
= POSINVIEW("x")

Código C

#include <pro_ext.h>

void putLong(long n)
{
   Value val;

   val.ev_type = 'I';
   val.ev_long = n;
   val.ev_width = 10;

   _PutValue(&val);
}

FAR Example(ParamBlk FAR *parm)
{
#define pFILENAME ((char FAR *) _HandToPtr(parm->p[0].val.ev_handle))

   WHANDLE wh;
   EDENV EdEnv;

   if (!_SetHandSize(parm->p[0].val.ev_handle, 
      parm->p[0].val.ev_length+1)) {
      _Error(182); // "Insufficient memory"
   }
   pFILENAME[parm->p[0].val.ev_length] = '\0';

   _HLock(parm->p[0].val.ev_handle);
   wh = _EdOpenFile(pFILENAME, FO_READONLY);
   _HUnLock(parm->p[0].val.ev_handle);

   _EdGetEnv(wh, &EdEnv);

   _EdScrollToPos(wh, 0, FALSE);
   _PutStr("\n_EdScrollToPos(wh, 0)");
   _PutStr("\n_EdPosInView(wh, 0) =");
   putLong(_EdPosInView(wh, 0));
   _PutStr("\n_EdPosInView(wh, EdEnv.length) =");
   putLong(_EdPosInView(wh, EdEnv.length));

   _EdScrollToPos(wh, EdEnv.length, FALSE);
   _PutStr("\n_EdScrollToPos(wh, EdEnv.length)");
   _PutStr("\n_EdPosInView(wh, 0) =");
   putLong(_EdPosInView(wh, 0));
   _PutStr("\n_EdPosInView(wh, EdEnv.length) =");
   putLong(_EdPosInView(wh, EdEnv.length));
}

FoxInfo myFoxInfo[] = {
   {"POSINVIEW", (FPFI) Example, 1, "C"},
};
FoxTable _FoxTable = {
   (FoxTable FAR *) 0, sizeof(myFoxInfo)/sizeof(FoxInfo), myFoxInfo
};

Vea también

_EdPosInView( ) (Rutina de biblioteca API) | Acceso a la API de Visual FoxPro | SYS(2002) - Activar o desactivar el punto de inserción _EdInsert( ) (Rutina de biblioteca API)