Freigeben über


Öffnen eines allgemeinen Dialogfelds

In diesem Artikel wird veranschaulicht, wie Sie ein allgemeines Systemdialogfeld in Windows Presentation Foundation (WPF) anzeigen können. Windows implementiert verschiedene Arten von wiederverwendbaren Dialogfeldern, die allen Anwendungen gemeinsam sind, einschließlich Dialogfeldern zum Auswählen von Dateien und Drucken.

Da diese Dialogfelder vom Betriebssystem bereitgestellt werden, werden sie für alle Anwendungen freigegeben, die auf dem Betriebssystem ausgeführt werden. Diese Dialogfelder bieten eine konsistente Benutzererfahrung und werden als gängige Dialogfelder bezeichnet. Wenn ein Benutzer ein gemeinsames Dialogfeld in einer Anwendung verwendet, muss er nicht erfahren, wie dieses Dialogfeld in anderen Anwendungen verwendet wird.

Ein Meldungsfeld ist ein weiteres gängiges Dialogfeld. Weitere Informationen finden Sie unter Öffnen eines Meldungsfelds.

Dialogfeld 'Datei öffnen'

Das Dialogfeld "Datei öffnen" wird von Dateiöffnungsfunktionen verwendet, um den Namen einer zu öffnenden Datei abzurufen.

Ein Dialogfeld 'Öffnen', das den Speicherort der Datei anzeigt, die aus einer WPF-Anwendung abgerufen werden soll.

Das allgemeine Dialogfeld für geöffnete Dateien wird als OpenFileDialog Klasse implementiert und befindet sich im Microsoft.Win32 Namespace. Der folgende Code zeigt, wie Sie das Dialogfeld erstellen, konfigurieren und anzeigen.

// Configure open file dialog box
var dialog = new Microsoft.Win32.OpenFileDialog();
dialog.FileName = "Document"; // Default file name
dialog.DefaultExt = ".txt"; // Default file extension
dialog.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show open file dialog box
bool? result = dialog.ShowDialog();

// Process open file dialog box results
if (result == true)
{
    // Open document
    string filename = dialog.FileName;
}
' Configure open file dialog box
Dim dialog As New Microsoft.Win32.OpenFileDialog()
dialog.FileName = "Document" ' Default file name
dialog.DefaultExt = ".txt" ' Default file extension
dialog.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show open file dialog box
Dim result As Boolean? = dialog.ShowDialog()

' Process open file dialog box results
If result = True Then
    ' Open document
    Dim filename As String = dialog.FileName
End If

Weitere Informationen zum Dialogfeld "Datei öffnen" finden Sie unter Microsoft.Win32.OpenFileDialog.

Dialogfeld 'Datei speichern'

Das Dialogfeld "Datei speichern" wird von der Dateispeicherfunktion genutzt, um den Namen einer zu speichernden Datei abzurufen.

Ein Dialogfeld

Das allgemeine Dialogfeld "Datei speichern" wird als SaveFileDialog Klasse implementiert und befindet sich im Microsoft.Win32 Namespace. Der folgende Code zeigt, wie Sie das Dialogfeld erstellen, konfigurieren und anzeigen.

// Configure save file dialog box
var dialog = new Microsoft.Win32.SaveFileDialog();
dialog.FileName = "Document"; // Default file name
dialog.DefaultExt = ".txt"; // Default file extension
dialog.Filter = "Text documents (.txt)|*.txt"; // Filter files by extension

// Show save file dialog box
bool? result = dialog.ShowDialog();

// Process save file dialog box results
if (result == true)
{
    // Save document
    string filename = dialog.FileName;
}
' Configure save file dialog box
Dim dialog As New Microsoft.Win32.SaveFileDialog()
dialog.FileName = "Document" ' Default file name
dialog.DefaultExt = ".txt" ' Default file extension
dialog.Filter = "Text documents (.txt)|*.txt" ' Filter files by extension

