SmartLabelStyle Класс

Определение

Предоставляет методы и свойства для выполнения интеллектуального, основанного на правилах размещения подписей точек данных с целью устранения проблем с перекрытием подписей точек данных.Provides methods and properties used to perform intelligent, rule-based data point label positioning to resolve overlapping data point label issues.

public ref class SmartLabelStyle
[System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataVisualization.Charting.NoNameExpandableObjectConverter))]
public class SmartLabelStyle
[<System.ComponentModel.TypeConverter(typeof(System.Windows.Forms.DataVisualization.Charting.NoNameExpandableObjectConverter))>]
type SmartLabelStyle = class
Public Class SmartLabelStyle
Наследование
SmartLabelStyle
Производный
Атрибуты

Комментарии

Если смарт-метки включены, в диаграмме перемещается перекрывающиеся метки точек данных на основе набора определяемых пользователем правил.When smart labels are enabled, the chart repositions overlapping data point labels, based on a set of user-defined rules.

Линии выноски будут отображаться для связывания метки с ее точкой данных.Callout lines will be drawn to link the label with its data point. Можно управлять визуальными атрибутами линии выноски.The visual attributes of the callout line can be controlled. Эти визуальные атрибуты включают цвет, стиль линии и толщину линии.These visual attributes include color, line style, and line width. CalloutStyleСвойства и CalloutLineAnchorCapStyle управляют надстрочные знаки, такие как стрелки, которые отображаются в конце линии выноски.The CalloutStyle and CalloutLineAnchorCapStyle properties control the embellishments, such as arrowheads, that appear at the end of the callout line.

CalloutLineColorДля свойства можно задать любой Color объект.The CalloutLineColor property can be set to any Color object. Если задать цвет линии выноски, также будет автоматически задан цвет CalloutLineAnchorCapStyle и надстрочные знаки, определенные в CalloutStyle .If you set the color of the callout line, you will also automatically set the color of the CalloutLineAnchorCapStyle and the embellishment defined by the CalloutStyle.

CalloutLineWidthСвойство определяет ширину линии выноски в пикселях.The CalloutLineWidth property controls the pixel width of the callout line. При использовании этого свойства также будут масштабироваться надстрочные знаки CalloutLineAnchorCapStyle и CalloutStyle .Use of this property will also scale the embellishments of the CalloutLineAnchorCapStyle and the CalloutStyle.

Перемещением смарт-меток можно управлять с помощью нескольких свойств, связанных с движением.The movement of smart labels can be controlled through the use of several motion-related properties. Они определяют правила перемещения для направления, расстояния и возможность выхода метки точки данных из области построения.These define the rules of movement for the direction, distance and whether the data point label is allowed to leave the plotting area. Правила перемещения по умолчанию обычно устраняют большинство проблем.The default movement rules will normally resolve most issues. MaxMovingDistanceОпределяет значение, указывающее максимальное расстояние в пикселях от точки данных, на которое могут перемещаться метки точек данных, в случае перекрытия.The MaxMovingDistance defines a value that specifies the maximum distance in pixels from the data point that data point labels are allowed to be moved in case of overlapping. MinMovingDistanceСвойство определяет значение, указывающее минимальное расстояние в пикселях от точки данных, на которое будут перемещаться метки точек данных в случае перекрытия.The MinMovingDistance property defines a value that specifies the minimum distance in pixels from the data point that data point labels will be moved in case of overlapping. Если необходимо переместить метку точки данных, метка будет перемещена по крайней мере на указанное число пикселей.When a data point label needs to be repositioned, the label will be moved by at least the number of pixels specified.

IsOverlappedHiddenСвойство указывает, скрываются ли метки, если не удается разрешить перекрывающиеся проблемы.The IsOverlappedHidden property indicates whether the labels are hidden when overlapping issues cannot be resolved. Если IsOverlappedHidden свойство имеет значение true , а точка данных не может быть изображена в области, заданной с помощью MinMovingDistance MaxMovingDistance , и в направлениях, разрешенной параметром MovingDirection , то метка точки данных не будет отображаться.If the IsOverlappedHidden property is true, and the data point cannot be drawn within the area specified by MinMovingDistance and MaxMovingDistance in the directions allowed by MovingDirection, the data point label will not be drawn.

