На этом шаге мы перечислим основные свойства этого компонента.

Компонент SaveFileDialog представляет собой стандартное диалоговое окно Сохранить.

Рис.1. Компонент SaveFileDialog

Свойства компонента приведены в таблице 1.

Таблица 1. Свойства компонента SaveFileDialog
Свойство Описание

Title Текст в заголовке окна. Если значение свойства не указано, то в заголовке отображается текст Сохранить как

FileName Полное имя файла, которое задал пользователь. В общем случае оно образуется из имени каталога, содержимое которого отображается в диалоговом окне, имени файла, которое пользователь ввел в поле Имя файла, и расширения, заданного значением свойства DefaultExt

DefaultExt Расширение файла по умолчанию. Если пользователь в поле Имя файла не укажет расширение, то к имени файла будет добавлено расширение (при условии, что значение свойства AddExtension равно True), заданное значением этого свойства

InitialDirectory Каталог, содержимое которого отображается при появлении диалога на экране

RestoreDirectory Признак необходимости отображать содержимое каталога, указанного в свойстве InitialDirectory, при каждом появлении окна. Если значение свойства равно False, то при следующем появлении окна отображается содержимое каталога, выбранного пользователем в предыдущий раз

CheckPathExists Признак необходимости проверки существования каталога, в котором следует сохранить файл. Если указанного каталога нет, то выводится информационное сообщение

CheckFileExists Признак необходимости проверки существования файла с заданным именем. Если значение свойства равно True и файл с указанным именем уже существует, то появляется окно запроса, в котором пользователь может подтвердить необходимость замены (перезаписи) существующего файла

Filter Свойство задает описание и фильтр (маску) имени файла. В списке файлов отображаются только те файлы, имена которых соответствуют указанной маске. Описание отображается в поле Тип файла. Например, значение Текст|*.txt указывает, что в списке файлов нужно отобразить только файлы с расширением txt

FilterIndex Если фильтр состоит из нескольких элементов (например, Текст|*.txt|Все файлы|*.*), то значение свойства задает фильтр, который используется в момент появления диалога на экране

Таблица 1. **Свойства компонента SaveFileDialog**
Свойство	Описание
Title	Текст в заголовке окна. Если значение свойства не указано, то в заголовке отображается текст *Сохранить как*
FileName	Полное имя файла, которое задал пользователь. В общем случае оно образуется из имени каталога, содержимое которого отображается в диалоговом окне, имени файла, которое пользователь ввел в поле *Имя файла, и расширения, заданного значением свойства DefaultExt*
DefaultExt	Расширение файла по умолчанию. Если пользователь в поле *Имя файла* не укажет расширение, то к имени файла будет добавлено расширение (при условии, что значение свойства AddExtension равно True), заданное значением этого свойства
InitialDirectory	Каталог, содержимое которого отображается при появлении диалога на экране
RestoreDirectory	Признак необходимости отображать содержимое каталога, указанного в свойстве InitialDirectory, при каждом появлении окна. Если значение свойства равно False, то при следующем появлении окна отображается содержимое каталога, выбранного пользователем в предыдущий раз
CheckPathExists	Признак необходимости проверки существования каталога, в котором следует сохранить файл. Если указанного каталога нет, то выводится информационное сообщение
CheckFileExists	Признак необходимости проверки существования файла с заданным именем. Если значение свойства равно True и файл с указанным именем уже существует, то появляется окно запроса, в котором пользователь может подтвердить необходимость замены (перезаписи) существующего файла
Filter	Свойство задает описание и фильтр (маску) имени файла. В списке файлов отображаются только те файлы, имена которых соответствуют указанной маске. Описание отображается в поле *Тип файла. Например, значение Текст\|.txt указывает, что в списке файлов нужно отобразить только файлы с расширением txt
FilterIndex	Если фильтр состоит из нескольких элементов (например, **Текст\|.txt\|Все файлы\|.***), то значение свойства задает фильтр, который используется в момент появления диалога на экране

На следующем шаге мы приведем краткую справку по компоненту TextBox.

Предыдущий шаг Содержание Следующий шаг