PUTFILE( ) (Función)

  • Artículo

Llama al cuadro de diálogo Guardar como y devuelve el nombre de archivo que especifique.

PUTFILE([cCustomText] [, cFileName] [, cFileExtensions])

Valores devueltos

Character

Parámetros

  • cCustomText
    Especifica el texto personalizado que se muestra en el cuadro de diálogo Guardar como.

  • cFileName
    Especifica el nombre de archivo predeterminado que aparece en el cuadro de texto.

  • cFileExtensions
    Especifica extensiones de nombres de archivo. Sólo los nombres de archivo con la extensión especificada aparecerán en la lista de desplazamiento del cuadro de diálogo Guardar como cuando se desactiva la casilla de verificación Todos los archivos. La primera extensión en cFileExtensions se anexará automáticamente al nombre de archivo introducido si no se ha incluido ninguna extensión con el nombre de archivo. Si desea consultar una lista de las extensiones de archivo de Visual FoxPro y los correspondientes tipos de creador, vea el tema en pantalla Tipos y extensiones de archivos.

    La expresión de caracteres cFileExtensions puede tener una de las formas siguientes:

    • cFileExtensions puede contener una sola extensión, por ejemplo PRG, y solamente se mostrarán los nombres con esa extensión.
    • cFileExtensions puede contener una lista de extensiones de nombre de archivo separadas por signos de punto y coma. Por ejemplo, si incluye PRG;FXP Visual FoxPro mostrará todos los nombres de archivo con las extensiones .prg y .fxp.
    • Si los nombres de archivo tienen el mismo nombre raíz pero extensiones diferentes (por ejemplo, Customer.prg y Customer.fxp), Visual FoxPro únicamente mostrará el nombre de archivo con la primera extensión que aparezca en cFileExtensions.
    • cFileExtensions puede contener una lista de extensiones de nombres de archivo separadas por barras verticales (por ejemplo PRG|FXP). En este caso, Visual FoxPro mostrará todos los nombres de archivo con las extensiones indicadas, incluso si los archivos tienen el mismo nombre raíz.
    • Si cFileExtensions contiene solamente un punto y coma (;), Visual FoxPro mostrará todos los nombres de archivo que no tengan extensión.
    • Si cFileExtensions es una cadena vacía, Visual FoxPro mostrará los nombres de todos los archivos del directorio o carpeta actual.
    • Si cFileExtensions contiene caracteres comodín de MS-DOS (como ? y *), Visual FoxPro mostrará todos los nombres de archivo con extensiones que cumplan los criterios del comodín. Por ejemplo, si cFileExtensions es ?X?, se mostrarán todos los nombres de archivo con las extensiones .fxp,.exe, .txt, etc.

Observaciones

Utilice PUTFILE( ) para elegir un nombre de archivo existente o especificar un nombre de archivo nuevo. PUTFILE( ) devuelve el nombre de archivo con su ruta de acceso. Si no se introduce un nombre de archivo, PUTFILE( ) devuelve el nombre de archivo predeterminado (especificado por cFileName) y la extensión (especificada por cFileExtensions). Si elige Cancelar o presiona ESC, PUTFILE( ) devuelve una cadena vacía. Puede utilizar el nombre de archivo que devuelve PUTFILE( ) para nombrar un archivo y guardarlo en el disco.

Ejemplo

Este ejemplo crea un archivo de datos delimitado a partir de una tabla existente elegida por el usuario. GETFILE( ) se utiliza para buscar y abrir una tabla, y PUTFILE( ) se utiliza para devolver el nombre del archivo de destino.

gcTableName = GETFILE('DBF', 'Open Table:')
USE (gcTableName)
gcDelimName = ALIAS( ) + '.DLM'
gcDelimFile = PUTFILE('Delimited file:', gcDelimName, 'DLM')
IF EMPTY(gcDelimFile)  && Esc pressed
   CANCEL
ENDIF
COPY TO (gcDelimFile) DELIMITED   && Create delimited file
MODIFY FILE (gcDelimFile) NOEDIT

Vea también

FILE( ) | GETEXPR | GETFILE( ) | GETPICT( ) | LOCFILE( )