IChart.SaveDecoration

Синтаксис

SaveDecoration(Xml: IXmlDomElement);

Параметры

Xml. Элемент xml-документа.

Описание

Метод SaveDecoration сохраняет пользовательский стиль оформления в xml-документ.

Комментарии

В XML документ сохраняются следующие настройки диаграммы:

Тег XML документа Свойство
Type Тип стиля (условный номер, числа 0, 1, 2 заняты стандартными системными стилями, использовать нельзя)
Name Строковое имя стиля (произвольное)
CommonChartProperties Общие настройки диаграммы
ChartAreaDecoration Оформление области диаграммы
GraphAreaDecoration Оформление области построения диаграммы
LegendDecoration Оформление легенды
ChartCaptionDecoration Оформление заголовка диаграммы
AxisXCaptionDecoration
AxisYCaptionDecoration
AxisYAdditionalCaptionDecoration		 Оформление заголовка оси диаграммы (X, Y, YSec - соответственно)
AxisXUnitCaptionDecoration
AxisYUnitCaptionDecoration
AxisYAdditionalUnitCaptionDecoration		 Оформление заголовка единиц измерения оси диаграммы (X, Y, YSec - соответственно)
AxisXDecoration
AxisYDecoration
AxisYAdditionalDecoration		 Оформление оси (X, Y, YSec - соответственно)
DefaultSerieDecoration Оформление по умолчанию новых рядов на диаграмме (вновь создаваемых рядов)
AxisLinePen Перо рисования линии оси и делений оси
AxisGridPen Перо рисования сетки по оси
NoDataFontColor Цвет текста имени ряда в легенде (если все значения ряда пустые)
FontColor Цвет текста имени ряда в легенде
Background Заливка фона элемента
Shadow Тень элемента
Direction Направление тени элемента
Теги свойств диаграммы
Smoothing Сглаживание диаграммы
RoundJoint Скругление углов столбиков гистограммы
GridVisible Видимость сетки области построения диаграммы
Теги свойств объекта фона диаграммы
BackgroundType Тип фона (0 – нет фона, 1 – сплошная заливка, 2 – градиент, 3 – рисунок, штриховка, 4 – глянцевая заливка)
MainColor Основной цвет для объекта фона
FirstColor Начальный цвет градиента
LastColor Конечный цвет градиента
GradientAngle Угол направления градиента
Теги свойств рисования
Color Цвет (формат ARGB, значение [0 - 255])
Pen Перо
Width Толщина пера
Alignment Выравнивание линии пера
EndCap, StartCap Фигуры в начале и конце линии
SolidPen Цвет пера
Font Шрифт
FontFamilyName Семейство шрифта
FontSize Размер шрифта
FontSizeUnit Единицы измерения шрифта
FontStyle Начертание шрифта
Brush Кисть
BrushType Тип кисти (0 – одноцветная, 1 – штриховая, 2 – текстурная, 3 – градиентная кисть по сложному контуру, 4 – линейная градиентная)
SolidBrushColor Цвет одноцветной кисти
StartColor Начальный цвет градиентной кисти
EndColor Конечный цвет градиентной кисти
NotImplemented Сохранение стилей не поддерживается для текстурных кистей (заливка фона элемента картинкой) и кисти типа GDI+ PathGradient
Теги свойств оформления новых серий
SeriePaletteCount Число уникальных базовых цветов (рекомендуется использовать значение по умолчанию 8)
ColorHuge* Hue, оттенок цвета в модели HSV (тег содержит опечатку, к сожалению сейчас уже не исправить, * - индекс цвета [0; SeriePaletteCount-1])
ColorSaturation* Насыщенность цвета в модели HSV (* - индекс цвета [0; SeriePaletteCount-1])
StartBrightColorValue
StartDarkColorValue		 Значение цвета в модели HSV для задания двух цветов фона ряда.
BarSerieBackgroundType Тип фона (см. выше), используемый по умолчанию для нового столбикового ряда.
SerieBackgroundType Тип фона (см. выше), используемый по умолчанию для нового ряда, кроме столбикового.
SerieBorderWidth Толщина пера рисования рамки вокруг нового ряда
SerieLineWidth Толщина пера рисования нового ряда (линейные ряды)
SerieNoDataLineWidth Толщина пера рисования нового ряда (линейные ряды), участки без данных
SerieNoDataLineDash Штриховка пера рисования нового линейного ряда, участки без данных

Примечание. У пера и кисти при сохранении стиля сохраняются и другие параметры, соответствующие параметрам объектов GDI+. Подробности следует смотреть в MSDN.

Пример

В рассматриваемом примере предполагается существование объекта Chart типа IChart.

Sub UserProc;
Var
    Chart: IChart;
    doc: IXmlDomDocument;
    element: IXmlDomElement;
    str: string = "<?xml version=""1.0"" encoding=""utf-8""?>" + #13 + #10 + "<test/>";
Begin
    doc := New DOMDocument40.Create;
    doc.loadXML(str);
    element := doc.documentElement;
    Chart.SaveDecoration(element);
    doc.save("c:\Temp\test.xml");
End Sub UserProc;

После выполнения примера будет выполнена сериализация пользовательского оформления диаграммы.

См. также:

IChart | Пример замены цветового оформления для всех рядов диаграммы