' Show save file dialog box
Dim result As Boolean? = dialog.ShowDialog()

' Process save file dialog box results
If result = True Then
    ' Save document
    Dim filename As String = dialog.FileName
End If

Weitere Informationen zum Dialogfeld "Datei speichern" finden Sie unter Microsoft.Win32.SaveFileDialog.

Dialogfeld 'Ordner öffnen'

Von Bedeutung

Das Dialogfeld "Ordner öffnen" ist in .NET 8.0 und höher verfügbar.

Das Dialogfeld "Ordner öffnen" wird vom Benutzer verwendet, um einen oder mehrere Ordner auszuwählen und an das Programm zurückzugeben. Wenn ihr Programm beispielsweise Informationen zu einem Ordner anzeigt, z. B. die Menge der Dateien und die Dateinamen im Ordner, können Sie das Dialogfeld "Ordner öffnen" verwenden, damit der Benutzer den Ordner auswählen kann.

Ein

Das allgemeine Dialogfeld "Geöffneter Ordner" wird als OpenFolderDialog Klasse implementiert und befindet sich im Microsoft.Win32 Namespace. Der folgende Code zeigt, wie Sie das Dialogfeld erstellen, konfigurieren und anzeigen.

// Configure open folder dialog box
Microsoft.Win32.OpenFolderDialog dialog = new();

dialog.Multiselect = false;
dialog.Title = "Select a folder";

// Show open folder dialog box
bool? result = dialog.ShowDialog();

// Process open folder dialog box results
if (result == true)
{
    // Get the selected folder
    string fullPathToFolder = dialog.FolderName;
    string folderNameOnly = dialog.SafeFolderName;
}
' Configure open folder dialog box
Dim dialog As New Microsoft.Win32.OpenFolderDialog()

dialog.Multiselect = True
dialog.Title = "Select a folder"

' Show open folder dialog box
Dim result As Boolean? = dialog.ShowDialog()

' Process open folder dialog box results
If result = True Then

    ' Get multiple folder names
    For index = 0 To dialog.FolderNames.Length
        ' Get the selected folder
        Dim fullPathToFolder As String = dialog.FolderNames(index)
        Dim folderNameOnly As String = dialog.SafeFolderNames(index)
    Next

End If

Weitere Informationen zum Dialogfeld "Ordner öffnen" finden Sie unter Microsoft.Win32.OpenFolderDialog.

Das Dialogfeld "Drucken" wird von Druckfunktionen verwendet, um den Drucker auszuwählen und zu konfigurieren, auf den ein Benutzer Daten drucken möchte.

Ein Druckdialogfeld, das aus einer WPF-Anwendung angezeigt wird.

Das allgemeine Druckdialogfeld wird als PrintDialog-Klasse implementiert und befindet sich im System.Windows.Controls-Namespace. Der folgende Code zeigt, wie Sie eins erstellen, konfigurieren und anzeigen.

// Configure printer dialog box
var dialog = new System.Windows.Controls.PrintDialog();
dialog.PageRangeSelection = System.Windows.Controls.PageRangeSelection.AllPages;
dialog.UserPageRangeEnabled = true;

// Show save file dialog box
bool? result = dialog.ShowDialog();

// Process save file dialog box results
if (result == true)
{
    // Document was printed
}
' Configure printer dialog box
Dim dialog As New System.Windows.Controls.PrintDialog()
dialog.PageRangeSelection = System.Windows.Controls.PageRangeSelection.AllPages
dialog.UserPageRangeEnabled = True

' Show save file dialog box
Dim result As Boolean? = dialog.ShowDialog()

' Process save file dialog box results
If result = True Then
    ' Document was printed
End If

Weitere Informationen zum Dialogfeld "Drucken" finden Sie unter System.Windows.Controls.PrintDialog. Ausführliche Erläuterungen zum Drucken in WPF finden Sie unter "Druckübersicht".

Siehe auch