класс Aspose::Words::Drawing::Charts::ChartAxis

ChartAxis class

Представляет параметры оси диаграммы. Чтобы узнать больше, посетите статью документации Working with Charts.

class ChartAxis : public Aspose::Words::Drawing::Charts::Core::IDmlChartTitleHolder,
                  public Aspose::Words::Drawing::Core::Dml::IDmlExtensionListSource,
                  public Aspose::Words::Drawing::Charts::Core::INumberFormatProvider,
                  public Aspose::Words::Drawing::Charts::Core::IChartFormatSource

Методы

МетодОписание
get_AxisBetweenCategories()Получает или задает флаг, указывающий, пересекает ли ось значений ось категорий между категориями.
get_BaseTimeUnit()Возвращает или задает наименьшую единицу времени, отображаемую на оси временных категорий.
get_CategoryType()Получает или задает тип оси категорий.
get_Crosses()Указывает, как эта ось пересекает перпендикулярную ось.
get_CrossesAt()Указывает, где на перпендикулярной оси происходит пересечение оси.
get_DisplayUnit()Указывает значение масштабирования единиц отображения для оси значений.
get_Document()Возвращает документ, содержащий родительскую диаграмму.
get_Format()Обеспечивает доступ к форматированию линий оси и заливке меток делений.
get_HasMajorGridlines()Получает или задает флаг, указывающий, имеет ли ось основные линии сетки.
get_HasMinorGridlines()Получает или задает флаг, указывающий, имеет ли ось вспомогательные линии сетки.
get_Hidden()Получает или задает флаг, указывающий, скрыта ли эта ось.
get_MajorTickMark()Возвращает или задает основные деления.
get_MajorUnit()Возвращает или задает расстояние между основными делениями.
get_MajorUnitIsAuto()Получает или задает флаг, указывающий, следует ли использовать расстояние по умолчанию между основными делениями.
get_MajorUnitScale()Возвращает или задает значение масштаба для основных делений на оси временных категорий.
get_MinorTickMark()Возвращает или задает вспомогательные деления оси.
get_MinorUnit()Возвращает или задает расстояние между вспомогательными делениями.
get_MinorUnitIsAuto()Получает или задает флаг, указывающий, следует ли использовать расстояние по умолчанию между вспомогательными делениями.
get_MinorUnitScale()Возвращает или задает значение масштаба для вспомогательных делений на оси временных категорий.
get_NumberFormat()Возвращает объект ChartNumberFormat, позволяющий задавать числовые форматы для оси.
get_ReverseOrder()Возвращает или задает флаг, указывающий, должны ли значения оси отображаться в обратном порядке, т.е. от максимального к минимальному.
get_Scaling()Предоставляет доступ к параметрам масштабирования оси.
get_TickLabels()Предоставляет доступ к свойствам меток делений оси.
get_TickMarkSpacing()Получает или задает интервал, с которым рисуются деления.
get_Title()Предоставляет доступ к свойствам заголовка оси.
get_Type() constВозвращает тип оси.
GetType() const override
Is(const System::TypeInfo&) const override
set_AxisBetweenCategories(bool)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_AxisBetweenCategories.
set_BaseTimeUnit(Aspose::Words::Drawing::Charts::AxisTimeUnit)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_BaseTimeUnit.
set_CategoryType(Aspose::Words::Drawing::Charts::AxisCategoryType)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_CategoryType.
set_Crosses(Aspose::Words::Drawing::Charts::AxisCrosses)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_Crosses.
set_CrossesAt(double)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_CrossesAt.
set_HasMajorGridlines(bool)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_HasMajorGridlines.
set_HasMinorGridlines(bool)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_HasMinorGridlines.
set_Hidden(bool)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_Hidden.
set_MajorTickMark(Aspose::Words::Drawing::Charts::AxisTickMark)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_MajorTickMark.
set_MajorUnit(double)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_MajorUnit.
set_MajorUnitIsAuto(bool)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_MajorUnitIsAuto.
set_MajorUnitScale(Aspose::Words::Drawing::Charts::AxisTimeUnit)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_MajorUnitScale.
set_MinorTickMark(Aspose::Words::Drawing::Charts::AxisTickMark)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_MinorTickMark.
set_MinorUnit(double)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_MinorUnit.
set_MinorUnitIsAuto(bool)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_MinorUnitIsAuto.
set_MinorUnitScale(Aspose::Words::Drawing::Charts::AxisTimeUnit)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_MinorUnitScale.
set_ReverseOrder(bool)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_ReverseOrder.
set_TickMarkSpacing(int32_t)Сеттер для Aspose::Words::Drawing::Charts::ChartAxis::get_TickMarkSpacing.
static Type()

