OpenFileDialog Třída
Definice
Důležité
Některé informace platí pro předběžně vydaný produkt, který se může zásadně změnit, než ho výrobce nebo autor vydá. Microsoft neposkytuje žádné záruky, výslovné ani předpokládané, týkající se zde uváděných informací.
Představuje společné dialogové okno, které umožňuje uživateli zadat název souboru pro jeden nebo více souborů k otevření.
public ref class OpenFileDialog sealed : Microsoft::Win32::FileDialog
public sealed class OpenFileDialog : Microsoft.Win32.FileDialog
type OpenFileDialog = class
inherit FileDialog
Public NotInheritable Class OpenFileDialog
Inherits FileDialog
- Dědičnost
- Dědičnost
Příklady
Následující příklad ukazuje, jak vytvořit soubor OpenFileDialog , který obsahuje výchozí název souboru a typ přípony.
// Configure open file dialog box
Microsoft.Win32.OpenFileDialog dlg = new Microsoft.Win32.OpenFileDialog();
dlg.FileName = "Document"; // Default file name
dlg.DefaultExt = ".txt"; // Default file extension
dlg.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension
// Show open file dialog box
Nullable<bool> result = dlg.ShowDialog();
// Process open file dialog box results
if (result == true)
{
// Open document
string filename = dlg.FileName;
}
' Configure open file dialog box
Dim dlg As New Microsoft.Win32.OpenFileDialog()
dlg.FileName = "Document" ' Default file name
dlg.DefaultExt = ".txt" ' Default file extension
dlg.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension
' Show open file dialog box
Dim result? As Boolean = dlg.ShowDialog()
' Process open file dialog box results
If result = True Then
' Open document
Dim filename As String = dlg.FileName
End If
Poznámky
Tuto spravovanou třídu nelze deklarovat v jazyce XAML.
Konstruktory
OpenFileDialog() |
Inicializuje novou instanci OpenFileDialog třídy . |
Vlastnosti
AddExtension |
Získá nebo nastaví hodnotu označující, zda dialogové okno souboru automaticky přidá příponu názvu souboru, pokud uživatel vynechá příponu. (Zděděno od FileDialog) |
AddToRecent |
Získá nebo nastaví hodnotu označující, zda dialogové okno přidá položku, která je otevřena nebo uložena do seznamu posledních dokumentů. (Zděděno od CommonItemDialog) |
CheckFileExists |
Získá nebo nastaví hodnotu označující, zda dialogové okno souboru zobrazí upozornění, pokud uživatel zadá název souboru, který neexistuje. (Zděděno od FileDialog) |
CheckPathExists |
Získá nebo nastaví hodnotu, která určuje, zda jsou zobrazeny upozornění, pokud uživatel zadá neplatné cesty a názvy souborů. (Zděděno od FileDialog) |
ClientGuid |
Získá nebo nastaví identifikátor GUID pro přidružení k trvalému stavu dialogového okna. (Zděděno od CommonItemDialog) |
CustomPlaces |
Získá nebo nastaví seznam vlastních míst pro dialogová okna souboru. (Zděděno od FileDialog) |
DefaultDirectory |
Získá nebo nastaví adresář zobrazený v dialogovém okně soubor, pokud není k dispozici hodnota naposledy použitého adresáře. (Zděděno od CommonItemDialog) |
DefaultExt |
Získá nebo nastaví hodnotu, která určuje výchozí řetězec rozšíření k filtrování seznamu souborů, které jsou zobrazeny. (Zděděno od FileDialog) |
DereferenceLinks |
Získá nebo nastaví hodnotu označující, zda dialogové okno souboru vrátí umístění souboru odkazovaného zástupcem nebo umístění souboru zástupce (.lnk). (Zděděno od FileDialog) |
FileName |
Získá nebo nastaví řetězec obsahující úplnou cestu souboru vybraného v dialogovém okně souboru. (Zděděno od FileDialog) |
FileNames |
Získá pole, které obsahuje jeden název souboru pro každý vybraný soubor. (Zděděno od FileDialog) |
Filter |
Získá nebo nastaví řetězec filtru, který určuje, jaké typy souborů jsou zobrazeny z nebo OpenFileDialogSaveFileDialog. (Zděděno od FileDialog) |
FilterIndex |
Získá nebo nastaví index filtru aktuálně vybraného v dialogovém okně souboru. (Zděděno od FileDialog) |
ForcePreviewPane |
Získá nebo nastaví příznak možnosti označující, zda dialogové okno vynutí podokno náhledu. |
InitialDirectory |
Získá nebo nastaví počáteční adresář, který je zobrazen v dialogovém okně souboru. (Zděděno od FileDialog) |
Multiselect |
Získá nebo nastaví možnost označující, zda OpenFileDialog umožňuje uživatelům vybrat více souborů. |
Options |
Získá Win32 společné soubory dialog příznaky, které jsou používány soubor dialogy pro inicializaci. (Zděděno od FileDialog) |
ReadOnlyChecked |
Získá nebo nastaví hodnotu označující, zda je zaškrtnuto políčko jen pro čtení zobrazené.OpenFileDialog |
RestoreDirectory |
Tato vlastnost není implementována. (Zděděno od FileDialog) |
RootDirectory |
Získá nebo nastaví adresář zobrazený jako kořen navigace pro dialogové okno. (Zděděno od CommonItemDialog) |
SafeFileName |
Získá řetězec, který obsahuje pouze název souboru vybraného souboru. (Zděděno od FileDialog) |
SafeFileNames |
Získá pole, které obsahuje jeden bezpečný název souboru pro každý vybraný soubor. (Zděděno od FileDialog) |
ShowHiddenItems |
Získá nebo nastaví hodnotu označující, zda dialogové okno zobrazí skryté a systémové položky bez ohledu na předvolby uživatele. (Zděděno od CommonItemDialog) |
ShowReadOnly |
Získá nebo nastaví hodnotu označující, zda OpenFileDialog obsahuje zaškrtávací políčko jen pro čtení. |
Tag |
Získá nebo nastaví objekt přidružený k dialogovému oknem. To poskytuje možnost připojit k dialogovému oknem libovolný objekt. (Zděděno od CommonDialog) |
Title |
Získá nebo nastaví text, který se zobrazí v záhlaví dialogového okna souboru. (Zděděno od FileDialog) |
ValidateNames |
Získá nebo nastaví hodnotu označující, zda dialogové okno přijímá pouze platné názvy souborů Win32. (Zděděno od FileDialog) |
Metody
CheckPermissionsToShowDialog() |
Určuje, zda existují dostatečná oprávnění pro zobrazení dialogového okna. (Zděděno od CommonDialog) |
Equals(Object) |
Určí, zda se zadaný objekt rovná aktuálnímu objektu. (Zděděno od Object) |
GetHashCode() |
Slouží jako výchozí hashovací funkce. (Zděděno od Object) |
GetType() |
Type Získá z aktuální instance. (Zděděno od Object) |
HookProc(IntPtr, Int32, IntPtr, IntPtr) |
Definuje společnou proceduru hooku dialogového okna souborů, která je přepsána, aby se přidaly běžné funkce do dialogového okna souboru. (Zděděno od FileDialog) |
MemberwiseClone() |
Vytvoří mělkou kopii aktuálního Objectsouboru . (Zděděno od Object) |
OnFileOk(CancelEventArgs) |
FileOk Vyvolá událost. (Zděděno od FileDialog) |
OnItemOk(CancelEventArgs) |
FileOk Vyvolá událost. (Zděděno od FileDialog) |
OpenFile() |
Otevře datový proud jen pro čtení souboru vybraného uživatelem pomocí OpenFileDialog. |
OpenFiles() |
Vytvoří pole, které obsahuje jeden datový proud jen pro čtení pro každý soubor vybraný uživatelem pomocí OpenFileDialog. |
Reset() |
Obnoví výchozí hodnoty všech OpenFileDialog vlastností. |
RunDialog(IntPtr) |
RunDialog(IntPtr) Je volána k zobrazení dialogového okna souboru v odvozené třídě, například OpenFileDialog a SaveFileDialog. (Zděděno od FileDialog) |
ShowDialog() |
Zobrazí společné dialogové okno. (Zděděno od CommonDialog) |
ShowDialog(Window) |
Zobrazí společné dialogové okno. (Zděděno od CommonDialog) |
ToString() |
Vrátí řetězec, který představuje dialogové okno souboru. (Zděděno od FileDialog) |
Událost
FileOk |
Vyvolá se, když uživatel vybere název souboru kliknutím na tlačítko OpenFileDialogOtevřít nebo na tlačítko Uložit v SaveFileDialog. (Zděděno od FileDialog) |