Отображает диалоговое окно Open.

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

Параметры

cFileExtensions

Задает расширения имен файлов, отображаемых в прокручиваемом списке, если элемент меню All Files не установлен. При принятии значения как строковое, поместите его в кавычки (" "). Не включайте (.) перед расширением имени файла.
Комментарии:
Параметер cFileExtensions недолжен привышать длину 254 символов.

Аргумент cFileExtensions может принимать разные формы:
  • Если cFileExtensions содержит только одно расширение имени (например PRG), на экране отображаются только файлы с данным расширением..

  • Если cFileExtensions представляет собой пустую строку, будут отображены все файлы текущего каталога.

  • cFileExtensions может также содержать символы подстановки (* и ?). Отображаются все файлы, расширения которых удовлетворяют данному критерию с учетом символов подстановки. Например, если cFileExtensions содержит ?X?, будут отображены все файлы с расширениями .FXP, .EXE и .TXT.

  • cFileExtensions может содержать описание файла, дополненное расширением файла или списком расширений файла, отделенных запятыми. Описание файла появляется в диалоговом окне Open в поле выбора списка Типа файла. Отделите описание файла от расширения файла или списка расширений файла двоеточием (:). Отделите множественные описания файла и их расширения точкой с запятой (;).

    Например, если cFileExtensions задать - "Text:TXT", в диалоговом окне Open отображает описание файла "Text" в поле выбора списка типов и отображает все файлы имеющие расширение .txt.

    Если cFileExtensions задать "Tables:DBF; Files:TXT, BAK" описания файла "Tables" и "Files" появляются в поле выбора типов файла. А при выборе "Tables" в поле выбора типа файлов, будут отображены все файлы с расширением .dbf отображены. При выборе "Files" в поле списка типов файлов, отображены будут все файлы расширением .txt, и .bak.

  • Если cFileExtensions содержит только точку с запятой (;), будут отображены все файлы без расширений.

cText

Определяет текст для метки Имени файла в диалоговом окне Open.
cOpenButtonCaption

Задает надпись для кнопки OК в диалоговом окне Open.
nButtonType

Задает число и тип кнопок, изображаемых в диалоговом окне Open. В следующей таблице перечислены значения дляnButtonType.

nButtonType Buttons displayed

0 (или опущен)

OK, Cancel

1

OK, New, Cancel

2

OK, None, Cancel

Комментарии:
GETFILE () возвращает строку "Untitled" с путем, указанным в диалоговом окне Open, когда nButtonType установлен в 1 и пользователь выбрал New, или когда nButtonType установлен в 2, и пользователь выбрал None.

cTitleBarCaption

Задает надпись заголовка диалогового окна Open.

Результат

Символьный. GETFILE( ) возвращает имя выбранного файла в диалоговом окне Open или возвратит пустую строку, если выйти из диалогового окна Open, нажав клавишу Esc или кнопку Cancel или выбрав Close из меню Control.

Замечания

Пример

  Копировать код
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

See Also