Merge ReleaseCandidate into main branch

WinUiClassicSamplesBrowser/App.xaml → Vanara-Jnana/App.xaml

@@ -5,7 +5,16 @@
     xmlns:ui="using:Microsoft.UI.Xaml"
     xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml">
     <Application.Resources>
-        <ResourceDictionary>
+        <XamlControlsResources xmlns="using:Microsoft.UI.Xaml.Controls"/>
+    </Application.Resources>
+    <!--<ResourceDictionary>
+            <ResourceDictionary.MergedDictionaries>
+                <XamlControlsResources/>
+                <ResourceDictionary Source="Styles/NavigationView/NavigationView.xaml"/>
+                <ResourceDictionary Source="Styles/NavigationView/NavigationViewItem.xaml"/>
+                <ResourceDictionary Source="Styles/NavigationView/NavigationViewItemPresenter.xaml"/>
+                <ResourceDictionary Source="Styles/NavigationView/NavigationViewItemSeparator.xaml"/>
+            </ResourceDictionary.MergedDictionaries>
             <CornerRadius x:Key="ControlCornerRadius">4</CornerRadius>
             <SolidColorBrush x:Key="MicaBaseAltFillColorDefaultBrush" Color="{ThemeResource SystemBaseLowColor}" />
             <SolidColorBrush x:Key="MicaBaseFillColorDefaultBrush" Color="{ThemeResource SystemBaseMediumColor}" />
@@ -16,31 +25,37 @@
             <SolidColorBrush x:Key="TabViewScrollButtonForeground" Color="{ThemeResource SystemBaseMediumColor}" />
             <system:Double x:Key="TabViewItemAddButtonFontSize">14</system:Double>
             <system:Double x:Key="TabViewItemScrollButtonFontSize">14</system:Double>
-            <!--<Style TargetType="TabViewItem">
-                <Setter Property="Template">
-                    <Setter.Value>
-                        <ControlTemplate TargetType="TabViewItem">
-                            <Grid x:Name="RootGrid" Background="{TemplateBinding Background}">
-                                <Grid.ColumnDefinitions>
-                                    <ColumnDefinition />
-                                    <ColumnDefinition Width="Auto" />
-                                </Grid.ColumnDefinitions>
-                                <ContentPresenter x:Name="HeaderContentPresenter" Grid.Column="0" Content="{TemplateBinding Header}" Margin="12,0,12,0" VerticalAlignment="Center" />
-                                <Button x:Name="CloseButton" Grid.Column="1" Width="28" Height="28" Margin="0,0,4,0" VerticalAlignment="Center">
-                                    <SymbolIcon Symbol="Cancel" />
-                                </Button>
-                            </Grid>
-                            --><!--<ControlTemplate.Triggers>
+        </ResourceDictionary>-->
+
+</Application>
+
+
+
+<!--<Style TargetType="TabViewItem">
+      <Setter Property="Template">
+          <Setter.Value>
+              <ControlTemplate TargetType="TabViewItem">
+                  <Grid x:Name="RootGrid" Background="{TemplateBinding Background}">
+                      <Grid.ColumnDefinitions>
+                          <ColumnDefinition />
+                          <ColumnDefinition Width="Auto" />
+                      </Grid.ColumnDefinitions>
+                      <ContentPresenter x:Name="HeaderContentPresenter" Grid.Column="0" Content="{TemplateBinding Header}" Margin="12,0,12,0" VerticalAlignment="Center" />
+                      <Button x:Name="CloseButton" Grid.Column="1" Width="28" Height="28" Margin="0,0,4,0" VerticalAlignment="Center">
+                          <SymbolIcon Symbol="Cancel" />
+                      </Button>
+                  </Grid>
+                            <ControlTemplate.Triggers>
                                 <Trigger Property="IsSelected" Value="True">
                                     <Setter TargetName="RootGrid" Property="Background" Value="{ThemeResource SystemControlHighlightAccentBrush}" />
                                     <Setter TargetName="HeaderContentPresenter" Property="Foreground" Value="White" />
                                 </Trigger>
-                            </ControlTemplate.Triggers>--><!--
+                            </ControlTemplate.Triggers>
                         </ControlTemplate>
                     </Setter.Value>
                 </Setter>
-            </Style>-->
-            <!--<Style TargetType="TabView">
+            </Style>
+            <Style TargetType="TabView">
                 <Setter Property="Template">
                     <Setter.Value>
                         <ControlTemplate TargetType="TabView">
