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 события .

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

Свойства

Методы

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