This commit is contained in:
monitor1394
2022-03-24 21:48:53 +08:00
parent f597a3f116
commit 2e954490ec
21 changed files with 3187 additions and 2161 deletions

View File

@@ -20,22 +20,22 @@ namespace XCharts.Runtime
{
/// <summary>
/// Numerical axis, suitable for continuous data.
/// |数值轴。适用于连续数据。
/// ||数值轴。适用于连续数据。
/// </summary>
Value,
/// <summary>
/// Category axis, suitable for discrete category data. Data should only be set via data for this type.
/// |类目轴。适用于离散的类目数据,为该类型时必须通过 data 设置类目数据。
/// ||类目轴。适用于离散的类目数据,为该类型时必须通过 data 设置类目数据。
/// </summary>
Category,
/// <summary>
/// Log axis, suitable for log data.
/// 对数轴。适用于对数数据。
/// |对数轴。适用于对数数据。
/// </summary>
Log,
/// <summary>
/// Time axis, suitable for continuous time series data.
/// 时间轴。适用于连续的时序数据。
/// |时间轴。适用于连续的时序数据。
/// </summary>
Time
}
@@ -48,17 +48,17 @@ namespace XCharts.Runtime
{
/// <summary>
/// 0 - maximum.
/// 0-最大值。
/// |0-最大值。
/// </summary>
Default,
/// <summary>
/// minimum - maximum.
/// 最小值-最大值。
/// |最小值-最大值。
/// </summary>
MinMax,
/// <summary>
/// Customize the minimum and maximum.
/// 自定义最小值最大值。
/// |自定义最小值最大值。
/// </summary>
Custom
}

View File

@@ -19,17 +19,17 @@ namespace XCharts.Runtime
{
/// <summary>
/// to fill between axis line to data.
/// 填充坐标轴轴线到数据间的区域。
/// |填充坐标轴轴线到数据间的区域。
/// </summary>
Auto,
/// <summary>
/// to fill between min axis value (when not inverse) to data.
/// 填充坐标轴底部到数据间的区域。
/// |填充坐标轴底部到数据间的区域。
/// </summary>
Start,
/// <summary>
/// to fill between max axis value (when not inverse) to data.
/// 填充坐标轴顶部到数据间的区域。
/// |填充坐标轴顶部到数据间的区域。
/// </summary>
End
}

View File

@@ -19,52 +19,52 @@ namespace XCharts.Runtime
{
/// <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 bottom of symbol.
/// 图形标志的底部。
/// |图形标志的底部。
/// </summary>
Bottom,
/// <summary>
/// the left of symbol.
/// 图形标志的左边。
/// |图形标志的左边。
/// </summary>
Left,
/// <summary>
/// the right of symbol.
/// 图形标志的右边。
/// |图形标志的右边。
/// </summary>
Right,
/// <summary>
/// the start of line.
/// 线的起始点。
/// |线的起始点。
/// </summary>
Start,
/// <summary>
/// the middle of line.
/// 线的中点。
/// |线的中点。
/// </summary>
Middle,
/// <summary>
/// the end of line.
/// 线的结束点。
/// |线的结束点。
/// </summary>
End
}

View File

