Merge Vanara Jñāna v1.2661 Release Candidate
#16
There are no files selected for viewing
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
|
Owner
There was a problem hiding this comment. Is this file needed for your project? I'm ok leaving it, but it will then build on github after each commit.
Author
There was a problem hiding this comment. No, it is NOT needed. The solution actually not even has It would be nice you could integrate Jnana's solution into the whole package. Especially, since I can't build most of the ClassicSamples yet with that old base main branch this Repo is based on. |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,30 @@ | ||
| name: Build WinUI 3 App | ||
|
|
||
| on: | ||
| push: | ||
| branches: [ main ] | ||
| pull_request: | ||
| branches: [ main ] | ||
|
|
||
| jobs: | ||
| build: | ||
| runs-on: windows-latest | ||
|
|
||
| steps: | ||
| - name: Checkout repository | ||
| uses: actions/checkout@v4 | ||
|
|
||
| - name: Setup .NET | ||
| uses: actions/setup-dotnet@v4 | ||
| with: | ||
| dotnet-version: 8.0.x | ||
|
|
||
| - name: Restore dependencies | ||
| run: dotnet restore | ||
|
|
||
| - name: Build solution | ||
| run: dotnet build --configuration Release --no-restore | ||
|
|
||
| - name: Publish (optional for unpackaged) | ||
| if: ${{ false }} # set to true if you want publish output | ||
| run: dotnet publish -c Release |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,78 @@ | ||
| <Application | ||
| x:Class="ClassicSamplesBrowser.App" | ||
| xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" | ||
| xmlns:system="using:System" | ||
| xmlns:ui="using:Microsoft.UI.Xaml" | ||
| xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"> | ||
| <Application.Resources> | ||
| <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}" /> | ||
| <SolidColorBrush x:Key="MicaBaseFillColorSecondaryBrush" Color="{ThemeResource SystemBaseHighColor}" /> | ||
| <SolidColorBrush x:Key="TabViewButtonBackground" Color="{ThemeResource SystemBaseLowColor}" /> | ||
| <SolidColorBrush x:Key="TabViewButtonForeground" Color="{ThemeResource SystemBaseMediumColor}" /> | ||
| <SolidColorBrush x:Key="TabViewScrollButtonBackground" Color="{ThemeResource SystemBaseLowColor}" /> | ||
| <SolidColorBrush x:Key="TabViewScrollButtonForeground" Color="{ThemeResource SystemBaseMediumColor}" /> | ||
| <system:Double x:Key="TabViewItemAddButtonFontSize">14</system:Double> | ||
| <system:Double x:Key="TabViewItemScrollButtonFontSize">14</system:Double> | ||
| </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> | ||
| </Setter.Value> | ||
| </Setter> | ||
| </Style> | ||
| <Style TargetType="TabView"> | ||
| <Setter Property="Template"> | ||
| <Setter.Value> | ||
| <ControlTemplate TargetType="TabView"> | ||
| <Grid> | ||
| <Grid.RowDefinitions> | ||
| <RowDefinition Height="Auto" /> | ||
| <RowDefinition Height="*" /> | ||
| </Grid.RowDefinitions> | ||
| <StackPanel Orientation="Horizontal" Grid.Row="0" Background="{ThemeResource MicaBaseAltFillColorDefaultBrush}"> | ||
| <TabViewListView x:Name="TabListView" ItemsSource="{TemplateBinding TabItems}" SelectedItem="{TemplateBinding SelectedItem}" SelectionMode="Single" IsTabStop="False" /> | ||
| <Button x:Name="AddButton" Width="32" Height="32" Margin="4" VerticalAlignment="Center"> | ||
| <SymbolIcon Symbol="Add" /> | ||
| </Button> | ||
| </StackPanel> | ||
| <ContentPresenter Grid.Row="1" Content="{TemplateBinding SelectedContent}" Margin="0" /> | ||
| </Grid> | ||
| </ControlTemplate> | ||
| </Setter.Value> | ||
| </Setter> | ||
| </Style>--> |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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(); | ||
| } | ||
| } |
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Binary file not shown.
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file not shown.
Empty file.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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 |
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -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) |
Binary file not shown.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
| Original file line number | Diff line number | Diff line change |
|---|---|---|
| @@ -0,0 +1,6 @@ | ||
| <Project> | ||
| <ItemGroup> | ||
| <PackageVersion Include="Microsoft.Web.WebView2" /> | ||
| <PackageVersion Include="Microsoft.WindowsAppSDK" Version="1.8.0" /> | ||
| </ItemGroup> | ||
| </Project> |
Oops, something went wrong.
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Please undo this change before I merge. The analyzers are part of what I'm testing with this solution.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Sorry, my fault. was not intended...