mirror of
https://github.com/XCharts-Team/XCharts.git
synced 2026-05-16 21:40:41 +00:00
373 lines
14 KiB
C#
373 lines
14 KiB
C#
/******************************************/
|
||
/* */
|
||
/* Copyright (c) 2018 monitor1394 */
|
||
/* https://github.com/monitor1394 */
|
||
/* */
|
||
/******************************************/
|
||
|
||
using System;
|
||
using UnityEngine;
|
||
|
||
namespace XCharts
|
||
{
|
||
/// <summary>
|
||
/// Text label of chart, to explain some data information about graphic item like value, name and so on.
|
||
/// 图形上的文本标签，可用于说明图形的一些数据信息，比如值，名称等。
|
||
/// </summary>
|
||
[System.Serializable]
|
||
public class SerieLabel : SubComponent
|
||
{
|
||
/// <summary>
|
||
/// The position of label.
|
||
/// 标签的位置。
|
||
/// </summary>
|
||
public enum Position
|
||
{
|
||
/// <summary>
|
||
/// Outside of sectors of pie chart, which relates to corresponding sector through visual guide line.
|
||
/// 饼图扇区外侧，通过视觉引导线连到相应的扇区。
|
||
/// </summary>
|
||
Outside,
|
||
/// <summary>
|
||
/// Inside the sectors of pie chart.
|
||
/// 饼图扇区内部。
|
||
/// </summary>
|
||
Inside,
|
||
/// <summary>
|
||
/// In the center of pie chart.
|
||
/// 在饼图中心位置。
|
||
/// </summary>
|
||
Center,
|
||
/// <summary>
|
||
/// top of symbol.
|
||
/// 图形标志的顶部。
|
||
/// </summary>
|
||
Top,
|
||
/// <summary>
|
||
/// the left of symbol.
|
||
/// 图形标志的左边。
|
||
/// </summary>
|
||
//Left,
|
||
/// <summary>
|
||
/// the right of symbol.
|
||
/// 图形标志的右边。
|
||
/// </summary>
|
||
//Right,
|
||
/// <summary>
|
||
/// the bottom of symbol.
|
||
/// 图形标志的底部。
|
||
/// </summary>
|
||
Bottom,
|
||
}
|
||
|
||
/// <summary>
|
||
/// 标签视觉引导线类型
|
||
/// </summary>
|
||
public enum LineType
|
||
{
|
||
/// <summary>
|
||
/// 折线
|
||
/// </summary>
|
||
BrokenLine,
|
||
/// <summary>
|
||
/// 曲线
|
||
/// </summary>
|
||
Curves,
|
||
/// <summary>
|
||
/// 水平线
|
||
/// </summary>
|
||
HorizontalLine
|
||
}
|
||
[SerializeField] private bool m_Show = false;
|
||
[SerializeField] Position m_Position = Position.Outside;
|
||
[SerializeField] private Vector3 m_Offset;
|
||
[SerializeField] private float m_Margin;
|
||
[SerializeField] private string m_Formatter;
|
||
[SerializeField] private float m_Rotate = 0;
|
||
[SerializeField] private float m_PaddingLeftRight = 2f;
|
||
[SerializeField] private float m_PaddingTopBottom = 2f;
|
||
[SerializeField] private Color m_Color;
|
||
[SerializeField] private Color m_BackgroundColor;
|
||
[SerializeField] private float m_BackgroundWidth = 0;
|
||
[SerializeField] private float m_BackgroundHeight = 0;
|
||
[SerializeField] private int m_FontSize = 18;
|
||
[SerializeField] private FontStyle m_FontStyle = FontStyle.Normal;
|
||
[SerializeField] private bool m_Line = true;
|
||
[SerializeField] private LineType m_LineType = LineType.BrokenLine;
|
||
[SerializeField] private Color m_LineColor = Color.clear;
|
||
[SerializeField] private float m_LineWidth = 1.0f;
|
||
[SerializeField] private float m_LineLength1 = 25f;
|
||
[SerializeField] private float m_LineLength2 = 15f;
|
||
[SerializeField] private bool m_Border = false;
|
||
[SerializeField] private float m_BorderWidth = 0.5f;
|
||
[SerializeField] private Color m_BorderColor = Color.grey;
|
||
[SerializeField] private string m_NumericFormatter = "";
|
||
[SerializeField] private bool m_AutoOffset = false;
|
||
|
||
public void Reset()
|
||
{
|
||
m_Show = false;
|
||
m_Position = Position.Outside;
|
||
m_Offset = Vector3.zero;
|
||
m_Margin = 0;
|
||
m_PaddingLeftRight = 2f;
|
||
m_PaddingTopBottom = 2f;
|
||
m_Color = Color.clear;
|
||
m_BackgroundColor = Color.clear;
|
||
m_BackgroundWidth = 0;
|
||
m_BackgroundHeight = 0;
|
||
m_FontSize = 18;
|
||
m_FontStyle = FontStyle.Normal;
|
||
m_Line = true;
|
||
m_LineType = LineType.BrokenLine;
|
||
m_LineColor = Color.clear;
|
||
m_LineWidth = 1.0f;
|
||
m_LineLength1 = 25f;
|
||
m_LineLength2 = 15f;
|
||
m_Border = false;
|
||
m_BorderWidth = 0.5f;
|
||
m_BorderColor = Color.grey;
|
||
m_NumericFormatter = "";
|
||
m_AutoOffset = false;
|
||
}
|
||
|
||
/// <summary>
|
||
/// Whether the label is showed.
|
||
/// 是否显示文本标签。
|
||
/// </summary>
|
||
public bool show
|
||
{
|
||
get { return m_Show; }
|
||
set { if (PropertyUtility.SetStruct(ref m_Show, value)) SetAllDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// The position of label.
|
||
/// 标签的位置。
|
||
/// </summary>
|
||
public Position position
|
||
{
|
||
get { return m_Position; }
|
||
set { if (PropertyUtility.SetStruct(ref m_Position, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// 标签内容字符串模版格式器。支持用 \n 换行。
|
||
/// 模板变量有：
|
||
/// <list type="bullet">
|
||
/// <item><description>{a}：系列名。</description></item>
|
||
/// <item><description>{b}：数据名。</description></item>
|
||
/// <item><description>{c}：数据值。</description></item>
|
||
/// <item><description>{d}：百分比。</description></item>
|
||
/// </list>
|
||
/// </summary>
|
||
/// <example>
|
||
/// 示例：“{b}:{c}”
|
||
/// </example>
|
||
public string formatter
|
||
{
|
||
get { return m_Formatter; }
|
||
set { if (PropertyUtility.SetClass(ref m_Formatter, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// offset to the host graphic element.
|
||
/// 距离图形元素的偏移
|
||
/// </summary>
|
||
public Vector3 offset
|
||
{
|
||
get { return m_Offset; }
|
||
set { if (PropertyUtility.SetStruct(ref m_Offset, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// 距离轴线的距离。
|
||
/// </summary>
|
||
public float margin
|
||
{
|
||
get { return m_Margin; }
|
||
set { if (PropertyUtility.SetStruct(ref m_Margin, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// Text color,If set as default ,the color will assigned as series color.
|
||
/// 自定义文字颜色，默认和系列的颜色一致。
|
||
/// </summary>
|
||
public Color color
|
||
{
|
||
get { return m_Color; }
|
||
set { if (PropertyUtility.SetStruct(ref m_Color, value)) SetComponentDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// the background color. If set as default, it means than don't show background.
|
||
/// 标签的背景色，默认无颜色。
|
||
/// </summary>
|
||
public Color backgroundColor
|
||
{
|
||
get { return m_BackgroundColor; }
|
||
set { if (PropertyUtility.SetStruct(ref m_BackgroundColor, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// the width of background. If set as default value 0, it means than the background width auto set as the text width.
|
||
/// 标签的背景宽度。一般不用指定，不指定时则自动是文字的宽度。
|
||
/// </summary>
|
||
/// <value></value>
|
||
public float backgroundWidth
|
||
{
|
||
get { return m_BackgroundWidth; }
|
||
set { if (PropertyUtility.SetStruct(ref m_BackgroundWidth, value)) SetComponentDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// the height of background. If set as default value 0, it means than the background height auto set as the text height.
|
||
/// 标签的背景高度。一般不用指定，不指定时则自动是文字的高度。
|
||
/// </summary>
|
||
/// <value></value>
|
||
public float backgroundHeight
|
||
{
|
||
get { return m_BackgroundHeight; }
|
||
set { if (PropertyUtility.SetStruct(ref m_BackgroundHeight, value)) SetComponentDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// Rotate label.
|
||
/// 标签旋转。
|
||
/// </summary>
|
||
public float rotate
|
||
{
|
||
get { return m_Rotate; }
|
||
set { if (PropertyUtility.SetStruct(ref m_Rotate, value)) SetComponentDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// the text padding of left and right. defaut:2.
|
||
/// 左右边距。
|
||
/// </summary>
|
||
public float paddingLeftRight
|
||
{
|
||
get { return m_PaddingLeftRight; }
|
||
set { if (PropertyUtility.SetStruct(ref m_PaddingLeftRight, value)) SetComponentDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// the text padding of top and bottom. defaut:2.
|
||
/// 上下边距。
|
||
/// </summary>
|
||
public float paddingTopBottom
|
||
{
|
||
get { return m_PaddingTopBottom; }
|
||
set { if (PropertyUtility.SetStruct(ref m_PaddingTopBottom, value)) SetComponentDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// font size.
|
||
/// 文字的字体大小。
|
||
/// </summary>
|
||
public int fontSize
|
||
{
|
||
get { return m_FontSize; }
|
||
set { if (PropertyUtility.SetStruct(ref m_FontSize, value)) SetAllDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// font style.
|
||
/// 文字的字体风格。
|
||
/// </summary>
|
||
public FontStyle fontStyle
|
||
{
|
||
get { return m_FontStyle; }
|
||
set { if (PropertyUtility.SetStruct(ref m_FontStyle, value)) SetAllDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// Whether to show visual guide line.Will show when label position is set as 'outside'.
|
||
/// 是否显示视觉引导线。在 label 位置 设置为'outside'的时候会显示视觉引导线。
|
||
/// </summary>
|
||
public bool line
|
||
{
|
||
get { return m_Line; }
|
||
set { if (PropertyUtility.SetStruct(ref m_Line, value)) SetComponentDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// the type of visual guide line.
|
||
/// 视觉引导线类型。
|
||
/// </summary>
|
||
public LineType lineType
|
||
{
|
||
get { return m_LineType; }
|
||
set { if (PropertyUtility.SetStruct(ref m_LineType, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// the color of visual guild line.
|
||
/// 视觉引导线颜色。默认和serie一致取自调色板。
|
||
/// </summary>
|
||
public Color lineColor
|
||
{
|
||
get { return m_LineColor; }
|
||
set { if (PropertyUtility.SetStruct(ref m_LineColor, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// the width of visual guild line.
|
||
/// 视觉引导线的宽度。
|
||
/// </summary>
|
||
public float lineWidth
|
||
{
|
||
get { return m_LineWidth; }
|
||
set { if (PropertyUtility.SetStruct(ref m_LineWidth, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// The length of the first segment of visual guide line.
|
||
/// 视觉引导线第一段的长度。
|
||
/// </summary>
|
||
public float lineLength1
|
||
{
|
||
get { return m_LineLength1; }
|
||
set { if (PropertyUtility.SetStruct(ref m_LineLength1, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// The length of the second segment of visual guide line.
|
||
/// 视觉引导线第二段的长度。
|
||
/// </summary>
|
||
public float lineLength2
|
||
{
|
||
get { return m_LineLength2; }
|
||
set { if (PropertyUtility.SetStruct(ref m_LineLength2, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// Whether to show border.
|
||
/// 是否显示边框。
|
||
/// </summary>
|
||
public bool border
|
||
{
|
||
get { return m_Border; }
|
||
set { if (PropertyUtility.SetStruct(ref m_Border, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// the width of border.
|
||
/// 边框宽度。
|
||
/// </summary>
|
||
public float borderWidth
|
||
{
|
||
get { return m_BorderWidth; }
|
||
set { if (PropertyUtility.SetStruct(ref m_BorderWidth, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// the color of border.
|
||
/// 边框颜色。
|
||
/// </summary>
|
||
public Color borderColor
|
||
{
|
||
get { return m_BorderColor; }
|
||
set { if (PropertyUtility.SetStruct(ref m_BorderColor, value)) SetVerticesDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// Standard numeric format strings.
|
||
/// 标准数字格式字符串。用于将数值格式化显示为字符串。
|
||
/// 使用Axx的形式：A是格式说明符的单字符，支持C货币、D十进制、E指数、F定点数、G常规、N数字、P百分比、R往返、X十六进制的。xx是精度说明，从0-99。
|
||
/// 参考：https://docs.microsoft.com/zh-cn/dotnet/standard/base-types/standard-numeric-format-strings
|
||
/// </summary>
|
||
/// <value></value>
|
||
public string numericFormatter
|
||
{
|
||
get { return m_NumericFormatter; }
|
||
set { if (PropertyUtility.SetClass(ref m_NumericFormatter, value)) SetComponentDirty(); }
|
||
}
|
||
/// <summary>
|
||
/// 是否开启自动偏移。当开启时，Y的偏移会自动判断曲线的开口来决定向上还是向下偏移。
|
||
/// </summary>
|
||
public bool autoOffset
|
||
{
|
||
get { return m_AutoOffset; }
|
||
set { if (PropertyUtility.SetStruct(ref m_AutoOffset, value)) SetAllDirty(); }
|
||
}
|
||
}
|
||
}
|