@@ -18,35 +18,31 @@ namespace XCharts.Runtime
/// <summary>
/// Generally dataZoom component zoom or roam coordinate system through data filtering
/// and set the windows of axes internally.
/// |Its behaviours vary according to filtering mode settings.
/// |
/// dataZoom 的运行原理是通过 数据过滤 来达到 数据窗口缩放 的效果。数据过滤模式的设置不同,效果也不同。
/// Its behaviours vary according to filtering mode settings.
/// |dataZoom 的运行原理是通过 数据过滤 来达到 数据窗口缩放 的效果。数据过滤模式的设置不同,效果也不同。
/// </summary>
public enum FilterMode
{
/// <summary>
/// data that outside the window will be filtered, which may lead to some changes of windows of other axes.
/// For each data item, it will be filtered if one of the relevant dimensions is out of the window.
///
/// 当前数据窗口外的数据,被 过滤掉。即 会 影响其他轴的数据范围。每个数据项,只要有一个维度在数据窗口外,整个数据项就会被过滤掉。
/// |当前数据窗口外的数据,被 过滤掉。即 会 影响其他轴的数据范围。每个数据项,只要有一个维度在数据窗口外,整个数据项就会被过滤掉。
/// </summary>
Filter,
/// <summary>
/// data that outside the window will be filtered, which may lead to some changes of windows of other axes.
/// For each data item, it will be filtered only if all of the relevant dimensions are out of the same side of the window.
///
/// 当前数据窗口外的数据,被 过滤掉。即 会 影响其他轴的数据范围。每个数据项,只有当全部维度都在数据窗口同侧外部,整个数据项才会被过滤掉。
/// |当前数据窗口外的数据,被 过滤掉。即 会 影响其他轴的数据范围。每个数据项,只有当全部维度都在数据窗口同侧外部,整个数据项才会被过滤掉。
/// </summary>
WeakFilter,
/// <summary>
/// data that outside the window will be set to NaN, which will not lead to changes of windows of other axes.
///
/// 当前数据窗口外的数据,被 设置为空。即 不会 影响其他轴的数据范围。
/// |当前数据窗口外的数据,被 设置为空。即 不会 影响其他轴的数据范围。
/// </summary>
Empty,
/// <summary>
/// Do not filter data.
/// 不过滤数据,只改变数轴范围。
/// |不过滤数据,只改变数轴范围。
/// </summary>
None
}
@@ -57,7 +53,8 @@ namespace XCharts.Runtime
{
//Value,
/// <summary>
/// percent value. 百分比
/// percent value.
/// |百分比。
/// </summary>
Percent
}
@@ -137,8 +134,7 @@ namespace XCharts.Runtime
/// Whether built-in support is supported.
/// |Built into the coordinate system to allow the user to zoom in and out of the coordinate system by mouse dragging,
/// mouse wheel, finger swiping (on the touch screen).
/// |
/// 是否支持内置。内置于坐标系中,使用户可以在坐标系上通过鼠标拖拽、鼠标滚轮、手指滑动(触屏上)来缩放或漫游坐标系。
/// |是否支持内置。内置于坐标系中,使用户可以在坐标系上通过鼠标拖拽、鼠标滚轮、手指滑动(触屏上)来缩放或漫游坐标系。
/// </summary>
public bool supportInside
{
@@ -180,8 +176,7 @@ namespace XCharts.Runtime
}
/// <summary>
/// Whether to show data shadow, to indicate the data tendency in brief.
/// |default:true
/// 是否显示数据阴影。数据阴影可以简单地反应数据走势。
/// |是否显示数据阴影。数据阴影可以简单地反应数据走势。
/// </summary>
public bool showDataShadow
{
@@ -191,7 +186,6 @@ namespace XCharts.Runtime
/// <summary>
/// Whether to show detail, that is, show the detailed data information when dragging.
/// |是否显示detail即拖拽时候显示详细数值信息。
/// [default: false]
/// </summary>
public bool showDetail
{
@@ -200,8 +194,7 @@ namespace XCharts.Runtime
}
/// <summary>
/// Specify whether to lock the size of window (selected area).
/// |default:false
/// 是否锁定选择区域(或叫做数据窗口)的大小。
/// |是否锁定选择区域(或叫做数据窗口)的大小。
/// 如果设置为 true 则锁定选择区域的大小,也就是说,只能平移,不能缩放。
/// </summary>
public bool zoomLock
@@ -211,8 +204,7 @@ namespace XCharts.Runtime
}
/// <summary>
/// Whether to show data shadow in dataZoom-silder component, to indicate the data tendency in brief.
/// |default:true
/// 拖动时,是否实时更新系列的视图。如果设置为 false则只在拖拽结束的时候更新。默认为true暂不支持修改。
/// |拖动时,是否实时更新系列的视图。如果设置为 false则只在拖拽结束的时候更新。默认为true暂不支持修改。
/// </summary>
public bool realtime { get { return true; } }
/// <summary>
@@ -253,9 +245,8 @@ namespace XCharts.Runtime
}
/// <summary>
/// Distance between dataZoom component and the bottom side of the container.
/// |bottom value is a instant pixel value like 10 or float value [0-1].
/// |default:10
/// 组件离容器下侧的距离。
/// bottom value is a instant pixel value like 10 or float value [0-1].
/// |组件离容器下侧的距离。
/// </summary>
public float bottom
{
@@ -264,9 +255,8 @@ namespace XCharts.Runtime
}
/// <summary>
/// Distance between dataZoom component and the top side of the container.
/// |top value is a instant pixel value like 10 or float value [0-1].
/// |default:10
/// 组件离容器上侧的距离。
/// top value is a instant pixel value like 10 or float value [0-1].
/// |组件离容器上侧的距离。
/// </summary>
public float top
{
@@ -275,9 +265,8 @@ namespace XCharts.Runtime
}
/// <summary>
/// Distance between dataZoom component and the left side of the container.
/// |left value is a instant pixel value like 10 or float value [0-1].
/// |default:10
/// 组件离容器左侧的距离。
/// left value is a instant pixel value like 10 or float value [0-1].
/// |组件离容器左侧的距离。
/// </summary>
public float left
{
@@ -286,9 +275,8 @@ namespace XCharts.Runtime
}
/// <summary>
/// Distance between dataZoom component and the right side of the container.
/// |right value is a instant pixel value like 10 or float value [0-1].
/// |default:10
/// 组件离容器右侧的距离。
/// right value is a instant pixel value like 10 or float value [0-1].
/// |组件离容器右侧的距离。
/// </summary>
public float right
{
@@ -297,7 +285,6 @@ namespace XCharts.Runtime
}
/// <summary>
/// Use absolute value or percent value in DataZoom.start and DataZoom.end.
/// |default:RangeMode.Percent.
/// |取绝对值还是百分比。
/// </summary>
public RangeMode rangeMode
@@ -307,7 +294,6 @@ namespace XCharts.Runtime
}
/// <summary>
/// The start percentage of the window out of the data extent, in the range of 0 ~ 100.
/// |[default:30].
/// |数据窗口范围的起始百分比。范围是0 ~ 100。
/// </summary>
public float start
@@ -317,7 +303,6 @@ namespace XCharts.Runtime
}
/// <summary>
/// The end percentage of the window out of the data extent, in the range of 0 ~ 100.
/// |default:70
/// 数据窗口范围的结束百分比。范围是0 ~ 100。
/// </summary>
public float end
@@ -336,22 +321,19 @@ namespace XCharts.Runtime
}
/// <summary>
/// The sensitivity of dataZoom scroll.
/// |The larger the number, the more sensitive it is.
/// |default:10
/// 缩放区域组件的敏感度。值越高每次缩放所代表的数据越多。
/// The larger the number, the more sensitive it is.
/// |缩放区域组件的敏感度。值越高每次缩放所代表的数据越多。
/// </summary>
public float scrollSensitivity
{
get { return m_ScrollSensitivity; }
set { if (PropertyUtil.SetStruct(ref m_ScrollSensitivity, value)) SetVerticesDirty(); }
}
/// <summary>
/// Specify whether the layout of dataZoom component is horizontal or vertical. What's more,
/// it indicates whether the horizontal axis or vertical axis is controlled by default in catesian coordinate system.
/// |布局方式是横还是竖。不仅是布局方式,对于直角坐标系而言,也决定了,缺省情况控制横向数轴还是纵向数轴。
/// </summary>
/// <value></value>
public Orient orient
{
get { return m_Orient; }

View File

@@ -31,12 +31,12 @@ namespace XCharts.Runtime
{
/// <summary>
/// Display at the vertex.
/// 显示在顶点处。
/// |显示在顶点处。
/// </summary>
Vertice,
/// <summary>
/// Display at the middle of line.
/// 显示在两者之间。
/// |显示在两者之间。
/// </summary>
Between,
}
@@ -54,27 +54,27 @@ namespace XCharts.Runtime
/// <summary>
/// The name of indicator.
/// 指示器名称。
/// |指示器名称。
/// </summary>
public string name { get { return FormatterHelper.TrimAndReplaceLine(m_Name); } set { m_Name = value; } }
/// <summary>
/// The maximum value of indicator, with default value of 0, but we recommend to set it manually.
/// 指示器的最大值,默认为 0 无限制。
/// |指示器的最大值,默认为 0 无限制。
/// </summary>
public double max { get { return m_Max; } set { m_Max = value; } }
/// <summary>
/// The minimum value of indicator, with default value of 0.
/// 指示器的最小值,默认为 0 无限制。
/// |指示器的最小值,默认为 0 无限制。
/// </summary>
public double min { get { return m_Min; } set { m_Min = value; } }
/// <summary>
/// the text conponent of indicator.
/// 指示器的文本组件。
/// |指示器的文本组件。
/// </summary>
public Text text { get; set; }
/// <summary>
/// Normal range. When the value is outside this range, the display color is automatically changed.
/// 正常值范围。当数值不在这个范围时,会自动变更显示颜色。
/// |正常值范围。当数值不在这个范围时,会自动变更显示颜色。
/// </summary>
public double[] range
{

View File

@@ -23,22 +23,22 @@ namespace XCharts.Runtime
{
/// <summary>
/// line indicator.
/// 直线指示器
/// |直线指示器
/// </summary>
Line,
/// <summary>
/// shadow crosshair indicator.
/// 阴影指示器
/// |阴影指示器
/// </summary>
Shadow,
/// <summary>
/// no indicator displayed.
/// 无指示器
/// |无指示器
/// </summary>
None,
/// <summary>
/// crosshair indicator, which is actually the shortcut of enable two axisPointers of two orthometric axes.
/// 十字准星指示器。坐标轴显示Label和交叉线。
/// |十字准星指示器。坐标轴显示Label和交叉线。
/// </summary>
Corss
}
@@ -47,17 +47,17 @@ namespace XCharts.Runtime
{
/// <summary>
/// Triggered by data item, which is mainly used for charts that don't have a category axis like scatter charts or pie charts.
/// 数据项图形触发,主要在散点图,饼图等无类目轴的图表中使用。
/// |数据项图形触发,主要在散点图,饼图等无类目轴的图表中使用。
/// </summary>
Item,
/// <summary>
/// Triggered by axes, which is mainly used for charts that have category axes, like bar charts or line charts.
/// 坐标轴触发,主要在柱状图,折线图等会使用类目轴的图表中使用。
/// |坐标轴触发,主要在柱状图,折线图等会使用类目轴的图表中使用。
/// </summary>
Axis,
/// <summary>
/// Trigger nothing.
/// 什么都不触发。
/// |什么都不触发。
/// </summary>
None
}
@@ -132,41 +132,41 @@ namespace XCharts.Runtime
}
/// <summary>
/// The string template formatter for the tooltip title content. Support for wrapping lines with \n.
/// |The placeholder {I} can be set separately to indicate that the title is ignored and not displayed.
/// |Template variables are {.}, {a}, {b}, {c}, {d}.
/// |{.} is the dot of the corresponding color of a Serie that is currently indicated or whose index is 0.
/// |{a} is the series name of the serie that is currently indicated or whose index is 0.
/// |{b} is the name of the data item serieData that is currently indicated or whose index is 0, or a category value (such as the X-axis of a line chart).
/// |{c} is the value of a Y-dimension (dimesion is 1) from a Serie that is currently indicated or whose index is 0.
/// |{d} is the percentage value of Y-dimensions (dimesion is 1) from serie that is currently indicated or whose index is 0, with no % sign.
/// |{e} is the name of the data item serieData that is currently indicated or whose index is 0.
/// |{.1} represents a dot from serie corresponding color that specifies index as 1.
/// |1 in {a1}, {b1}, {c1} represents a serie that specifies an index of 1.
/// |{c1:2} represents the third data from serie's current indication data item indexed to 1 (a data item has multiple data, index 2 represents the third data).
/// |{c1:2-2} represents the third data item from serie's third data item indexed to 1 (i.e., which data item must be specified to specify).
/// |{d1:2: F2} indicates that a formatted string with a value specified separately is F2 (numericFormatter is used when numericFormatter is not specified).
/// |{d:0.##} indicates that a formatted string with a value specified separately is 0.## (used for percentage, reserved 2 valid digits while avoiding the situation similar to "100.00%" when using f2 ).
/// |Example: "{a}, {c}", "{a1}, {c1: f1}", "{a1}, {c1:0: f1}", "{a1} : {c1:1-1: f1}"
/// 提示框标题内容的字符串模版格式器。支持用 \n 换行。可以单独设置占位符{i}表示忽略不显示title。
/// 模板变量有{.}、{a}、{b}、{c}、{d}、{e}。
/// {.}为当前所指示或index为0的serie的对应颜色的圆点。
/// {a}为当前所指示或index为0的serie的系列名name。
/// {b}为当前所指示或index为0的serie的数据项serieData的name或者类目值如折线图的X轴
/// {c}为当前所指示或index为0的serie的y维dimesion为1的数值。
/// {d}为当前所指示或index为0的serie的y维dimesion为1百分比值注意不带%号。
/// {e}为当前所指示或index为0的serie的数据项serieData的name。
/// {.1}表示指定index为1的serie对应颜色的圆点。
/// {a1}、{b1}、{c1}中的1表示指定index为1的serie。
/// {c1:2}表示索引为1的serie的当前指示数据项的第3个数据一个数据项有多个数据index为2表示第3个数据
/// {c1:2-2}表示索引为1的serie的第3个数据项的第3个数据也就是要指定第几个数据项时必须要指定第几个数据
/// {d1:2:f2}表示单独指定了数值的格式化字符串为f2不指定时用numericFormatter
/// {d:0.##} 表示单独指定了数值的格式化字符串为 0.## 用于百分比保留2位有效数同时又能避免使用 f2 而出现的类似于"100.00%"的情况 )。
/// The placeholder {I} can be set separately to indicate that the title is ignored and not displayed.
/// Template variables are {.}, {a}, {b}, {c}, {d}.</br>
/// {.} is the dot of the corresponding color of a Serie that is currently indicated or whose index is 0.</br>
/// {a} is the series name of the serie that is currently indicated or whose index is 0.</br>
/// {b} is the name of the data item serieData that is currently indicated or whose index is 0, or a category value (such as the X-axis of a line chart).</br>
/// {c} is the value of a Y-dimension (dimesion is 1) from a Serie that is currently indicated or whose index is 0.</br>
/// {d} is the percentage value of Y-dimensions (dimesion is 1) from serie that is currently indicated or whose index is 0, with no % sign.</br>
/// {e} is the name of the data item serieData that is currently indicated or whose index is 0.</br>
/// {.1} represents a dot from serie corresponding color that specifies index as 1.</br>
/// 1 in {a1}, {b1}, {c1} represents a serie that specifies an index of 1.</br>
/// {c1:2} represents the third data from serie's current indication data item indexed to 1 (a data item has multiple data, index 2 represents the third data).</br>
/// {c1:2-2} represents the third data item from serie's third data item indexed to 1 (i.e., which data item must be specified to specify).</br>
/// {d1:2: F2} indicates that a formatted string with a value specified separately is F2 (numericFormatter is used when numericFormatter is not specified).</br>
/// {d:0.##} indicates that a formatted string with a value specified separately is 0.## (used for percentage, reserved 2 valid digits while avoiding the situation similar to "100.00%" when using f2 ).</br>
/// Example: "{a}, {c}", "{a1}, {c1: f1}", "{a1}, {c1:0: f1}", "{a1} : {c1:1-1: f1}"</br>
/// |提示框标题内容的字符串模版格式器。支持用 \n 换行。可以单独设置占位符{i}表示忽略不显示title。</br>
/// 模板变量有{.}、{a}、{b}、{c}、{d}、{e}。</br>
/// {.}为当前所指示或index为0的serie的对应颜色的圆点。</br>
/// {a}为当前所指示或index为0的serie的系列名name。</br>
/// {b}为当前所指示或index为0的serie的数据项serieData的name或者类目值如折线图的X轴</br>
/// {c}为当前所指示或index为0的serie的y维dimesion为1的数值。</br>
/// {d}为当前所指示或index为0的serie的y维dimesion为1百分比值注意不带%号。</br>
/// {e}为当前所指示或index为0的serie的数据项serieData的name。</br>
/// {.1}表示指定index为1的serie对应颜色的圆点。</br>
/// {a1}、{b1}、{c1}中的1表示指定index为1的serie。</br>
/// {c1:2}表示索引为1的serie的当前指示数据项的第3个数据一个数据项有多个数据index为2表示第3个数据</br>
/// {c1:2-2}表示索引为1的serie的第3个数据项的第3个数据也就是要指定第几个数据项时必须要指定第几个数据</br>
/// {d1:2:f2}表示单独指定了数值的格式化字符串为f2不指定时用numericFormatter</br>
/// {d:0.##} 表示单独指定了数值的格式化字符串为 0.## 用于百分比保留2位有效数同时又能避免使用 f2 而出现的类似于"100.00%"的情况 )。</br>
/// 示例:"{a}:{c}"、"{a1}:{c1:f1}"、"{a1}:{c1:0:f1}"、"{a1}:{c1:1-1:f1}"
/// </summary>
public string titleFormatter { get { return m_TitleFormatter; } set { m_TitleFormatter = value; } }
/// <summary>
/// a string template formatter for a single Serie or data item content. Support for wrapping lines with \n.
/// |When formatter is not null, use formatter first, otherwise use itemFormatter.
/// When formatter is not null, use formatter first, otherwise use itemFormatter.
/// |提示框单个serie或数据项内容的字符串模版格式器。支持用 \n 换行。当formatter不为空时优先使用formatter否则使用itemFormatter。
/// </summary>
public string itemFormatter { get { return m_ItemFormatter; } set { m_ItemFormatter = value; } }
@@ -197,7 +197,7 @@ namespace XCharts.Runtime
public float minHeight { get { return m_MinHeight; } set { m_MinHeight = value; } }
/// <summary>
/// Standard numeric format string. Used to format numeric values to display as strings.
/// |Using 'Axx' form: 'A' is the single character of the format specifier, supporting 'C' currency,
/// Using 'Axx' form: 'A' is the single character of the format specifier, supporting 'C' currency,
/// 'D' decimal, 'E' exponent, 'F' number of vertices, 'G' regular, 'N' digits, 'P' percentage,
/// 'R' round tripping, 'X' hex etc. 'XX' is the precision specification, from '0' - '99'.
/// |标准数字格式字符串。用于将数值格式化显示为字符串。
@@ -247,7 +247,7 @@ namespace XCharts.Runtime
public bool alwayShowContent { get { return m_AlwayShowContent; } set { m_AlwayShowContent = value; } }
/// <summary>
/// Whether to show the tooltip floating layer, whose default value is true.
/// |It should be configurated to be false, if you only need tooltip to trigger the event or show the axisPointer without content.
/// It should be configurated to be false, if you only need tooltip to trigger the event or show the axisPointer without content.
/// |是否显示提示框浮层默认显示。只需tooltip触发事件或显示axisPointer而不需要显示内容时可配置该项为false。
/// </summary>
public bool showContent { get { return m_ShowContent; } set { m_ShowContent = value; } }