FileOpenDialog

Top  Previous  Next

Описание

Открыть стандартный диалог открытия файла.

Синтаксис

String FileOpenDialog(

       string Filename,

                       string FilenameFilter,

                       int FilterIndex,

                       string InitialDir,

                       string DefaultExt,

                       bool HideReadOnly,

                       bool PathMustExist,

                       bool FileMustExist,

                       bool NoValidate,

                       bool NoChangeDir,

                       bool AllowMultiSelect,

                       bool CreatePrompt,

                       bool NoReadOnlyReturn,

                       bool NoTestFileCreate,

                       bool OverwritePrompt,

                       bool ShareAware,

                       bool ShowHelp)

Параметры

string FileName=имя и путь последнего выбранного файла.

string FileNameFilter= маска файла (фильтр)

int FilterIndex=фильтр, выбранный по умолчанию при открытии диалога.

string InitialDir=текущий каталог, в котором открыт диалог.

string DefaultExt=расширение имени файла по умолчанию.

bool HideReadOnly= удалить из диалога check box «Open As Read Only».

bool PathMustExist= генерировать сообщение об ошибке при попытке пользователя выбрать имя файла с несуществующим путём.

bool FileMustExist= генерировать сообщение об ошибке при попытке пользователя выбрать несуществующий файл.

bool NoValidate= отключить проверку на недопустимые символы в имени файла. Позволяет выбрать имя файла с недопустимыми символами.

bool NoChangeDir= после нажатия пользователем OK сбросить текущий каталог к тому, который был до открытия диалога выбора файла.

bool AllowMultiSelect=разрешить пользователю выбирать в диалоге более одного файла.

bool CreatePrompt=генерировать предупредительное сообщение при попытке пользователя выбрать несуществующий файл, запрашивать в этом случае создание файла с указанным именем.

bool NoReadOnlyReturn=генерировать сообщение об ошибке при попытке пользователя выбрать файл с атрибутом «только для чтения».

bool NoTestFileCreate= отключить проверку сетевой защиты файла и недоступности дисководов. Применяется только, когда пользователь пытается сохранить файл в разделяемом сетевом каталоге "create-no-modify".

bool OverwritePrompt=генерировать предупредительное сообщение при попытке пользователя выбрать имя уже используемого (already in use) файла, запрашивать в этом случае разрешение на перезапись существующего файла.

bool ShareAware= игнорировать ошибки совместного использования (sharing) и позволить файлам быть выбранными, даже когда возникают ошибки совместного доступа.

bool ShowHelp=показывать в диалоге кнопку Help.

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

Если нажата кнопка "OK" — строка «путь + имя файла».

Если нажата кнопка "ESC" — пустая строка.

Связанные функции

FileSaveDialog()

Пример

string FileName;



FileName=FileOpenDialog("",   //Filename .

                          "*.txt|*.dat",     //Filename filter & filter patterns.

                          1,                 //Filter Index

                          "C:\",             //Initial dir.

                          "*",               //Default extension

                          true,              // HideReadOnly

                          false,             // PathMustExist

                          false,             // FileMustExist

                          false,             // NoValidate

                          false,             // NoChangeDir

                          false,             // AllowMultiSelect

                          false,             // CreatePrompt

                          false,             // NoReadOnlyReturn

                          false,             // NoTestFileCreate

                          false,             // OverwritePrompt

                          false,             // ShareAware

                          false);            // ShowHelp

 

MessageBox(FileName,"File Selected");