CLEAR (Comandos)

  • Artículo

Libera de la memoria el elemento o los elementos especificados.

CLEAR [ALL | CLASS ClassName | CLASSLIB ClassLibraryName | DEBUG | DLLS
   [cAliasNameList]| EVENTS | FIELDS | GETS | MACROS | MEMORY 
   | MENUS | POPUPS | PROGRAM | PROMPT | READ [ALL] | RESOURCES 
   [FileName] | TYPEAHEAD | WINDOWS]

Parámetros

  • ALL
    Libera de la memoria todas las variables y matrices, así como las definiciones de todas las barras de menús, menús y ventanas definidas por el usuario. CLOSE ALL también cierra las tablas, lo que incluye todos los archivos de índices, memo y de formato asociados, y selecciona el área de trabajo 1. CLEAR ALL también libera de la memoria todas las funciones de bibliotecas compartidas externas registradas con DECLARE - DLL.

    CLEAR ALL no libera las variables del sistema y no borra el búfer de programas compilados. Utilice CLEAR PROGRAM para borrar el búfer de programas compilados.

    Si ejecuta CLEAR ALL sobre un evento o un método para un control o un objeto activo, se genera un mensaje de error de Visual FoxPro. Una variable de tipo Object no se puede liberar de la memoria cuando su control u objeto asociado está activo.

  • CLASS ClassName
    Borra de la memoria una definición de clase. Cuando se crea una instancia de una clase, Visual FoxPro conserva en memoria la definición de clase después de liberar la instancia. Utilice CLEAR CLASS para borrar de la memoria una definición de clase después de liberar su instancia.

  • CLASSLIB ClassLibraryName
    Borra de la memoria todas las definiciones de clase contenidas en una biblioteca de clases visuales. Si existen instancias de clases en la biblioteca de clases, las definiciones de clase no se borrarán de la memoria y se generará un mensaje de error. Sin embargo, todas las definiciones de clase que no tengan instancias se borrarán de la memoria.

  • DEBUG
    Borra todos los puntos de interrupción en el Depurador y restaura las ventanas del Depurador (Pila de llamadas, Seguimiento, Inspección, etc.) a sus posiciones predeterminadas.

    Si se ejecuta Clear Debug mientras está cerrado el Depurador, se abrirá el Depurador con sus ventanas en las posiciones predeterminadas.

    Funciona tanto en modo de marco de depurador como en modo de marco de fox.

  • DLLS cAliasNameList
    Borra de la memoria las bibliotecas compartidas externas registradas con DECLARE - DLL. cAliasNameList es una lista, separada por comas, de los alias de función que se van a quitar de la memoria, como en el siguiente ejemplo:

    CLEAR DLLS  "RegCloseKey","RegOpenKey"

    Si no utilizó ningún alias en la declaración, cAliasNameList es igual al nombre de la función. Si se especifica cAliasNameList, todas las DLL se quitan de la memoria. Puede utilizar la función ADLLS( ) para determinar qué DLL están cargadas.

    Vea DECLARE - DLL (Comando) para obtener más información acerca del registro de bibliotecas compartidas externas.

  • EVENTS
    Detiene el procesamiento de eventos iniciado con READ EVENTS. Cuando se ejecuta CLEAR EVENTS, la ejecución del programa continúa en la línea de programa inmediatamente posterior a READ EVENTS.

  • FIELDS
    Libera una lista creada con SET FIELDS y ejecuta SET FIELDS OFF. CLEAR FIELDS se diferencia de SET FIELDS TO en que libera todas las listas de campos en todas las áreas de trabajo, no sólo la lista de campos del área de trabajo actual. Además, SET FIELDS TO no ejecuta implícitamente SET FIELDS OFF.

  • GETS
    Libera todos los controles @ ... GET pendientes. La ejecución de CLEAR también libera todos los controles @ ... GET pendientes.

    Nota   GETS se incluye por compatibilidad con versiones anteriores.

  • MACROS
    Libera de la memoria todas las macros de teclado, incluidas todas las asignaciones de teclas de SET FUNCTION. Las macros se pueden guardar en un archivo de macro o en un campo memo con SAVE MACROS y restaurarse más tarde con RESTORE MACROS. También puede restaurar las macros predeterminadas con RESTORE MACROS.

  • MEMORY
    Libera de la memoria todas las variables y matrices públicas y privadas. Las variables del sistema no se liberan.

  • MENUS
    Libera de la memoria todas las definiciones de barras de menús.

  • POPUPS
    Libera de la memoria todas las definiciones de menús creadas con DEFINE POPUP.

  • PROGRAM
    Borra el búfer del programa compilado. Visual FoxPro mantiene un búfer de los programas ejecutados más recientemente. En raras ocasiones puede ocurrir que Visual FoxPro no reconozca los cambios efectuados en los archivos de programa en disco. CLEAR PROGRAM obliga a Visual FoxPro a leer los programas en el disco, en lugar de en el búfer de programas. La razón más común por la que Visual FoxPro puede no reconocer los cambios en los archivos de programa es el uso de un editor TSR (programa residente) o externo para modificar un archivo de programa. Salvo esta excepción, no debería ser necesario el uso de CLEAR PROGRAM.

  • PROMPT
    Libera los elementos de menú creados con @ ... PROMPT.

  • READ [ALL]
    Se incluye por compatibilidad con versiones anteriores. Utilice CLEAR EVENTS en su lugar.

  • RESOURCES [FileName]
    Especifica el nombre de un mapa de bits, una imagen, una fuente, un cursor o un archivo de icono en caché que se va a borrar de la memoria. Si no se especifica ningún nombre de archivo, se borrarán de la memora todos los mapas de bits, imágenes, fuentes, cursores y archivos de icono.

    Cuando Visual FoxPro muestra un mapa de bits, un cursor, una imagen, un icono o un recurso de fuentes, se almacenará el recurso en la caché para mejorar el rendimiento. Si se ha utilizado un recurso con el mismo nombre (por ejemplo, un mapa de bits distinto con el mismo nombre que otro que ya está en la caché), Visual FoxPro no volverá a cargar el recurso.

    El hecho de borrar un archivo de recursos es, por tanto, especialmente útil para quitar una imagen gráfica de la memoria y para forzar a Visual FoxPro a volver a cargar una imagen del mismo nombre del disco. Por ejemplo, es posible que un informe muestre imágenes gráficas procedentes de una base de datos y que todas se llamen TEMP. Sin embargo, dado que todas se llaman igual, Visual FoxPro no volverá a cargar cada nuevo gráfico a no ser que se haya borrado de la memoria el ya existente mediante el comando CLEAR RESOURCES.

  • TYPEAHEAD
    Borra el búfer de escritura de teclado. CLEAR TYPEAHEAD es útil cuando se desea impedir la entrada en un campo o la respuesta a una petición antes de que se muestren el campo o la petición.

  • WINDOWS
    Libera de la memoria todas las definiciones de ventanas definidas por el usuario y borra las ventanas de la ventana principal de Visual FoxPro o la ventana activa definida por el usuario. Las definiciones de ventanas se pueden guardar con SAVE WINDOW en un archivo o campo memo para su uso posterior.

    La ejecución de CLEAR WINDOWS libera cualquier referencia de variable de sistema a formularios. Por ejemplo, los comandos siguientes crean una referencia de variable de sistema para un formulario y, después, muestran información acerca de dicha variable:

    goMyForm = CREATEOBJECT('FORM')
DISPLAY MEMORY LIKE goMyForm  && Displays GOMYFORM  O  FORM

    La ejecución de CLEAR WINDOWS libera la referencia de variable de sistema y la variable contiene ahora el valor nulo:

    CLEAR WINDOWS
DISPLAY MEMORY LIKE goMyForm  && Displays GOMYFORM  O  .NULL.

Observaciones

CLEAR borra la ventana principal de Visual FoxPro o la ventana activa definida por el usuario y libera de la memoria todos los controles @ ... GET pendientes. Se puede incluir CLEAR en archivos de formato.

Vea también

@ ... CLEAR | CLOSE | DECLARE - DLL | READ | READ EVENTS | RELEASE | RELEASE CLASSLIB | RELEASE WINDOWS