LanMountainDesktop/docs/Plugins develop/03-API实践指南/04-外观API详解.md

04-外观API详解

外观 API 提供圆角、主题等视觉相关的功能。

---

🎯 IPluginAppearanceContext

public interface IPluginAppearanceContext
{
    // 获取圆角值
    CornerRadius ResolveCornerRadius(PluginCornerRadiusPreset preset);
    
    // 获取带限制的圆角值
    CornerRadius ResolveCornerRadius(
        PluginCornerRadiusPreset preset,
        CornerRadius? minimum,
        CornerRadius? maximum);
    
    // 获取缩放后的圆角值
    CornerRadius ResolveScaledCornerRadius(
        double baseRadius,
        double? minimum,
        double? maximum);
    
    // 外观变化事件
    event EventHandler? AppearanceChanged;
}

---

📐 圆角 API

获取圆角值

public MyWidget(PluginDesktopComponentContext context)
{
    // 使用预设
    CornerRadius = context.Appearance.ResolveCornerRadius(
        PluginCornerRadiusPreset.Component);
}

带限制的圆角

var radius = context.Appearance.ResolveCornerRadius(
    PluginCornerRadiusPreset.Component,
    minimum: new CornerRadius(8),
    maximum: new CornerRadius(24));

缩放圆角

var radius = context.Appearance.ResolveScaledCornerRadius(
    baseRadius: 16,
    minimum: 8,
    maximum: 32);

---

🎨 圆角预设

预设	值	用途
Micro	6px	微小元素
Xs	12px	小元素
Sm	14px	小卡片
Md	20px	普通按钮
Lg	28px	大面板
Xl	32px	强调容器
Island	36px	大型容器
Component	18px	桌面组件
Default	自适应	自动计算

---

🔄 响应外观变化

public MyWidget(PluginDesktopComponentContext context)
{
    context.Appearance.AppearanceChanged += (_, _) =>
    {
        // 重新应用圆角
        CornerRadius = context.Appearance.ResolveCornerRadius(
            PluginCornerRadiusPreset.Component);
    };
}

---

📚 参考资源

• IPluginAppearanceContext 源码
• 04-外观与主题系统

---

最后更新：2026年4月