Примеры

Показывает, как вставить диаграмму и изменить внешний вид её осей.

auto doc = System::MakeObject<Aspose::Words::Document>();
auto builder = System::MakeObject<Aspose::Words::DocumentBuilder>(doc);

System::SharedPtr<Aspose::Words::Drawing::Shape> shape = builder->InsertChart(Aspose::Words::Drawing::Charts::ChartType::Column, 500, 300);
System::SharedPtr<Aspose::Words::Drawing::Charts::Chart> chart = shape->get_Chart();

// Очистите демонстрационную серию данных диаграммы, чтобы начать с чистой диаграммы.
chart->get_Series()->Clear();

// Вставьте серию диаграммы с категориями для оси X и соответствующими числовыми значениями для оси Y.
chart->get_Series()->Add(u"Aspose Test Series", System::MakeArray<System::String>({u"Word", u"PDF", u"Excel", u"GoogleDocs", u"Note"}), System::MakeArray<double>({640, 320, 280, 120, 150}));

// У осей диаграммы есть различные параметры, которые могут изменить их внешний вид,
// например, их направление, основные/второстепенные деления и метки.
System::SharedPtr<Aspose::Words::Drawing::Charts::ChartAxis> xAxis = chart->get_AxisX();
xAxis->set_CategoryType(Aspose::Words::Drawing::Charts::AxisCategoryType::Category);
xAxis->set_Crosses(Aspose::Words::Drawing::Charts::AxisCrosses::Minimum);
xAxis->set_ReverseOrder(false);
xAxis->set_MajorTickMark(Aspose::Words::Drawing::Charts::AxisTickMark::Inside);
xAxis->set_MinorTickMark(Aspose::Words::Drawing::Charts::AxisTickMark::Cross);
xAxis->set_MajorUnit(10.0);
xAxis->set_MinorUnit(15.0);
xAxis->get_TickLabels()->set_Offset(50);
xAxis->get_TickLabels()->set_Position(Aspose::Words::Drawing::Charts::AxisTickLabelPosition::Low);
xAxis->get_TickLabels()->set_IsAutoSpacing(false);
xAxis->set_TickMarkSpacing(1);

ASPOSE_ASSERT_EQ(doc, xAxis->get_Document());

System::SharedPtr<Aspose::Words::Drawing::Charts::ChartAxis> yAxis = chart->get_AxisY();
yAxis->set_CategoryType(Aspose::Words::Drawing::Charts::AxisCategoryType::Automatic);
yAxis->set_Crosses(Aspose::Words::Drawing::Charts::AxisCrosses::Maximum);
yAxis->set_ReverseOrder(true);
yAxis->set_MajorTickMark(Aspose::Words::Drawing::Charts::AxisTickMark::Inside);
yAxis->set_MinorTickMark(Aspose::Words::Drawing::Charts::AxisTickMark::Cross);
yAxis->set_MajorUnit(100.0);
yAxis->set_MinorUnit(20.0);
yAxis->get_TickLabels()->set_Position(Aspose::Words::Drawing::Charts::AxisTickLabelPosition::NextToAxis);
yAxis->get_TickLabels()->set_Alignment(Aspose::Words::ParagraphAlignment::Center);
yAxis->get_TickLabels()->get_Font()->set_Color(System::Drawing::Color::get_Red());
yAxis->get_TickLabels()->set_Spacing(1);

// У столбчатых диаграмм нет оси Z.
ASSERT_TRUE(System::TestTools::IsNull(chart->get_AxisZ()));

doc->Save(get_ArtifactsDir() + u"Charts.AxisProperties.docx");

См. также

Класс Aspose::Words::Drawing::Charts::Chart Aspose::Words::Drawing::Charts::ChartAxisCollection класс