GETFILE( ) (Función)

  • Artículo

Muestra el cuadro de diálogo Abrir y devuelve el nombre del archivo que elija.

GETFILE([cFileExtensions] [, cText] [, cOpenButtonCaption]
   [, nButtonType] [, cTitleBarCaption])

Valores devueltos

Character

Parámetros

  • cFileExtensions
    Especifica las extensiones de los archivos mostrados en la lista desplegable cuando el elemento de menú Todos los archivos no se ha elegido. Si se pasa un valor como un literal, es necesario entrecomillarlo. No incluya un punto (.) delante de las extensiones de archivo.

    cFileExtensions puede asumir diversas formas:

    • Si cFileExtensions contiene una única extensión (por ejemplo, .prg), solamente se mostrarán los archivos con esa extensión.

    • Si cFileExtensions es la cadena vacía, se mostrarán todos los archivos del directorio actual si no se ha incluido cCreatorType.

    • cFileExtensions puede contener también caracteres comodín (* y ?) de MS-DOS. Se mostrarán todos los archivos cuyas extensiones cumplan los criterios del comodín. Por ejemplo, si cFileExtensions es "?X?", se mostrarán todos los archivos que tengan la extensión .fxt, .exe y .txt.

    • En Visual FoxPro para Windows, cFileExtensions puede contener una descripción de archivo seguida de una extensión de archivo o de una lista de extensiones de archivo separadas por comas. La descripción del archivo aparece en el cuadro de lista Archivos de tipo. Utilice dos puntos (:) para separar la descripción del archivo de la extensión del archivo o de la lista de extensiones de archivo. Separe con un punto y coma (;) múltiples descripciones de archivo y sus extensiones de archivo.

      Por ejemplo, si cFileExtensions es "Texto:TXT" la descripción de archivo "Texto" aparecerá en el cuadro de lista Archivos de tipo y se mostrarán todos los archivos con la extensión .txt.

      Si cFileExtensions es "Tablas:DBF; Archivos:TXT,BAK" las descripciones de archivo "Tablas" y "Archivos" aparecerán en el cuadro de lista Archivos de tipo. Cuando se elige "Tablas" en el cuadro de lista Archivos de tipo, se mostrarán todos los archivos de extensión .dbf. Cuando se elija "Archivos" del cuadro de lista Archivos de tipo, se mostrarán todos los archivos con la extensión .txt y .bak.

    • Si cFileExtensions contiene sólo un punto y coma (";"), se mostrarán todos los archivos sin extensión.

  • cText
    Especifica el texto para la lista de directorios en el cuadro de diálogo Abrir.

  • cOpenButtonCaption
    Especifica un título para el botón Aceptar.

  • nButtonType
    Especifica el número y el tipo de botones que aparecen en el cuadro de diálogo Abrir. Los botones siguientes aparecen en el cuadro de diálogo cuando nButtonType es 0, 1 ó 2:

    nButtonType Botones
    0 (o si se omite) OKCancel
    1 OKNewCancel
    2 OKNoneCancel

    Se devolverá "Sin título" con la ruta de acceso especificada en el cuadro de diálogo Abrir si nButtonType es 1 y el usuario elige el botón Nuevo. Se devolverá la cadena vacía si nButtonType es 2 y el usuario elige el botón Ninguno.

  • cTitleBarCaption
    Especifica el título de la barra de títulos.

Observaciones

GETFILE( ) devuelve la cadena vacía si sale del cuadro de diálogo Abrir presionando ESC, eligiendo Cancelar o eligiendo Cerrar en el menú Control.

Ejemplo

CLOSE DATABASES
SELECT 0

gcTable = GETFILE('DBF', 'Browse or Create a .DBF:', 'Browse', 1;   'Browse or Create')
DO CASE
   CASE 'Untitled' $ gcTable
      CREATE (gcTable)
   CASE EMPTY(gcTable)
      RETURN
   OTHERWISE
      USE (gcTable)
      BROWSE
ENDCASE

Vea también

FULLPATH( ) | GETEXPR | GETPICT( ) | LOCFILE( ) | PUTFILE( )