AtomUI/docs/Desktop.Controls/QRCode/QRCodeAPI.md

QRCode API 参考

命名空间

// 桌面端具体实现
namespace AtomUI.Desktop.Controls;

// 设备无关基类
namespace AtomUI.Controls.Commons;

// 枚举类型
namespace AtomUI.Controls;

AXAML 命名空间前缀：atom（xmlns:atom="https://atomui.net"）

---

枚举类型

QRCodeEccLevel

二维码纠错等级枚举，定义于 AtomUI.Controls 命名空间。

值	数值	说明
L	0	最低容错（~7%），二维码最紧凑
M	1	默认等级（~15%），平衡容错与紧凑度
Q	2	较高容错（~25%），适合放置小图标
H	3	最高容错（~30%），适合放置较大图标

QRCodeStatus

二维码状态枚举，定义于 AtomUI.Controls 命名空间。

值	数值	说明
Active	0	正常状态（默认），二维码正常显示
Expired	1	已过期，显示遮罩 + 过期文案 + 刷新按钮
Loading	2	加载中，显示遮罩 + 旋转加载指示器
Scanned	3	已扫描，显示遮罩 + 已扫描文案

---

公共属性（StyledProperty）

以下属性定义在 AbstractQRCode 基类中，QRCode 完全继承。

属性名	类型	默认值	说明
Value	string	""	二维码编码的文本或 URL 内容
IsBordered	bool	true	是否显示外边框和内间距
Color	IBrush?	由主题 Token 控制	二维码前景色（像素颜色）
EccLevel	QRCodeEccLevel	QRCodeEccLevel.M	纠错等级（L/M/Q/H）
Size	int	160	二维码像素尺寸（宽高相同）
IconSize	int	40	中心图标区域大小（像素）
Icon	IImage?	null	中心图标图像源，支持 avares:// 协议
IconBgColor	IBrush?	由主题 Token 控制	中心图标背景色
Status	QRCodeStatus	QRCodeStatus.Active	二维码状态
LoadingContent	object?	null	加载状态自定义内容，为 null 时使用默认 Spin
LoadingContentTemplate	IDataTemplate?	null	加载状态内容数据模板
ExpiredContent	object?	null	过期状态自定义内容，为 null 时使用默认文案+刷新按钮
ExpiredContentTemplate	IDataTemplate?	null	过期状态内容数据模板
ScannedContent	object?	null	已扫描状态自定义内容，为 null 时使用默认文案
ScannedContentTemplate	IDataTemplate?	null	已扫描状态内容数据模板

继承自 TemplatedControl 的常用属性

属性名	类型	默认值	说明
Background	IBrush?	Transparent（由主题控制）	二维码背景色（对应 Ant Design 的 bgColor）
Foreground	IBrush?	由 Token 控制	前景色（用于状态文案）
BorderBrush	IBrush?	Transparent（IsBordered=True 时为 ColorSplit）	边框颜色
BorderThickness	Thickness	由 SharedToken.BorderThickness 控制	边框粗细
CornerRadius	CornerRadius	由 SharedToken.BorderRadiusLG 控制	圆角半径
Padding	Thickness	IsBordered=True 时为 SharedToken.PaddingSM	内间距

---

事件

事件名	类型	说明
RefreshRequested	EventHandler?	用户点击过期状态下的刷新按钮时触发，用于重新生成二维码

---

模板部件

部件名	类型	说明
PART_RefreshButton	Button	过期状态下的刷新按钮，使用 [TemplatePart] 特性声明

---

类继承关系

// 基类（AtomUI.Controls）
[TemplatePart("PART_RefreshButton", typeof(Button))]
public class AbstractQRCode : TemplatedControl
{
    // 全部属性、事件和生成逻辑
}

// 桌面端实现（AtomUI.Desktop.Controls）
public class QRCode : AbstractQRCode
{
    public QRCode()
    {
        this.RegisterTokenResourceScope(QRCodeToken.ScopeProvider);
    }
}