JS+
Усиленный язык сценариев для Windows
с возможностью встраивания
в ваши приложения
О языке JS+ Справочник Скачать JS+ DLL
Контакты
СПРАВОЧНИК ПО ЯЗЫКУ JS+ Содержание

TChartAxis

- компонент диаграммы TChart
Компонент TChart
Определяет ось компонента TChart.
Доступ к объекту
Доступ к объекту выполняется прямым обращением к свойству соответствующего типа.

Собственные свойства
Свойство Тип Описание
Ось
Axis TChartAxisPen перо, используемое для отрисовки оси
EndPosition Number сдвиг конечной позиции оси в единицах, определяемых значением свойства PositionUnits
ExactDateTime Boolean значение свойства Increment назначено из массива констант DateTimeStep
Increment Number шаг приращения между метками оси: положительное число, значение DateTime или значение из массива констант DateTimeStep (см. ниже) - в этом случае свойство ExactDateTime должно иметь значение true
Logarithmic Boolean рассматривать ось, как логарифмическую (значения свойств Minimum и Maximum должны быть больше 0)
LogarithmicBase Number логарифмическое основание, используемое для отображения меток (при значении свойства Logarithmic=true)
PositionPercent Number сдвиг начальной позиции оси в единицах, определяемых значением свойства PositionUnits
PositionUnits Enum единицы измерения, используемые свойствами EndPosition и PositionPercent, (см. ниже)
Title TChartTitle заголовок оси
TitleSize Number вертикальный (для горизонтальных осей) или горизонтальный (для вертикальных осей) отступ, выделяемый для отображения заголовка
ZPosition Number положение оси по глубине в процентах от общей глубины
Минимум и максимум
Automatic Boolean автоматически рассчитывать значения свойств Minimum и Maximum на основе серий, зависящих от оси
AutomaticMaximum Boolean автоматически рассчитывать значение свойства Maximum на основе серий, зависящих от оси
AutomaticMinimum Boolean автоматически рассчитывать значение свойства Minimum на основе серий, зависящих от оси
Inverted Boolean поменять местами назначение свойств Minimum и Maximum, при этом метки оси и точки связанных серий будут корректно перестроены
Maximum Number наибольшее значение, которое ось будет использовать для масштабирования значений точек серии
MaximumOffset Number отступ от конца оси до точки серии с максимальным значением
MaximumRound Boolean значение свойства Maximum, округленное до ближайшего целого
Minimum Number наименьшее значение, которое ось будет использовать для масштабирования значений точек серии
MinimumOffset Number отступ от начала оси до точки серии с минимальным значением
MinimumRound Boolean значение свойства Minimum, округленное до ближайшего целого
Деления
MinorTickLength Number длина дополнительных делений на оси (соответствующих дополнительным линиям), px
MinorTicks TChartPen перо, используемое для отрисовки дополнительных делений на оси
TickInnerLength Number длина внутренних делений на оси, px
TickLength Number длина основных делений на оси, px
Ticks TChartPen перо, используемое для отрисовки основных делений на оси
TicksInner TChartPen перо, используемое для отрисовки внутренних делений на оси
TickOnLabelsOnly Boolean выполнить отрисовку делений оси и сетки оси так, чтобы они совпадали в метках
Метки
AxisValuesFormat String строка форматирования, применяемая к меткам оси (если у связанной с осью серии свойство XValues.DateTime или YValues.DateTime имеет значение false);
значение по умолчанию: "#,##0.###"
DateTimeFormat String описатель строки форматирования DateTime C++Builder/Delphi, используемый для меток оси
Labels Boolean отображать метки осей
LabelsAlign Enum положение меток относительно оси (см. ниже)
LabelsAlternate Boolean расположить метки в "шахматном" порядке
LabelsAngle Number угол вращения в градусах, применяемый к меткам; возможные значения: 0, 45, 90, 180, 270 и 360
LabelsExponent Boolean способ отображения меток, представляющих числа в экспоненциальном формате (см. ниже)
LabelsFont TChartFont шрифт, используемый для отображения меток
LabelsMultiLine Boolean разрешить многострочные метки; для разделения текста метки на строки используется символ \n (код 13)
LabelsOnAxis Boolean разрешить отображение меток в минимальной и максимальной позициях
LabelsSeparation Number минимальное расстояние между метками в процентах
LabelsSize Number "принудительный" размер меток, px
LabelStyle Enum стиль отображения меток (см. ниже)
RoundFirstLabel Boolean округлять значения меток оси
Межосевая сетка
Grid TAxisGridPen перо, используемое для отрисовки межосевой сетки (линий между параллельными осями)
GridCentered Boolean располагать линии осевой сетки между осевыми метками
Дополнительные линии
MinorGrid TChartPen перо, используемое для отрисовки дополнительных линий (расположенных между линиями межосевой сетки)
MinorTickCount Number количество дополнительных линий (расположенных между линиями межосевой сетки)
Только чтение
Horizontal Boolean имеет значение true для горизонтальных осей
OtherSide Boolean имеет значение true для осей RightAxis или TopAxis

