SmartLabelStyle Класс
Определение
Важно!
Некоторые сведения относятся к предварительной версии продукта, в которую до выпуска могут быть внесены существенные изменения. Майкрософт не предоставляет никаких гарантий, явных или подразумеваемых, относительно приведенных здесь сведений.
Предоставляет методы и свойства, используемые для интеллектуального размещения метки точки данных на основе правил для устранения проблем с перекрывающимися метками точки данных.
public ref class SmartLabelStyle
[System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataVisualization.Charting.NoNameExpandableObjectConverter))]
public class SmartLabelStyle
[<System.ComponentModel.TypeConverter(typeof(System.Web.UI.DataVisualization.Charting.NoNameExpandableObjectConverter))>]
type SmartLabelStyle = class
Public Class SmartLabelStyle
- Наследование
-
SmartLabelStyle
- Производный
- Атрибуты
Примеры
Imports System.Web.UI.DataVisualization.Charting
Private Function SetSmartLabelsOptions()
' Enabling the SmartLabels™ attribute.
Chart1.Series("Series1").SmartLabels.Enabled = true
' Set the callout style.
Chart1.Series("Series1").SmartLabels.CalloutStyle = LabelCalloutStyle.Underlined
' Set the callout line color.
Chart1.Series("Series1").SmartLabels.CalloutLineColor = Color.Goldenrod;
' Set the callout line style.
Chart1.Series("Series1").SmartLabels.CalloutLineStyle = ChartDashStyle.Dash
' Set the callout line width.
Chart1.Series("Series1").SmartLabels.CalloutLineWidth = 3
' Set the callout line anchor cap.
Chart1.Series("Series1").SmartLabels.CalloutLineAnchorCap = LineAnchorCap.Arrow
End Function
using System.Web.UI.DataVisualization.Charting
private void SetSmartLabelsOptions()
{
// Enabling the SmartLabels™ attribute.
Chart1.Series["Series1"].SmartLabels.Enabled = true;
// Set the callout style.
Chart1.Series["Series1"].SmartLabels.CalloutStyle = LabelCalloutStyle.Underlined;
// Set the callout line color.
Chart1.Series["Series1"].SmartLabels.CalloutLineColor = Color.Goldenrod;
// Set the callout line style.
Chart1.Series["Series1"].SmartLabels.CalloutLineStyle = ChartDashStyle.Dash;
// Set the callout line width.
Chart1.Series["Series1"].SmartLabels.CalloutLineWidth = 3;
// Set the callout line anchor cap.
Chart1.Series["Series1"].SmartLabels.CalloutLineAnchorCap = LineAnchorCap.Arrow;
}
Комментарии
Если смарт-метки включены, диаграмма перемещает перекрывающиеся метки точек данных на основе набора пользовательских правил.
Линии выноски будут вырисовываться для связывания метки с точкой данных. Визуальные атрибуты строки выноски можно контролировать. К этим визуальным атрибутам относятся цвет, стиль линии и ширина линии. CalloutLineAnchorCapStyle Свойства CalloutStyle управляют украшением, такими как стрелки, которые отображаются в конце строки выноски.
Свойство CalloutLineColor может быть задано для любого Color объекта. Если задать цвет линии выноски, вы также автоматически установите цвет CalloutLineAnchorCapStyle и украсить, определенное параметром CalloutStyle.
Свойство CalloutLineWidth определяет ширину пикселя строки выноски. Использование этого свойства также будет масштабировать украски CalloutLineAnchorCapStyle и .CalloutStyle
Перемещение смарт-меток можно контролировать с помощью нескольких свойств, связанных с движением. Они определяют правила перемещения по направлению, расстоянию и разрешено ли метка точки данных оставить область построения. Правила перемещения по умолчанию обычно устраняют большинство проблем. Определяет MaxMovingDistance значение, указывающее максимальное расстояние в пикселях от точки данных, которую могут перемещать метки точек данных в случае перекрытия. Свойство MinMovingDistance определяет значение, указывающее минимальное расстояние в пикселях от точки данных, которую метки точек данных будут перемещены в случае перекрытия. Если метка точки данных должна быть перемещена, метка будет перемещена по крайней мере по количеству пикселей.
Свойство IsOverlappedHidden указывает, скрыты ли метки при невозможности устранения перекрывающихся проблем.
IsOverlappedHidden Если свойство равноtrue, а точка данных не может быть нарисована в пределах области, указанной MinMovingDistance и MaxMovingDistance в направлениях, разрешенныхMovingDirection, метка точки данных не будет нарисована.
Свойство MovingDirection определяет направления, в которых можно переместить метку точки данных. Это свойство принимает одно LabelAlignmentStyles значение или побитовое значение из нескольких LabelAlignmentStyles значений. По умолчанию используется побитовое значение ИЛИ всех значений, чтобы разрешить перепозицию во всех LabelAlignmentStyles возможных направлениях, кроме центра точки данных.
Смарт-метки не поддерживаются для следующих типов диаграмм:
Линейчатые диаграммы: линейчатые диаграммы с сотнями процентов.
Фигурные диаграммы: круговая, кольцевая, полярная и радиолокационная диаграммы.
Диаграммы диапазона: диапазон, столбец диапазона и линейчатые диаграммы диапазона.
Диаграммы с областями с накоплением: сложенные области и сотни процентов стека областных диаграмм.
Конструкторы
| Имя | Описание |
|---|---|
| SmartLabelStyle() |
Инициализирует новый экземпляр класса SmartLabelStyle. |
Свойства
| Имя | Описание |
|---|---|
| AllowOutsidePlotArea |
Возвращает или задает флаг, указывающий, может ли SmartLabelStyle объект быть нарисован за пределами области построения. |
| CalloutBackColor |
Возвращает или задает цвет фона выноски метки. |
| CalloutLineAnchorCapStyle |
Возвращает или задает стиль привязки строки выноски метки. |
| CalloutLineColor |
Возвращает или задает цвет строки выноски метки. |
| CalloutLineDashStyle |
Возвращает или задает стиль строки выноски метки. |
| CalloutLineWidth |
Возвращает или задает ширину строки выноски метки. |
| CalloutStyle |
Возвращает или задает стиль выноски для объекта с изменением SmartLabelStyle положения. |
| Enabled |
Получает или задает флаг, указывающий, включен ли SmartLabelStyle алгоритм. |
| IsMarkerOverlappingAllowed |
Возвращает или задает флаг, указывающий, могут ли метки точек перекрывать маркер точки. |
| IsOverlappedHidden |
Возвращает или задает флаг, указывающий, будут ли перекрывающиеся метки, которые не могут быть перепозиционированы. |
| MaxMovingDistance |
Возвращает или задает максимальное расстояние (в пикселях), которое перекрывающийся SmartLabelStyle объект можно переместить из маркера. |
| MinMovingDistance |
Возвращает или задает минимальное расстояние (в пикселях), которое перекрывающийся SmartLabelStyle объект можно переместить из маркера. |
| MovingDirection |
Возвращает или задает направления, в которых разрешено перемещать перекрывающийся SmartLabelStyle объект. |
Методы
| Имя | Описание |
|---|---|
| Equals(Object) |
Определяет, равен ли указанный объект текущему объекту. (Унаследовано от Object) |
| GetHashCode() |
Служит хэш-функцией по умолчанию. (Унаследовано от Object) |
| GetType() |
Возвращает Type текущего экземпляра. (Унаследовано от Object) |
| MemberwiseClone() |
Создает неглубокую копию текущей Object. (Унаследовано от Object) |
| ToString() |
Возвращает строку, представляющую текущий объект. (Унаследовано от Object) |