FileDialog Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Абстрактный базовый класс, который инкапсулирует функциональные возможности, общие для диалоговых окон файлов, включая OpenFileDialog и SaveFileDialog.
public ref class FileDialog abstract : Microsoft::Win32::CommonDialog
public ref class FileDialog abstract : Microsoft::Win32::CommonItemDialog
public abstract class FileDialog : Microsoft.Win32.CommonDialog
public abstract class FileDialog : Microsoft.Win32.CommonItemDialog
type FileDialog = class
inherit CommonDialog
type FileDialog = class
inherit CommonItemDialog
Public MustInherit Class FileDialog
Inherits CommonDialog
Public MustInherit Class FileDialog
Inherits CommonItemDialog
- Наследование
- Наследование
- Производный
Конструкторы
| Имя | Описание |
|---|---|
| FileDialog() |
Инициализирует новый экземпляр класса FileDialog. |
Свойства
| Имя | Описание |
|---|---|
| AddExtension |
Возвращает или задает значение, указывающее, добавляет ли диалоговое окно диалоговое окно файла расширение в имя файла, если пользователь пропускает расширение. |
| AddToRecent |
Возвращает или задает значение, указывающее, будет ли диалоговое окно добавлять элемент, открытый или сохраненный в списке последних документов. (Унаследовано от CommonItemDialog) |
| CheckFileExists |
Возвращает или задает значение, указывающее, отображается ли диалоговое окно с предупреждением, если пользователь указывает имя файла, которое не существует. |
| CheckPathExists |
Возвращает или задает значение, указывающее, отображаются ли предупреждения, если пользовательские типы недопустимых путей и имен файлов. |
| ClientGuid |
Возвращает или задает GUID для связывания с сохраненным состоянием диалогового окна. (Унаследовано от CommonItemDialog) |
| CustomPlaces |
Возвращает или задает список настраиваемых мест для диалоговых окон файлов. |
| CustomPlaces |
Абстрактный базовый класс, который инкапсулирует функциональные возможности, общие для диалоговых окон файлов, включая OpenFileDialog и SaveFileDialog. (Унаследовано от CommonItemDialog) |
| DefaultDirectory |
Возвращает или задает каталог, отображаемый диалоговым окном файла, если не доступно значение каталога, которое недавно использовалось. (Унаследовано от CommonItemDialog) |
| DefaultExt |
Возвращает или задает значение, указывающее строку расширения по умолчанию для фильтрации списка отображаемых файлов. |
| DereferenceLinks |
Возвращает или задает значение, указывающее, возвращает ли диалоговое окно расположение файла, на который ссылается ярлык или расположение ярлыка (.lnk). |
| DereferenceLinks |
Возвращает или задает значение, указывающее, возвращает ли диалоговое окно расположение файла, на который ссылается ярлык или возвращает расположение ярлыка (.lnk). (Унаследовано от CommonItemDialog) |
| FileName |
Возвращает или задает строку, содержащую полный путь к файлу, выбранному в диалоговом окне файла. |
| FileNames |
Получает массив, содержащий одно имя файла для каждого выбранного файла. |
| Filter |
Возвращает или задает строку фильтра, которая определяет, какие типы файлов отображаются из либо OpenFileDialogSaveFileDialog. |
| FilterIndex |
Возвращает или задает индекс фильтра, выбранного в диалоговом окне файла. |
| InitialDirectory |
Возвращает или задает начальный каталог, отображаемый диалоговым окном файла. |
| InitialDirectory |
Возвращает или задает исходный каталог, отображаемый диалоговым окном файла. (Унаследовано от CommonItemDialog) |
| Options |
Возвращает общие флаги диалоговых окон Win32, которые используются диалогами файлов для инициализации. |
| RestoreDirectory |
Это свойство не реализовано. |
| RootDirectory |
Возвращает или задает каталог, отображаемый в качестве корневого каталога навигации для диалогового окна. (Унаследовано от CommonItemDialog) |
| SafeFileName |
Возвращает строку, содержащую только имя файла для выбранного файла. |
| SafeFileNames |
Получает массив, содержащий одно безопасное имя файла для каждого выбранного файла. |
| ShowHiddenItems |
Возвращает или задает значение, указывающее, будет ли диалоговое окно отображать скрытые и системные элементы независимо от настроек пользователя. (Унаследовано от CommonItemDialog) |
| Tag |
Возвращает или задает объект, связанный с диалогом. Это обеспечивает возможность подключения произвольного объекта к диалогу. (Унаследовано от CommonDialog) |
| Title |
Возвращает или задает текст, отображаемый в заголовке диалогового окна файла. |
| Title |
Возвращает или задает текст, отображаемый в заголовке диалогового окна файла. (Унаследовано от CommonItemDialog) |
| ValidateNames |
Возвращает или задает значение, указывающее, принимает ли диалоговое окно только допустимые имена файлов Win32. |
| ValidateNames |
Возвращает или задает значение, указывающее, следует ли проверять наличие ситуаций, которые не позволят приложению открывать выбранный файл, например нарушения общего доступа или ошибки отказа в доступе. (Унаследовано от CommonItemDialog) |
Методы
| Имя | Описание |
|---|---|
| CheckPermissionsToShowDialog() |
Определяет, существуют ли достаточные разрешения для отображения диалогового окна. (Унаследовано от CommonDialog) |
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Определяет общую процедуру перехватчика диалогового окна файла, переопределенную для добавления общих функций в диалоговое окно файла. |
| HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Определяет общую процедуру перехватчика диалогового окна, переопределенную для добавления определенных функций в общее диалоговое окно. (Унаследовано от CommonDialog) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| OnFileOk(CancelEventArgs) |
Вызывает событие FileOk. |
| OnItemOk(CancelEventArgs) |
Вызывает событие FileOk. |
| Reset() |
Задает все свойства диалогового окна файла обратно в исходные значения. |
| RunDialog(IntPtr) |
RunDialog(IntPtr) вызывается для отображения диалогового окна файла в производном классе, например OpenFileDialog и SaveFileDialog. |
| RunDialog(IntPtr) |
Выполняет инициализацию при подготовке, чтобы отобразить диалоговое окно открытия файла, сохранения файла или папки. (Унаследовано от CommonItemDialog) |
| ShowDialog() |
Отображает общее диалоговое окно. (Унаследовано от CommonDialog) |
| ShowDialog(Window) |
Отображает общее диалоговое окно. (Унаследовано от CommonDialog) |
| ToString() |
Возвращает строку, представляющую диалоговое окно файла. |
События
| Имя | Описание |
|---|---|
| FileOk |
Происходит, когда пользователь выбирает имя файла, нажав кнопку OpenFileDialog" или кнопку SaveFileDialog". |