syncfusion-maui-linear-gauge

实现 .NET MAUI 线性仪表

Syncfusion® .NET MAUI 线性仪表（SfLinearGauge）是一款功能强大的数据可视化控件，可在线性刻度上显示数值。使用它可以在 .NET MAUI 应用中创建直观的测量显示、进度指示器、温度计风格的可视化效果，以及交互式滑块控件。

何时使用此技能

在以下情况下使用此技能：

• 在线性刻度上显示测量值 - 温度、压力、体积、速度或任何线性指标
• 创建进度指示器 - 下载进度、任务完成情况，以及带有视觉反馈的加载状态
• 构建交互式仪表 - 用户可调节的滑块、可拖动的数值选择器
• 显示性能范围 - 以颜色编码的区域（例如，红色／黄色／绿色性能指示器）
• 可视化多个数据点 - 在同一刻度上显示多个指针以进行比较
• 实现垂直或水平显示 - 温度计、燃油表、电池指示器
• 创建动画可视化效果 - 数值变化时平滑过渡
• 构建镜像仪表布局 - 支持 RTL 或对称的双显示布局

组件概述

主要功能：

• 灵活的方向 - 垂直或水平布局
• 可自定义的刻度 - 可调节最小值／最大值、间隔和外观
• 多种指针类型 - 条形指针、形状标记、自定义内容标记
• 可视化范围 - 以颜色编码的区域突出显示特定数值范围
• 交互手势 - 拖动和滑动以更改指针数值
• 丰富的自定义选项 - 标签、刻度线、样式、渐变、圆角样式
• 动画支持 - 数值平滑过渡和加载动画
• 镜像效果 - RTL 布局和对称设计

文档和导航指南

入门

📄 阅读： references/getting-started.md

阅读时机： 首次设置、安装或基本实现

涵盖主题：

• 安装 Syncfusion.Maui.Gauges NuGet 包
• 在 MauiProgram.cs 中注册处理程序
• 创建第一个线性仪表
• 添加基本刻度元素
• 添加范围和指针
• 完整的可运行示例
• 排查设置问题

刻度配置

📄 阅读： references/scale-configuration.md

阅读时机： 配置仪表刻度属性、最小值／最大值、间隔或外观时

涵盖主题：

• 默认刻度行为（0-100）
• 自定义最小值和最大值
• 设置刻度间隔
• 刻度外观（粗细、填充颜色、边缘样式）
• 方向（垂直或水平）
• 反向刻度（数值方向反转）
• 刻度位置和偏移量
• 常见刻度模式

标签和刻度线

📄 阅读： references/labels-and-ticks.md

阅读时机： 自定义刻度标签、设置文本格式或配置刻度线时

涵盖主题：

• 标签位置和对齐方式
• 标签文本格式（数字格式、自定义文本）
• 标签样式（字体、颜色、大小）
• 标签偏移量和可见性
• 主刻度线配置
• 次刻度线配置
• 刻度线位置、长度和样式
• 隐藏刻度线或标签
• 完整的自定义示例

范围

📄 阅读： references/ranges.md

阅读时机： 添加可视化范围、颜色编码区域或性能指示器时

涵盖主题：

• 范围概述和用途
• 基本范围实现
• 范围形状自定义（起始／中间／结束宽度）
• 范围位置（起始值／结束值）
• 范围样式（纯色填充、渐变）
• 在同一刻度上添加多个范围
• 相对于刻度的位置
• 圆角样式和外观
• 性能区域和颜色编码示例

条形指针

📄 阅读： references/bar-pointer.md

阅读时机： 实现条形指针（填充式进度条）

涵盖主题：

• 条形指针概览
• 条形指针的基本实现
• 设置指针值和位置
• 条形样式（填充、渐变、不透明度）
• 条形的圆角样式
• 条形偏移和定位
• 值变化时的动画
• 多个条形指针
• 指针事件
• 常见条形指针模式

标记指针

📄 阅读： references/marker-pointers.md

阅读时机： 添加形状标记或自定义内容指针

涵盖主题：

• 形状标记指针（内置形状）
  • 可用形状：圆形、三角形、菱形、倒三角形、矩形
  • 形状大小、填充和描边自定义
  • 形状定位和偏移
• 内容标记指针（自定义内容）
  • 使用图像作为指针
  • 基于文本的指针
  • 将自定义视图用作指针
  • 内容对齐和定位
• 同一刻度上的多个标记指针
• 标记动画效果
• 常见标记模式和用例

交互

📄 阅读： references/interaction.md

阅读时机： 启用用户交互、拖动手势或指针事件

涵盖主题：

• 交互概览
• 启用 IsInteractive 属性
• 拖动手势处理
• 滑动手势处理
• ValueChangeStarted 事件
• ValueChanging 事件（实时更新）
• ValueChangeCompleted 事件
• 限制指针移动
• 交互式指针示例
• 多指针交互场景

动画和效果

📄 阅读： references/animation-and-effects.md

阅读时机： 添加动画、镜像效果或特殊视觉效果

涵盖主题：

• 动画概览
• 启用加载动画
• 动画时长和缓动
• 值变化时的指针动画
• 范围动画效果
• 镜像仪表盘效果（IsMirrored）
• RTL 支持和镜像布局
• 方向变化和过渡效果
• 完整动画示例