VelocityGrid.Native.WinUI 0.1.0-preview.7

VelocityGrid

VelocityGrid is a read-only, high-performance Windows data grid for very large, remote, or rapidly changing datasets. Viewport calculation, caching, scrolling, and Direct2D rendering remain native while C# applications use a thin managed API.

Choose a package

• C# WinUI 3: VelocityGrid.WinUI
• WPF on .NET 8: VelocityGrid.Wpf
• C++/WinRT WinUI 3: VelocityGrid.Native.WinUI

Use a concrete Windows architecture: x64, x86, or ARM64.

C# WinUI 3

<PropertyGroup>
  <UseWinUI>true</UseWinUI>
  <WindowsPackageType>None</WindowsPackageType>
  <ApplicationManifest>app.manifest</ApplicationManifest>
  <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained>
</PropertyGroup>
<ItemGroup>
  <PackageReference Include="VelocityGrid.WinUI" Version="0.1.0-preview.7" />
  <Manifest Include="$(ApplicationManifest)" />
</ItemGroup>

<Window ... xmlns:vg="using:VelocityGrid.Managed">
    <vg:VelocityGridControl x:Name="TradesGrid" />
</Window>

Configure columns and supply pages through IVelocityGridDataProvider. The managed package installs the correct native runtime transitively.

The self-contained setting above is the recommended Microsoft-style deployment for an unpackaged executable: WinUI, composition, and pointer input are deployed as one matching Windows App SDK graph. Packaged applications should retain their package deployment model instead.

Columns can carry stable application keys for column chooser projections. Provider requests receive the exact immutable column snapshot. For changing datasets, use NotifyDataChanged, Refresh, or targeted InvalidateRows; the caller remains responsible for updating its provider snapshot before notifying the grid.

WPF

<PackageReference Include="VelocityGrid.Wpf" Version="0.1.0-preview.7" />

<Window ... xmlns:vg="clr-namespace:VelocityGrid.Wpf;assembly=VelocityGrid.Wpf">
    <vg:VelocityGridHost x:Name="TradesGrid" RowHeight="24" />
</Window>

The host owns the WinUI XAML Island lifecycle and automatically enables Windows App SDK initialization for unpackaged WPF executables.

C++/WinRT

For an unpackaged executable, use Microsoft-style self-contained deployment and install VelocityGrid.Native.WinUI:

<PropertyGroup>
  <UseWinUI>true</UseWinUI>
  <AppContainerApplication>false</AppContainerApplication>
  <AppxPackage>false</AppxPackage>
  <WindowsPackageType>None</WindowsPackageType>
  <WindowsAppSDKSelfContained>true</WindowsAppSDKSelfContained>
</PropertyGroup>
<ItemGroup>
  <Manifest Include="app.manifest" />
  <PackageReference Include="VelocityGrid.Native.WinUI" Version="0.1.0-preview.7" />
</ItemGroup>

Then use the supplied projection headers:

#include <winrt/VelocityGrid_Native.h>

winrt::VelocityGrid_Native::VelocityGrid grid;
grid.RowHeight(24.0);
Content(grid);

The package copies the matching native DLL beside C++ executables and merges registration-free WinRT activation metadata into the application manifest.

Documentation

• Complete setup and usage
• Managed API and configuration
• Provider implementation
• Cell formatting
• NuGet distribution details
• Issues and support

VelocityGrid is an early preview. Please report compatibility and performance findings through GitHub Issues.