@@ -61,6 +76,3 @@
                     </Setter.Value>
                 </Setter>
             </Style>-->
-        </ResourceDictionary>
-    </Application.Resources>
-</Application>

Vanara-Jnana/App.xaml.cs

@@ -0,0 +1,42 @@
+using Microsoft.UI.Windowing;
+using Microsoft.UI.Xaml;
+//using LaunchActivatedEventArgs = Windows.ApplicationModel.Activation.LaunchActivatedEventArgs;
+
+namespace ClassicSamplesBrowser;
+
+public partial class App : Application
+{
+    private MainWindow? _mainWindow;
+
+    public App()
+    {
+        InitializeComponent();
+        // TODO: AppWindowTitleBar.SetIcon("Assets/VanaraMonkey.png");
+        // TODO: AppWindowTitleBar.SetDragRegion(new Rect(0, 0, 100, 32));
+    }
+    private MainWindow? GetOrCreateMainWindow(bool allowInitialCreation = false)
+    {
+        if (_mainWindow == null && allowInitialCreation)
+        {
+            _mainWindow = new MainWindow
+            {
+//  ExtendsContentIntoTitleBar = true
+            };
+
+//  var titleBar = _mainWindow.AppWindow.TitleBar;
+//  _mainWindow.SetTitleBar(MyDragRegion);
+//  TODO: titleBar.SetIcon("Assets/VanaraMonkey.png");
+        }
+        // = //new Windows.Graphics.SizeInt32(1200, 800);
+        //_Window.AppWindow.Size...
+
+
+
+        return _mainWindow;
+    }
+
+    protected override void OnLaunched(LaunchActivatedEventArgs args)
+    {
+        GetOrCreateMainWindow(true)?.Activate();
+    }
+}

Vanara-Jnana/DOCS/ReadMe.de.md

