https://github.com/folkerkinzel/recentfiles.wpf
Recent files menu for WPF applications.
https://github.com/folkerkinzel/recentfiles.wpf
recent-files wpf
Last synced: 3 months ago
JSON representation
Recent files menu for WPF applications.
- Host: GitHub
- URL: https://github.com/folkerkinzel/recentfiles.wpf
- Owner: FolkerKinzel
- License: mit
- Created: 2020-05-26T10:26:48.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2023-11-26T17:56:25.000Z (over 1 year ago)
- Last Synced: 2024-03-26T20:49:15.139Z (about 1 year ago)
- Topics: recent-files, wpf
- Language: C#
- Homepage:
- Size: 2.85 MB
- Stars: 3
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# FolkerKinzel.RecentFiles.WPF
[](https://www.nuget.org/packages/FolkerKinzel.RecentFiles.WPF/)
[](https://github.com/FolkerKinzel/RecentFiles.WPF/blob/master/LICENSE)
[](https://stand-with-ukraine.pp.ua)
## Recent files menu for WPF applications.
* Displays the file icons automatically.
* Customizable for every language.
* Has its own (asynchronous) persistence mechanism.
* Synchronizes access between multiple threads and multiple instances of the same program.
* Implements an interface to support Dependency Inversion and unit tests (mockable).
[Project Reference and Release Notes](https://github.com/FolkerKinzel/RecentFiles.WPF/releases/tag/v1.6.2)
[See code examples on GitHub](https://github.com/FolkerKinzel/RecentFiles.WPF)
## Example Code
### Initializing a RecentFilesMenu object:
```c#
using System.IO;
using System.Windows;
using FolkerKinzel.RecentFiles.WPF;
namespace WpfExample;
public partial class App : Application
{
private void Application_Startup(object? sender, StartupEventArgs e)
{
// The example initializes a new RecentFilesMenu which persists its data in
// the same directory, where the program exe-file is. The constructor has
// optional parameters to substitute the text "Clear list" to something in
// another language and to control the maximum number of files to be displayed.
string persistenceDirectoryPath = Path.GetDirectoryName(Environment.ProcessPath)!;
var rfm = new RecentFilesMenu(persistenceDirectoryPath);
new MainWindow(rfm).Show();
}
}
```
#### Including RecentFilesMenu into a WPF-Window:
```c#
using System.Collections.Concurrent;
using System.ComponentModel;
using System.IO;
using System.Runtime.CompilerServices;
using System.Windows;
using System.Windows.Input;
using FolkerKinzel.RecentFiles.WPF;
namespace WpfExample;
public sealed partial class MainWindow : Window, INotifyPropertyChanged
{
public event PropertyChangedEventHandler? PropertyChanged;
private readonly ConcurrentBag _tasks = new();
private readonly IRecentFilesMenu _recentFilesMenu;
private string? _currentFile;
public MainWindow(IRecentFilesMenu recentFilesMenu)
{
this._recentFilesMenu = recentFilesMenu;
InitializeComponent();
}
public string? CurrentFile
{
get => _currentFile;
private set
{
_currentFile = value;
OnPropertyChanged();
if (value != null)
{
// Adds the current file to the RecentFilesMenu.
// If the RecentFilesMenu already contains the file,
// it's moved now to the first position.
_tasks.Add(_recentFilesMenu.AddRecentFileAsync(value));
}
}
}
private void Window_Loaded(object? sender, RoutedEventArgs e)
{
// Assign the RecentFilesMenu the MenuItem next to which the
// RecentFilesMenu is to be displayed:
_recentFilesMenu.Initialize(_miRecentFiles);
// Register at the RecentFilesMenu.RecentFileSelected event, to open
// the file, that the user has selected in the RecentFilesMenu:
_recentFilesMenu.RecentFileSelected += RecentFilesMenu_RecentFileSelected;
}
private async void Window_Closed(object? sender, EventArgs e)
{
// Wait all tasks to be finished before disposing the
// recent files menu:
await Task.WhenAll(_tasks.ToArray()).ConfigureAwait(false);
_recentFilesMenu.Dispose();
}
private void Quit_Click(object? sender, RoutedEventArgs e) => Close();
private void RecentFilesMenu_RecentFileSelected(
object? sender,
RecentFileSelectedEventArgs e) => OpenFile(e.FileName);
private void OpenDirectory_Executed(object? sender, ExecutedRoutedEventArgs e)
{
using var dialog = new System.Windows.Forms.FolderBrowserDialog();
if (dialog.ShowDialog() == System.Windows.Forms.DialogResult.OK)
{
OpenFile(dialog.SelectedPath);
}
}
private void OpenFile_Executed(object? sender, ExecutedRoutedEventArgs e)
{
var dialog = new Microsoft.Win32.OpenFileDialog();
if (dialog.ShowDialog(this) == true)
{
OpenFile(dialog.FileName);
}
}
private void OpenFile(string fileName)
{
try
{
// Open the file here!
}
catch (IOException)
{
_tasks.Add(_recentFilesMenu.RemoveRecentFileAsync(fileName));
CurrentFile = null;
return;
}
CurrentFile = fileName;
}
private void OnPropertyChanged([CallerMemberName] string propName = "")
=> PropertyChanged?.Invoke(this, new PropertyChangedEventArgs(propName));
}
```