Свойство Increment
Значение Описание
Индексы массива DateTimeStep
dtOneMicroSecond 1 микросекунда
dtOneMillisecond 1 миллисекунда
dtOneSecond 1 секунда
dtFiveSeconds 5 секунд
dtTenSeconds 10 секунд
dtFifteenSeconds 15 секунд
dtThirtySeconds 30 секунд
dtOneMinute 1 минута
dtFiveMinutes 5 минут
dtTenMinutes 10 минут
dtFifteenMinutes 15 минут
dtThirtyMinutes 30 минут
dtOneHour 1 час
dtTwoHours 2 часа
dtSixHours 6 часов
dtTwelveHours 12 часов
dtOneDay 1 день
dtTwoDays 2 дня
dtThreeDays 3 дня
dtOneWeek 1 неделя
dtHalfMonth полмесяца
dtOneMonth 1 месяц
dtTwoMonths 2 месяца
dtThreeMonths 3 месяца
dtFourMonths 4 месяца
dtSixMonths 6 месяцев
dtOneYear 1 год
dtNone нет периода

Свойство PositionUnits
muPercent проценты от ширины (для горизонтальных осей) или высоты (для вертикальных осей) диаграммы
muPixels пиксели

Свойство LabelsAlign
Значение Описание
alaDefault по умолчанию
alaOpposite противоположное
alaCenter по центру оси

Свойство LabelsExponent
Значение Описание
true отобразить степень надстрочным шрифтом
false отобразить степень в научном формате

Свойство LabelStyle
Значение Описание
talAuto автоматическое отображение
talNone без метки
talValue на основе значений Minimum и Maximum
talMark с использованием значений и меток серии
talText с использованием меток серии

Стандартные свойства

Стандартные методы

Собственные события
Событие Описание
OnDrawLabel будет выполнена отрисовка метки оси

Стандартные события

Пример (JS+)
// Главная форма
frm=new TForm();
frm.Caption="JS+ - компонент диаграммы TChart TChartAxis";
frm.Width =900;
frm.Height=675;

// Строка состояния
stb=new TStatusBar(frm);
stb.SimpleText=" Пример компонента TChart";

// Панель
with (pnl=new TPanel(frm)) {
  BorderStyle=bsSingle;
  SetBounds(10,10,frm.ClientWidth-20,stb.Top-20);
  Color=clWhite;
}

// TChart
with (chr=new TChart(pnl)) {
  SetBounds(20,20,pnl.ClientWidth-30,pnl.ClientHeight-30);
  Color=0xFFFFE9.toTColor();
  AllowPanning=pmBoth;// Включить прокрутку
  Zoom.Allow=true;// Включить масштабирование
  Zoom.Pen.Color=clAqua;// Цвет рамки масштабирования

  // Отступы
  MarginTop=MarginRight=chr.MarginBottom=(MarginLeft=10)*2;

  // Верхний заголовок
  with (Title) {
    Caption="Динамика рынка";
    Font.Style=fsBold;
    // Тень от заголовка
    with (Font.Shadow) {
      Color=clLtGray;
      SmoothBlur=HorizSize=VertSize=2;
      Visible=true;
    }
    Visible=true;
  }

  // Нижний заголовок
  with (chr.Foot) {
    Caption="Учетный период";
    Visible=true;
  }
  
  // Рамка вокруг панели компонента
  with (Border) {
    Color=clGray;
    Visible=true;
  }

  // Тень от панели компонента
  with (Shadow) {
    Color=clGray;
    SmoothBlur=HorizSize=VertSize=5;
    Visible=true;
  }
}

// Задняя стена
with (chr.BackWall) {
  // Изображение на стене
  with (Picture) {
    Mode=pbmCustom;
    Left=20;
    LoadFromFile(JSPlus.HelpDir+"IMAGE\\TBitmap\\Image.bmp");
  }
  Visible=true;
}

// Левая ось
with (chr.LeftAxis) {
  Automatic=false;
  Maximum=8000;
  Grid.Color=clLtGray;
  Grid.Visible=true;
  with (Title) {
    Caption="Средняя цена";
    Font.Color=clRed;
  }
  Visible=true;
}

// Правая ось
with (chr.RightAxis) {
  Automatic=false;
  Maximum=50000;
  Visible=true;
  with (Title) {
    Caption="Количество предложений";
    Font.Color=clBlue;
  }
  Visible=true;
}

// Нижняя ось
chr.BottomAxis.Visible=true;

// Массив данных
Include(JSPlus.HelpDir+"DATA\\Chart.lst");

// График цены
srs=new TLineSeries(chr);
srs.Color=chr.LeftAxis.Title.Font.Color;
with (pnt=srs.Pointer) {
  Style=psCircle;
  HorizSize=VertSize=2;
  Frame.Visible=false;
  Visible=true;
}
srs.BeginUpdate();
for (i=0;i<data_lst.length;i++) {
  l=((a=data_lst[i].split("|")).length==3) ? a[2] : "";
  srs.AddXY(i,parseFloat(a[0]),l);
}
srs.EndUpdate();

// График количества предложений
srs=new TLineSeries(chr);
srs.Color=chr.RightAxis.Title.Font.Color;
srs.VertAxis=aRightAxis;
srs.Pointer.Assign(pnt);
for (i=0;i<data_lst.length;i++)
  srs.AddXY(i,parseFloat(data_lst[i].split("|")[1]));

frm.ShowModal();
Примечание
При использовании свойств Minimum и/или Maximum свойство Automatic (или AutomaticMinimum, AutomaticMaximum) должно иметь значение false.
Совместимость
C++ Builder/Delphi
См. также
JS+Руководство пользователя
Адрес этой страницы: http://jsplus.ru/MANUAL/JSPlus/Component/TChart/TChartAxis.htm
© 2024,