Отображает Диалоговое окно 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).

Expand imageВозвращаемое значение

Character

Expand imageЗамечания

Функция GETDIR( ) возвращает имя выбранного каталога в виде символьной строки.

Если не выбран никакой каталог (была нажата кнопка Cancel или клавиша Esc или выбран пункт Close в меню управления окном), функция GETDIR( ) возвратит пустую строку.

Начиная с Visual FoxPro 7, функция GETDIR( ) поддерживает два различных диалоговых окна. При использовании только двух параметров, функция GETDIR( ) вызывает диалоговое окно более ранних версий. Если используется большее количество параметров, Visual FoxPro для отображения диалогового окна использует функцию SHBrowseForFolder из Win32 API.

Expand imageСмотрите также