MovingDirectionСвойство определяет направления, в которых может быть перемещена метка точки данных.The MovingDirection property defines the direction(s) in which the data point label can be moved. Это свойство принимает одно LabelAlignmentStyles значение или побитовое или для нескольких LabelAlignmentStyles значений.This property accepts one LabelAlignmentStyles value or a bitwise-OR of multiple LabelAlignmentStyles values. Значение по умолчанию — побитовое или для всех LabelAlignmentStyles значений, чтобы разрешить изменение позиции во всех возможных направлениях, за исключением центра точки данных.The default is the bitwise-OR of all LabelAlignmentStyles values, to allow repositioning in all possible directions except to the center of the data point.

Смарт-метки не поддерживаются для следующих типов диаграмм:Smart labels are not supported for the following chart types:

  • Линейчатые диаграммы: линейчатые и нормированные линейчатые диаграммы с накоплением.Bar charts: bar and hundred-percent-stacked bar charts.

  • Фигурные диаграммы: круговые, кольцевые, полярные и лепестковые диаграммы.Shape charts: pie, doughnut, polar and radar charts.

  • Диаграммы диапазонов: диапазоны, гистограммы диапазонов и гистограммы диапазонов.Range charts: range, range column and range bar charts.

  • Диаграммы с областями с накоплением: область с накоплением и нормированные диаграммы с областями.Stacked area charts: stacked area and hundred-percent-stacked area charts.

Конструкторы

SmartLabelStyle()

Инициализирует новый экземпляр класса SmartLabelStyle.Initializes a new instance of the SmartLabelStyle class.

Свойства

AllowOutsidePlotArea

Получает или задает флаг, указывающий, может ли объект SmartLabelStyle быть отображен вне границ области построения.Gets or sets a flag that specifies whether a SmartLabelStyle object can be drawn outside the plotting area.

CalloutBackColor

Получает или задает цвет фона выноски подписи.Gets or sets the background color of the label callout.

CalloutLineAnchorCapStyle

Получает или задает стиль законцовки привязки для линии выноски подписи.Gets or sets the anchor cap style of the label callout line.

CalloutLineColor

Получает или задает цвет линии выноски подписи.Gets or sets the color of the label callout line.

CalloutLineDashStyle

Получает или задает стиль линии выноски подписи.Gets or sets the style of the label callout line.

CalloutLineWidth

Получает или задает толщину линии выноски подписи.Gets or sets the width of the label callout line.

CalloutStyle

Получает или задает стили выноски перемещаемого объекта SmartLabelStyle.Gets or sets the callout style of the repositioned SmartLabelStyle object.

Enabled

Получает или задает флаг, определяющий, включен ли алгоритм SmartLabelStyle.Gets or sets a flag that indicates whether a SmartLabelStyle algorithm is enabled.

IsMarkerOverlappingAllowed

Получает или задает флаг, определяющий, могут ли подписи точек данных перекрывать маркеры точек.Gets or sets a flag that specifies whether the point labels are allowed to overlap a point marker.

IsOverlappedHidden

Получает или задает флаг, определяющий, должны ли быть скрыты перекрытые подписи, которые невозможно переместить.Gets or sets a flag that indicates whether overlapped labels that cannot be repositioned will be hidden.

MaxMovingDistance

Получает или задает максимальное расстояние в пикселях, на которое перекрываемый объект SmartLabelStyle может быть отодвинут от маркера.Gets or sets the maximum distance, in pixels, that the overlapped SmartLabelStyle object can be moved from the marker.

MinMovingDistance

Получает или задает минимальное расстояние в пикселях, на которое перекрываемый объект SmartLabelStyle может быть отодвинут от маркера.Gets or sets the minimum distance, in pixels, that the overlapped SmartLabelStyle object can be moved from the marker.

MovingDirection

Получает или задает направления, в которых может быть перемещен перекрываемый объект SmartLabelStyle.Gets or sets the direction(s) in which the overlapped SmartLabelStyle object is allowed to be moved.

Методы

Equals(Object)

Определяет, равен ли указанный объект текущему объекту.Determines whether the specified object is equal to the current object.

(Унаследовано от Object)
GetHashCode()

Служит хэш-функцией по умолчанию.Serves as the default hash function.

(Унаследовано от Object)
GetType()

Возвращает объект Type для текущего экземпляра.Gets the Type of the current instance.

(Унаследовано от Object)
MemberwiseClone()

Создает неполную копию текущего объекта Object.Creates a shallow copy of the current Object.

(Унаследовано от Object)
ToString()

Возвращает строку, представляющую текущий объект.Returns a string that represents the current object.

(Унаследовано от Object)

Применяется к