Отображает Диалоговое окно Select Directory, в котором можно выбрать нужный каталог.
GETDIR([cDirectory [, cText [, cCaption [, nFlags [, lRootOnly]]]]]) |
Параметры
- cDirectory
-
Задает каталог, который отображается при первом появлении диалогового окна. Если параметр cDirectory не задан, диалоговое окно открывается с отображенным в нем каталогом Visual FoxPro, используемым по умолчанию.
- cText
-
Определяет текст, выводимый над списком каталогов в диалоговом окне.
- cCaption
-
Определяет текст, выводимый в области заголовка диалогового окна. Заголовок Windows по умолчанию - "Select Directory".
- nFlags
-
Определяет варианты диалогового окна. Параметр nFlags может быть нулевым или включать совокупную комбинацию значений. Следующая таблица включает некоторые из типичных флажков. Для более подробной информации смотрите SHBrowseForFolder в MSDN.
nFlag Значение Описание 1
BIF_RETURNONLYFSDIRS
Возвращаются только каталоги файловой системы (физическое местоположение). Если пользователь выбирает папки, не являющиеся частью файловой системы, кнопка OK будет недоступна.
2
BIF_DONTGOBELOWDOMAIN
В дерево не включаются объекты сетевого окружения ниже доменного уровня.
8
BIF_RETURNFSANCESTORS
Возвращаются только те объекты, предками которых является файловая система. В противном случае кнопка OK будет недоступна.
16
BIF_EDITBOX
В диалоговое окно добавляется поле редактирования, в котором пользователь может ввести искомое имя. Доступно, под Windows 98 и выше, или с Internet Explorer 4.0 или выше (при выборе опции интеграции оболочки). Требует shell32.dll версии 4.71.
32
BIF_VALIDATE
Проверяет допустимость введенного в поле редактирования значения. Если поле редактирования используется, необходимо проверить допустимость введенных пользователем данных. Если пользователем введено недопустимое имя, доступна только кнопка Cancel (Отмена). Этот флажок игнорируется, если не задан BIF_EDITBOX.
64
BIF_NEWDIALOGSTYLE
Позволяет использовать новый пользовательский интерфейс. Установка этого флажка обеспечивает пользователя диалоговым окном изменяемого размера с расширенными возможностями. Дополнительные функциональные возможности включают: перетаскивание в пределах диалогового окна, переупорядочение, вызов контекстного меню нажатием правой кнопки мыши, кнопка создания новых папок. Поддерживается под Windows 2000 и выше. Требует shell32.dll версии 5.00.
16384
BIF_BROWSEINCLUDEFILES
Наряду с папками отображаются и файлы. Доступно, под Windows 98 и выше, или с Internet Explorer 4.0 или выше (при выборе опции интеграции оболочки). Требует shell32.dll версии 4.71.
- lRootOnly
-
Определяет, что отображаться будет только содержимое каталога cDirectory и его подкаталогов. Этот параметр предотвращает перемещение на более высокий уровень, чем задано. Если параметр cDirectory не задан, используется каталог по умолчанию (установка SET DEFAULT).
Возвращаемое значение
Character
Замечания
Функция GETDIR( ) возвращает имя выбранного каталога в виде символьной строки.
Если не выбран никакой каталог (была нажата кнопка Cancel или клавиша Esc или выбран пункт Close в меню управления окном), функция GETDIR( ) возвратит пустую строку.
Начиная с Visual FoxPro 7, функция GETDIR( ) поддерживает два различных диалоговых окна. При использовании только двух параметров, функция GETDIR( ) вызывает диалоговое окно более ранних версий. Если используется большее количество параметров, Visual FoxPro для отображения диалогового окна использует функцию SHBrowseForFolder из Win32 API.
Смотрите также
Справочное руководство
Команда DIR или DIRECTORYКоманда GETEXPR
Функция DIRECTORY( )
Функция GETFILE( )
Прочие ресурсы
FunctionsСправочное руководство по языку (Visual FoxPro)