readme

Author: DerekGooding

LICENSE

@@ -0,0 +1,22 @@
+
+MIT License
+
+Copyright (c) 2025 Derek Gooding
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,86 @@
+
+# SimpleDataGrid
+
+![Icon](Icon.png)
+
+A simple DataGrid for WPF that supports pagination, filtering, and searching.
+
+## Features
+
+*   **Pagination:** Easily page through large datasets.
+*   **Filtering:** Filter data based on custom criteria.
+*   **Searching:** Search for data using strings or wildcards.
+
+## Usage
+
+1.  Install the `SimpleDataGrid` NuGet package.
+2.  Add the `PagedDataGrid` control to your XAML.
+3.  Create a `PagedCollection` and bind it to the `PagedSource` property of the `PagedDataGrid`.
+
+```xaml
+<Window x:Class="SimpleDataGrid.Example.MainWindow"
+        xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
+        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
+        xmlns:local="clr-namespace:SimpleDataGrid.Example"
+        mc:Ignorable="d"
+        Title="MainWindow" Height="450" Width="800">
+    <Window.DataContext>
+        <local:MainViewModel />
+    </Window.DataContext>
+    <Grid>
+        <Grid.RowDefinitions>
+            <RowDefinition Height="Auto" />
+            <RowDefinition Height="*" />
+            <RowDefinition Height="Auto" />
+        </Grid.RowDefinitions>
+
+        <StackPanel Grid.Row="0" Orientation="Horizontal" Margin="5">
+            <TextBox x:Name="SearchTextBox" Width="200" Margin="5" />
+            <Button Content="Search" Click="SearchButton_Click" Margin="5" />
+            <CheckBox x:Name="WildcardCheckBox" Content="Use Wildcards" VerticalAlignment="Center" Margin="5" />
+        </StackPanel>
+
+        <local:PersonPagedDataGrid x:Name="PagedDataGrid" Grid.Row="1" PagedSource="{Binding People}" AutoGenerateColumns="True" />
+
+        <StackPanel Grid.Row="2" Orientation="Horizontal" HorizontalAlignment="Center">
+            <Button Content="Previous" Click="PreviousButton_Click" Margin="5" />
+            <TextBlock Text="{Binding People.CurrentPage}" VerticalAlignment="Center" Margin="5" />
+            <TextBlock Text="/" VerticalAlignment="Center" />
+            <TextBlock Text="{Binding People.TotalPages}" VerticalAlignment="Center" Margin="5" />
+            <Button Content="Next" Click="NextButton_Click" Margin="5" />
+        </StackPanel>
+    </Grid>
+</Window>
+```
+
+```csharp
+public partial class MainWindow : Window
+{
+    public MainWindow()
+    {
+        InitializeComponent();
+    }
+
+    private void PreviousButton_Click(object sender, RoutedEventArgs e)
+    {
+        var viewModel = (MainViewModel)DataContext;
+        viewModel.People.PreviousPage();
+    }
+
+    private void NextButton_Click(object sender, RoutedEventArgs e)
+    {
+        var viewModel = (MainViewModel)DataContext;
+        viewModel.People.NextPage();
+    }
+
+    private void SearchButton_Click(object sender, RoutedEventArgs e)
+    {
+        var viewModel = (MainViewModel)DataContext;
+        viewModel.People.SetSearch(p => p.Name, SearchTextBox.Text, WildcardCheckBox.IsChecked == true);
+    }
+}
+```
+
+## License
+
+This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.