CgdataBase.Avalonia 12.0.0

CgdataBase.Avalonia

一组面向 Avalonia 11 的通用控件能力与工具类，包含样式主题、常用转换器、以及用于“记忆 UI 状态”的控制器（Window / DataGrid / Grid）。

依赖与目标框架

• 目标框架：net6.0 / net8.0 / net10.0
• 主要依赖：Avalonia 11.3.2、Avalonia.Controls.DataGrid 11.3.2、Avalonia.Desktop 11.3.2
• 另外依赖：项目引用 CgdataBase.Core

引用方式

方式 1：项目引用（仓库内开发推荐）

• 在你的应用项目中引用 CgdataBase.Avalonia.csproj

方式 2：NuGet（若已发布）

dotnet add package CgdataBase.Avalonia

快速开始

1）在 App.axaml 中引入主题样式

<Application xmlns="https://github.com/avaloniaui"
             xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
             x:Class="YourApp.App">
    <Application.Styles>
        <FluentTheme />
        <StyleInclude Source="avares://CgdataBase.Avalonia/Styles/Theme1.axaml" />
    </Application.Styles>
</Application>

主题入口文件： Theme1.axaml。

2）Window：自动保存/恢复窗口大小与状态

using Avalonia.Controls;
using CgdataBase;

public partial class MainWindow : Window
{
    public MainWindow()
    {
        InitializeComponent();
        WindowController.UpdateWindowConfig(this, GetType());
    }
}

实现位于 WindowController。

3）DataGrid：记忆列宽

using Avalonia.Controls;
using CgdataBase.Avalonia.Controllers;

DataGridController.UpdateDataGridConfig(this, TaskList);

实现位于 DataGridController。

4）Grid：记忆行高/列宽（Row/ColumnDefinitions）

using Avalonia.Controls;
using CgdataBase.Avalonia.Controllers;

GridController.AttachedProperties(this, ContentGrid);

实现位于 GridController。

5）FocusBehavior：通过绑定控制焦点

该行为使用 AttachedProperty<int>：当绑定值变化时，将控件聚焦，并在 TextBox 上把光标移动到末尾。

<TextBox
    xmlns:hp="clr-namespace:CgdataBase.Avalonia.Helpers;assembly=CgdataBase.Avalonia"
    hp:FocusBehavior.IsFocused="{Binding KeywordFocused}"
    Text="{Binding Keyword}" />

实现位于 FocusBehavior。

6）常用转换器（Converters）

<Window xmlns="https://github.com/avaloniaui"
        xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
        xmlns:cvt="clr-namespace:CgdataBase.Avalonia.Converters;assembly=CgdataBase.Avalonia">
    <Window.Resources>
        <cvt:EnumToDescriptionConverter x:Key="EnumToDescriptionConverter" />
        <cvt:FileSizeConverter x:Key="FileSizeConverter" />
    </Window.Resources>

    <TextBlock Text="{Binding Speed, Converter={StaticResource EnumToDescriptionConverter}}" />
    <TextBlock Text="{Binding FileSize, Converter={StaticResource FileSizeConverter}}" />
</Window>

相关文件位于 Converters。

配置存储说明

Window / DataGrid / Grid 的状态保存与读取依赖 UISettings（来自 CgdataBase.Core）。默认会以“类型 + 控件名/固定键名”的方式记录配置。

构建

dotnet build .\CgdataBase.Avalonia\CgdataBase.Avalonia.csproj -c Release

仓库内示例应用： CgdataBaseAvaloniaDemo

License

MIT