TFileDialog (модуль OStdDlgs)


TObject
 
Init
Done
Free
TWindowsObject
ChildList Parent
Flags Status
HWindow TransferBuffer
Instance
Init GetChildren
LoadGetClassName
Done GetClient
AddChild GetId
At GetSiblingPtr
Canclose GetWindowClass
ChildWithId IndexOf
CloseWindow IsFlagSet
CMExit Next
Create Previous
CreateChildren PutChildPtr
CreateMemoryDC PutChildren
DefChildProc PutSiblingPtr
DefCommandProc Register
DefNotificationProc RemoveChild
DefWndProc SetFlags
Destroy SetupWindow
Disable Show
DisableAutoCreate Store
DisableTransfer Transfer
DispatchScroll TransferData
Enable WMActivate
EnableAutoCreate WMClose
EnableKBHandler WMCommand
EnableTransfer WMDestroy
FirstThat WMNScroll
Focus WMNCDestroy
ForEach WMNQueryEndSession
GetChildPtr WMVScroll
TDialog
Attr
IsModal
Init
Load
Done
Create
DefWndProc
EndDlg
Execute
GetItemHandle
Ok
SendDlgItemMsg
Store
WMClose
WMInitDialog
WMPostInvalid
WMQueryEndSession
TFileDialog
Caption
Extension
FilePath
FileSpec
PathName
Init
CanClose
HandleDList
HandleFList
HandleFName
SetupWindow

    Файловые диалоговые блоки позволяют пользователю выбрать файл для открытия или указать имя файла для сохранения.

Поля


Caption

     Caption: PChar;

    Указывает на строку, которая выводится в заголовке диалогового блока. Если Caption имеет значение nil, то используется текст из диалогового ресурса. Присвоив Caption другую строку, вы можете изменить заголовок.

Extension

     Extension: array[0..fsExtension] of Char;

    Содержит расширение для файлов. Если пользователь набирает имя файла без расширения, то файловый диалоговый блок добавляет к имени Extension.

FilePath

     FilePath: PChar;

    Будучи установленным в значение, переданное в конструкторе, FilePath указывает на буфер, который будет содержать выбранное пользователем имя маршрута. Файловый диалоговый блок помещает в буфер итоговое имя файла.

FileSpec

     FileSpec: array[0..fsFileSpec] of Char;

    Содержит спецификацию файла (обычно имя с трафаретными символами), которое файловый диалоговый блок присоединяет к текущему выбранному маршруту.

PathName

     PathName: array[0..fsPathName] of Char;

    Содержит текущий выбранный маршрут каталога.

Методы


    Ниже описываются методы, определенные в данном объекте.

Init


     constructor Init(AParant: PWindowsObject; AName,
                      AFilePath: PChar);

    Строит файловый диалоговый блок с порождающим окном AParent из диалогового ресурса. Ресурс определяется значением, переданным в AName. Параметр AName должен содержать одну из констант sd_XXXX, sd_FileOpen или sd_FileSave и для определения характера создаваемого файлового блока (диалоговый блок открытия файла или диалоговый блок сохранения файла) с помощью MakeIntResource нужно привести его тип к PChar. На основе AName и значения в BWCCClassName Init определяет, какой ресурс нужно задать для конструктора Init, наследуемого из TDialog. Устанавливает Caption в nil, а FilePath - в AFilePath. AFilePath должно указывать на буфер размера, достаточного для размещения полного имени файла, обычно array[0..fsPathName] of Char.

CanClose


     function CanClose: Boolean; virtual;

    Возвращает True, если пользователь выбрал файл, что позволяет закрыть диалоговый блок. Если текущий выделенный маршрут является каталогом или содержит трафаретные символы, CanClose обновляет блоки списка файла и каталога и возвращает False, указывая, что диалоговый блок закрывать не следует.

SetupWindow


     procedure SetupWindow; virtual;

    Ограничивает число символов в имени файла значением fsPathName. Если Caption не равно 0, устанавливает заголовок диалогового блока в Caption. копирует FilePath в PathName, а расширение PathName - в Extension. Обновляет блоки списка для соответствия текущему имени файла.

HandleFName


     procedure HandleFName(var Msg: TMessage); virtual
                           id_First + id_FName;

    Реагирует на изменения в управляющем элементе редактирования FileName, разрешая или запрещая командную кнопку Ok. В противном случае разрешает Ok.

HandleFList


     procedure HandleFList(var Msg: TMessage); virtual;
                           id_First + id_FList;

    Отвечает на уведомляющее сообщение от блока списка файлов обновлением текущего имени файла и реагирует на двойной щелчок "мышью" на имени файла. Если пользователь дважды щелкнул кнопкой "мыши", вызывает для завершения диалогового блока Ok. Если блок списка потерял фокус ввода, HandleFList отменяет выбор выделенных элементов.

HandleDList


     procedure HandleDList(var Msg: TMessage); virtual
                           id_First + id_DList;

    Реагирует на уведомляющие сообщения блока списка каталогов, обновляя текущее имя файла, и на двойной щелчок на каталоге кнопкой "мыши". Если блок списка потерял фокус ввода, HandleFList отменяет выбор выделенных элементов.