@@ -0,0 +1,10 @@
+# WinUI Classic Samples Browser \ Docs
+
+## Content of this folder
+
+### WinForms Sampler
+[Download Sampler.zip](./Sampler.zip)
+
+See [Impact of .net runtime when dealing with low-level Windows-Messages, follow-up: Classic Samples Browser #606](https://github.com/dahall/Vanara/discussions/606#discussioncomment-16492844) discussion.
+
+### docs.assets folder - various assets used for documentation files

Vanara-Jnana/DOCS/ReadMe.md

@@ -0,0 +1,143 @@
+# Vanara Jñāna  
+
+*A Knowledge Explorer for the Vanara Windows API Library*
+
+Vanara Jñāna is an interactive, WinUI 3–based explorer for the **Vanara** library.  
+It provides a unified interface to browse APIs, inspect Shell objects, explore samples, and understand how the Vanara toolkit maps to the Windows platform.
+
+The goal of Jñāna is to make the Vanara ecosystem more accessible — for contributors, maintainers, and developers who want to understand the structure and capabilities of the library.
+
+---
+
+## ✨ Features
+
+- **API Explorer**  
+  Navigate Vanara namespaces, types, functions, constants, and structures.
+
+- **Shell & File Explorer Integration**  
+  Visualize Shell items, folders, PIDLs, and related COM structures using Vanara’s Shell32 bindings.
+
+- **Samples Browser**  
+  Browse runnable code samples demonstrating how to use Vanara APIs in real scenarios.
+
+- **WinUI 3 Interface**  
+  Modern, fluent UI with navigation, search, and responsive layout.
+
+- **Extensible Architecture**  
+  Designed to grow with the Vanara library — new modules can be added without restructuring the core.
+
+---
+
+## 🧱 Technology Stack
+
+- **WinUI 3 / Windows App SDK 1.6**
+- **.NET 8**
+- **Vanara 4.x**
+- **C#**
+- **MVU/MVVM‑friendly architecture**
+
+---
+
+## 📁 Project Structure
+### Root: ̀ Vanara Jñāna 
+- App.xaml
+- 📁 /Controls
+- 📁 /Models
+- 📁 /Pages
+	- ApiExplorerPage.xaml
+	- ShellExplorerPage.xaml
+	- SamplesPage.xaml
+	- SettingsPage.xaml
+- 📁 /Services
+- 📁 /ViewModels
+
+---
+
+## 🚀 Getting Started
+
+### Prerequisites
+- Windows 11  
+- Visual Studio 2022 (17.10+)  
+- Windows App SDK 1.6  
+- .NET 8 SDK  
+
+### Build & Run
+
+```powershell
+git clone https://github.com/<your-repo>/Vanara.Jnana.git
+cd Vanara.Jnana
+dotnet build
+dotnet run
+```
+
+# Roadmap
+
+[ ] Full Shell namespace visualization
+
+[ ] Integrated COM inspector
+
+[ ] Live API search with fuzzy matching
+
+[ ] Sample runner with output capture
+
+[ ] Plugin system for community extensions
+
+[ ] Themed UI (Light/Dark/Mica/Custom)
+
+# 🤝 Contributing
+
+Contributions are welcome!
+
+Please open issues for bugs or feature requests, and submit pull requests for improvements.
+
+If you want to add features, fix bugs, or improve documentation:
+
+Fork the repository
+
+Create a feature branch
+
+Submit a Pull Request
+
+Please follow the existing code style and include clear commit messages.
+
+📜 License
+
+This project is licensed under the MIT License.
+See LICENSE for details.
+
+----
+old version:
+----
+
+## Introduction
+This Repository is an example of [WinClassicSamples](https://github.com/dahall/WinClassicSamplesCS/) using the Vanara 
+libraries in a modern `WinUi 3` on `WinAppSDK` environment.
+
+The original WinClassicSamples repository is a collection of samples that demonstrate the use of the Windows API in C#.
+
+The goal is to demonstrate the use of the Vanara libraries in a side-by-side model with full featured modern WinUi environment.
+
+This repository is intended to be a reference for developers who want to use the Vanara libraries in their own projects, and 
+to provide a starting point for those who want to learn how to use the Vanara libraries in a WinUI3 App.
+
+#### Project Intent
+Test and validate that the structures, methods and interfaces in Vanara using known code and outcomes.
+Demonstrate the use of the Vanara libraries in a side-by-side model with the native Win32 API.
+
+#### Getting Started
+First, take a look at [Template Studio for WinUI (C#)](https://marketplace.visualstudio.com/items?itemName=TemplateStudio.TemplateStudioForWinUICs),
+available through Visual Studio Marketplace:
+
+> _Template Studio for WinUI accelerates the creation of new WinUI apps using a wizard-based UI._
+>
+> Projects created with this extension contain well-formed, readable code and incorporate the latest development features while implementing proven patterns and leading practices. The generated code includes links to documentation and TODO comments that provide useful insight and guidance for turning the generated projects into production applications.
+>
+> To get started, install the extension, then select the corresponding Template Studio project template when creating a new project in Visual Studio. Name your project, then click Create to launch the Template Studio wizard.
+
+
+# Resources
+- [Vanara Git](https://github.com/dahall/Vanara)
+- [WinClassicSamples using ``Vanara and WinForms`` Git](https://github.com/dahall/WinClassicSamplesCS)
+- [Official WinUI3 on Microsoft.com](https://docs.microsoft.com/en-us/windows/apps/winui/winui3/)
+- [Native Microsoft WinClassicSamples on GitHub](https://github.com/Microsoft/Windows-classic-samples)
+- [Template Studio for WinUI (C#) on VisualStudio Marketplace](https://marketplace.visualstudio.com/items?itemName=TemplateStudio.TemplateStudioForWinUICs)

Vanara-Jnana/Directory.Packages.props

@@ -0,0 +1,6 @@
+<Project>
+  <ItemGroup>
+    <PackageVersion Include="Microsoft.Web.WebView2" />
+    <PackageVersion Include="Microsoft.WindowsAppSDK" Version="1.8.0" />
+  </ItemGroup>
+</Project>

Vanara-Jnana/Helpers/GuruMeditationException.cs

@@ -0,0 +1,23 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+using Vanara.PInvoke;
+
+namespace Jnana.Helpers;
+
+public class GuruMeditationException : Exception
+{
+    public GuruMeditationException()
+        : base("Guru Meditation") { }
+
+    public GuruMeditationException(string message)
+        : base(message) { }
+
+    public GuruMeditationException(string message, Exception inner)
+        : base(message, inner) { }
+
+    public GuruMeditationException(HRESULT hRESULT)
+        : base("Guru Meditation") { }
+}

WinUiClassicSamplesBrowser/Helpers/WindowsSystemDispatcherQueueHelper.cs → Vanara-Jnana/Helpers/WindowsSystemDispatcherQueueHelper.cs

@@ -1,6 +1,6 @@
 using Microsoft.UI.Dispatching;
 
-namespace ClassicSamplesBrowser.Helpers;
+namespace Jnana.Helpers;
 
 public class WindowsSystemDispatcherQueueHelper
 {