Legend Класс

Определение

public ref class Legend : System::Windows::Forms::DataVisualization::Charting::ChartNamedElement

public class Legend : System.Windows.Forms.DataVisualization.Charting.ChartNamedElement

type Legend = class
    inherit ChartNamedElement

Public Class Legend
Inherits ChartNamedElement

Наследование

Object

ChartElement

ChartNamedElement

Legend

Комментарии

Класс Legend инкапсулирует все функциональные возможности условных Chart обозначений элемента управления и предоставляется с помощью Legends свойства коллекции корневого Chart объекта.

Для изображения диаграммы может быть любое количество условных обозначений.

Условные обозначения могут:

• Закрепление и выравнивание.

• Отображается внутри или за пределами области диаграммы.

• Автоматически помещается их содержимое.

• Используйте стандартный стиль, например строку, столбец или таблицу.

• Используйте штриховки, градиентные цвета и фоновые изображения.

• Размер и размещение в любом месте изображения диаграммы.

Элементы условных обозначений LegendItem представлены объектом и являются элементами по умолчанию или пользовательскими. Пользовательские элементы не связаны с данными и могут быть добавлены, удалены и изменены с помощью CustomItems свойства.

Элементы по умолчанию по умолчанию автоматически добавляются в условные обозначения и являются именами отображаемых точек данных для кольцевых и круговых диаграмм.

Для всех других типов диаграмм элементы по умолчанию — это имена последовательности данных. У каждой серии есть Legend свойство, определяющее имя условных обозначений, которые будут использоваться. Элемент условных обозначений не будет создан для ряда, если IsVisibleInLegend для свойства задано falseзначение . Текст для этих элементов по умолчанию можно изменить с помощью LegendText свойства. Это свойство позволит указать предопределенные ключевые слова, которые будут заменены соответствующими значениями во время выполнения.

Если у вас есть круговая диаграмма и вы задали свойство, он также задаст Label текст условных обозначений значением, заданным для меток. Если вы хотите задать для текста другое значение, можно задать LegendText свойство. В большинстве случаев необходимо задать LegendText для свойства значение "#AXISLABEL" или "#VALX".

Символы рядов условных обозначений — прямоугольники, точки или линии. Тип символа устанавливается автоматически диаграммой и зависит от типа диаграммы.

Текст условных обозначений по умолчанию по умолчанию имеет автоматический размер. Вы можете отключить автоматическое изменение размера текста условных обозначений IsTextAutoFit , отключив свойство. Если для этого свойства задано falseзначение, размер текста условных обозначений определяется свойством Size условных обозначений Font. IsTextAutoFit Если свойство включено, свойство определяет минимальный размер шрифта, AutoFitMinFontSize который может иметь элемент условных обозначений при изменении размера.

Свойство TextWrapThreshold определяет ограничение количества символов, которые можно отображать в одной строке, прежде чем текст упаковывается в другую строку. Если вы не хотите упаковывать текст в условные обозначения, задайте для свойства значение TextWrapThreshold нулю. По умолчанию, когда весь текст условных обозначений не помещается в условные обозначения, текст будет усечен. Вы можете задать условные TextWrapThreshold обозначения, чтобы получить текст для упаковки вместо усечения.

Если содержимое условных обозначений не может соответствовать заданному пространству, записи условных обозначений усечены. Отображается многоточие, указывающее, что есть больше записей, чем условные обозначения имеют место. Чтобы предотвратить усечение элементов условных обозначений, задайте положение и размер легенды с помощью Position свойства. При настройке позиции условных обозначений или размера диаграмма больше не может автоматически размещать элементы на диаграмме. В некоторых случаях для достижения требуемого внешнего вида необходимо вручную разместить другие элементы диаграммы.

Другим вариантом будет определение собственных столбцов ячеек вместо использования параметров условных обозначений по умолчанию.

Объект Legend имеет коллекцию CellColumn; каждый объект CellColumn представляет столбец в условных обозначениях. Столбец ячеек имеет MaximumWidth и MinimumWidth свойства, которые можно использовать для настройки размера столбцов.

Если условные обозначения содержат множество записей, InterlacedRows можно использовать для улучшения удобочитаемости. Если для этого свойства задано значение True, он будет отображать задний цвет, который можно задать с помощью InterlacedRowsColor свойства.

По умолчанию условные обозначения расположены в правом верхнем углу диаграммы. Эту позицию можно изменить с помощью Docking и Alignment свойств условных обозначений. Условные обозначения также могут быть связаны с областью диаграммы с помощью DockedToChartArea свойства. Это свойство указывает имя области диаграммы, для которой должна быть закреплена легенда. Кроме того, IsDockedInsideChartArea свойство можно использовать для отображения условных обозначений в области диаграммы.

Если IsDockedInsideChartArea задано значение False, MaximumAutoSize свойство определяет максимальный размер в процентах условных обозначений в доступной диаграмме при автоматическом расположении условных обозначений. Это свойство следует задать, если вы хотите настроить ширину или высоту условных обозначений после задания свойств закрепления.

Условные CustomizeLegend обозначения можно изменить с помощью события.