PromptForFileName - Функция. Справочник

Delphi справочник - Форум программистов - Навигация

A B C D E F G H I J K L M N O P Q R S T U V W X Y Z По первой букве

System SysUtils StrUtils DateUtils FileCtrl ConvUtils StdConvs Math Classes Dialogs Types Variants ПО Unit Compiler directives Directives Keywords Types Variables Constants Functions Procedures По категории

Основы Delphi
PromptForFileName Функция	Показывает диалог, позволяющий пользователю выбрать файл	Dialogs unit

function PromptForFileName ( var FileName : string; { const Filter : string; const DefaultExt : string; const Title : string; const InitialDir : string; SaveDialog : Boolean = False } ) : Boolean;

Описание

Функция PromptForFileName представляет диалог пользователю, позволяющий передвижение и выбор файла.

Если пользователь нажал OK, переменной FileName присваивается значение полного пути: диск/путь/имя файла выбранного файла, и возвращается значение Истина(True).

Если пользователь нажал Cancel, никакие изменения не происходят, и возвращаемое значение будет Ложь(False).

Передающиеся параметры могут быть произвольными:

Filter

Используется, чтобы ограничить типы отображаемых файлов. Следующий формат:

'Description|filter{|...}'

Например, чтобы показать только .txt и .pas файлы:

Текстовые файлы (*.txt) | *.txt|Delphi файлы (*.pas) | *.pas

DefaultExt

Используется, чтобы определить расширение для добавления к новому имени файла (если SaveDialog Истенен(True)).

Title

Используется, чтобы дать диалогу заголовок.

InitialDir

Позиционирует диалог в данный каталог. Например:

'C:Program Files'

SaveDialog

Определяет, может ли новый файл быть выбран для сохранения.

Похожие команды

InputBox  Отображает диалог, который просит пользователя о вводе текста, со значением по умолчанию

InputQuery  Отображает диалог, который просит пользователя о вводе текста

ShowMessage  Показывает простое диалоговое окно с кнопкой ОК, содержащее заданную строку

ShowMessageFmt

ShowMessagePos  Показывает строку в простом диалоговом окне размещенном в заданном месте

TOpenDialog  Отображает диалог выбора файла

TSaveDialog  Отображает диалог для выбора имени сохраняемого файла

Пример кода : Использование этого диалога для выбора текстового файла

var
  selectedFile   : string;

begin
  // Спрашиваем пользователя о выборе файла
  if PromptForFileName(selectedFile,
                       'Text files (*.txt)|*.txt',
                       '',
                       'Выберите ваш проектный файл',
                       'C:\',
                       False)  // Означает, что диалог без Сохранения
  then
    // Отображения этого полного значения файла/пути
    ShowMessage('Выбранный файл = '+selectedFile)
  else
    ShowMessage('Нажал Cancel');
end;

{В диалоге пользователь выбрал: C:\Files\data.txt и нажал OK}

Выбранный файл = C:\Files\data.txt

Оплата за обучение в Kata Academy только после твоего трудоустройства в IT, начни карьеру Middle Java-разработчика

Интенсив по Python: Работа с API и фреймворками 24-26 ИЮНЯ 2022. Знаете Python, но хотите расширить свои навыки? Slurm подготовили для вас особенный продукт!