GETDIR( ) (Función)
Muestra el cuadro de diálogo Seleccionar directorio, en el que puede elegir un directorio.
GETDIR([cDirectory [, cText [, cCaption [, nFlags [, lRootOnly]]]]])
Valores devueltos
Character
Parámetros
cDirectory
Especifica el directorio que aparece inicialmente en el cuadro de diálogo Seleccionar directorio. Cuando no se especifica cDirectory el cuadro de diálogo Seleccionar directorio se abrirá mostrando el directorio predeterminado de Visual FoxPro.cText
Especifica el texto para la lista de directorios o de carpetas en el cuadro de diálogo.cCaption
Especifica el título que se va a mostrar en la barra de título del cuadro de diálogo. El valor predeterminado de Windows es "Buscar carpeta".nFlags
Especifique las opciones del cuadro de diálogo. El parámetro nFlags puede no tener ningún valor o incluir una combinación aditiva de valores. En la tabla siguiente se describen algunos de los indicadores más comunes. Para obtener más información, vea la descripción de SHBrowseForFolder en MSDN.nFlag Valor Descripción 1 BIF_RETURNONLYFSDIRS Devuelve únicamente directorios del sistema de archivos (ubicaciones físicas). Si un usuario selecciona carpetas que no forman parte del sistema de archivos, se atenúa el botón Aceptar. 2 BIF_DONTGOBELOWDOMAIN No incluye carpetas de red bajo el nivel de dominio del control de vista de árbol (por ejemplo Mi PC y Mi red). 8 BIF_RETURNFSANCESTORS Sólo devuelve antecesores del sistema de archivos. Si un usuario selecciona otra cosa que no sea un antecesor del sistema de archivos, se atenuará el botón Aceptar. 16 BIF_EDITBOX El cuadro de diálogo Examinar incluye un control de edición en el que el usuario puede escribir el nombre de un elemento. Está disponible en Windows 98 y en las versiones posteriores, o en Internet Explorer 4.0 y en las versiones posteriores (suponiendo que la opción de integración de shell está activada). Requiere la versión 4.71 de shell32.dll. 64 BIF_NEWDIALOGSTYLE Se utiliza la nueva interfaz de usuario. Si se establece este indicador, se proporciona al usuario un cuadro de diálogo más grande y de tamaño ajustable. Algunas características adicionales son: capacidad de arrastrar y colocar dentro del cuadro de diálogo, reordenar, menús contextuales, carpetas nuevas, comando eliminar y otros comandos del menú contextual. Es compatible con Windows 2000 y con las versiones posteriores. Requiere la versión 5.00 de shell32.dll. 16384 BIF_BROWSEINCLUDEFILES El cuadro de diálogo Examinar mostrará archivos además de carpetas. Está disponible en Windows 98 y en las versiones posteriores, o en Internet Explorer 4.0 y en las versiones posteriores (suponiendo que la opción de integración de shell está activada). Requiere la versión 4.71 de shell32.dll. lRootOnly
Especifica que sólo debe mostrarse cDirectory y sus subcarpetas. Este parámetro evita la exploración más allá de la carpeta raíz. Si no especifica cDirectory, se utilizará el directorio predeterminado (el valor de SET DEFAULT).
Observaciones
GETDIR( ) devuelve como una cadena de caracteres el nombre del directorio que elija.
Si no elige ningún directorio (si elige Cancelar, presiona ESC, o elige Cerrar en la ventana menú, GETDIR( ) devolverá la cadena vacía.
En esta versión de Visual FoxPro, GETDIR( ) admite dos cuadros de diálogo diferentes. Si proporciona menos de tres parámetros, GETDIR( ) devolverá el cuadro de diálogo de las versiones anteriores. Si proporciona más de dos parámetros, Visual FoxPro utilizará la rutina SHBrowseForFolder de la API Win32 para proporcionar el cuadro de diálogo.