SaveDecoration(Xml: IXmlDomElement);
SaveDecoration(Xml: Prognoz.Platform.Interop.MsXml2.IXmlDomElemnt);
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 | Пример замены цветового оформления для всех рядов диаграммы