在簡報中使用 C++ 自訂圖表座標軸

概觀

本文說明如何在 Aspose.Slides 中自訂圖表座標軸。它展示了如何取得實際座標軸值、在座標軸之間交換資料、隱藏折線圖的垂直或水平座標軸、變更類別座標軸類型、設定類別座標軸值的日期格式、旋轉座標軸標題、設定座標軸位置，以及在值座標軸上顯示單位標籤。

取得垂直座標軸的最大值

Aspose.Slides for C++ 允許您取得垂直座標軸的最小值與最大值。請依照以下步驟操作：

1. 建立 Presentation 類別的執行個體。
2. 存取第一張投影片。
3. 新增一個帶有預設資料的圖表。
4. 取得座標軸上的實際最大值。
5. 取得座標軸上的實際最小值。
6. 取得座標軸的實際主單位。
7. 取得座標軸的實際次單位。
8. 取得座標軸的實際主單位比例。
9. 取得座標軸的實際次單位比例。

以下範例程式碼—上述步驟的實作—示範了如何在 C++ 中取得所需的值：

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto chart = System::ExplicitCast<Chart>(shapes->AddChart(ChartType::Area, 100.0f, 100.0f, 500.0f, 350.0f));
chart->ValidateChartLayout();

auto axes = chart->get_Axes();

double maxValue = axes->get_VerticalAxis()->get_ActualMaxValue();
double minValue = axes->get_VerticalAxis()->get_ActualMinValue();

double majorUnit = axes->get_HorizontalAxis()->get_ActualMajorUnit();
double minorUnit = axes->get_HorizontalAxis()->get_ActualMinorUnit();

// 儲存簡報
pres->Save(u"ErrorBars_out.pptx", SaveFormat::Pptx);

交換座標軸之間的資料

Aspose.Slides 允許您快速交換座標軸之間的資料—垂直座標軸（y 軸）的資料會移至水平座標軸（x 軸），反之亦然。

以下 C++ 程式碼示範了如何在圖表的座標軸之間執行資料交換：

// 建立空的簡報
auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto chart = shapes->AddChart(ChartType::ClusteredColumn, 100.0f, 100.0f, 400.0f, 300.0f);

// 交換列與欄
chart->get_ChartData()->SwitchRowColumn();

// 儲存簡報
pres->Save(u"SwitchChartRowColumns_out.pptx", SaveFormat::Pptx);

停用折線圖的垂直座標軸

以下 C++ 程式碼示範了如何隱藏折線圖的垂直座標軸：

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto chart = shapes->AddChart(ChartType::Line, 100.0f, 100.0f, 400.0f, 300.0f);
chart->get_Axes()->get_VerticalAxis()->set_IsVisible(false);

pres->Save(u"chart.pptx", SaveFormat::Pptx);

停用折線圖的水平座標軸

以下程式碼示範了如何隱藏折線圖的水平座標軸：

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto chart = shapes->AddChart(ChartType::Line, 100.0f, 100.0f, 400.0f, 300.0f);
chart->get_Axes()->get_HorizontalAxis()->set_IsVisible(false);

pres->Save(u"chart.pptx", SaveFormat::Pptx);

變更類別座標軸

使用 set_CategoryAxisType() 方法，您可以指定首選的類別座標軸類型（date 或 text）。以下 C++ 程式碼示範了此操作：

auto presentation = System::MakeObject<Presentation>(u"ExistingChart.pptx");
auto chart = System::AsCast<IChart>(presentation->get_Slides()->idx_get(0)->get_Shapes()->idx_get(0));
auto horizontalAxis = chart->get_Axes()->get_HorizontalAxis();

horizontalAxis->set_CategoryAxisType(CategoryAxisType::Date);
horizontalAxis->set_IsAutomaticMajorUnit(false);
horizontalAxis->set_MajorUnit(1);
horizontalAxis->set_MajorUnitScale(TimeUnitType::Months);

presentation->Save(u"ChangeChartCategoryAxis_out.pptx", SaveFormat::Pptx);

為類別座標軸值設定日期格式

Aspose.Slides for C++ 允許您為類別座標軸值設定日期格式。以下 C++ 程式碼示範了此操作：

auto pres = System::MakeObject<Presentation>();
auto chart = pres->get_Slides()->idx_get(0)->get_Shapes()->AddChart(ChartType::Area, 50.0f, 50.0f, 450.0f, 300.0f);

auto wb = chart->get_ChartData()->get_ChartDataWorkbook();

wb->Clear(0);

chart->get_ChartData()->get_Series()->Clear();
auto areaCategories = chart->get_ChartData()->get_Categories();
areaCategories->Clear();
areaCategories->Add(wb->GetCell(0, u"A2", ObjectExt::Box<double>(DateTime(2015, 1, 1).ToOADate())));
areaCategories->Add(wb->GetCell(0, u"A3", ObjectExt::Box<double>(DateTime(2016, 1, 1).ToOADate())));
areaCategories->Add(wb->GetCell(0, u"A4", ObjectExt::Box<double>(DateTime(2017, 1, 1).ToOADate())));
areaCategories->Add(wb->GetCell(0, u"A5", ObjectExt::Box<double>(DateTime(2018, 1, 1).ToOADate())));

auto series = chart->get_ChartData()->get_Series()->Add(ChartType::Line);
auto dataPoints = series->get_DataPoints();
dataPoints->AddDataPointForLineSeries(wb->GetCell(0, u"B2", ObjectExt::Box<int32_t>(1)));
dataPoints->AddDataPointForLineSeries(wb->GetCell(0, u"B3", ObjectExt::Box<int32_t>(2)));
dataPoints->AddDataPointForLineSeries(wb->GetCell(0, u"B4", ObjectExt::Box<int32_t>(3)));
dataPoints->AddDataPointForLineSeries(wb->GetCell(0, u"B5", ObjectExt::Box<int32_t>(4)));

auto horizontalAxis = chart->get_Axes()->get_HorizontalAxis();
horizontalAxis->set_CategoryAxisType(CategoryAxisType::Date);
horizontalAxis->set_IsNumberFormatLinkedToSource(false);
horizontalAxis->set_NumberFormat(u"yyyy");

pres->Save(u"test.pptx", SaveFormat::Pptx);

設定座標軸標題的旋轉角度

Aspose.Slides for C++ 允許您設定圖表座標軸標題的旋轉角度。以下 C++ 程式碼示範了此操作：

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto chart = shapes->AddChart(ChartType::ClusteredColumn, 50.0f, 50.0f, 450.0f, 300.0f);
auto verticalAxis = chart->get_Axes()->get_VerticalAxis();
verticalAxis->set_HasTitle(true);
verticalAxis->get_Title()->get_TextFormat()->get_TextBlockFormat()->set_RotationAngle(90.0f);

pres->Save(u"test.pptx", SaveFormat::Pptx);

設定類別或值座標軸的位置

Aspose.Slides for C++ 允許您設定類別或值座標軸的位置。以下 C++ 程式碼示範了如何執行此任務：

auto pres = System::MakeObject<Presentation>();
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto chart = shapes->AddChart(ChartType::ClusteredColumn, 50.0f, 50.0f, 450.0f, 300.0f);
chart->get_Axes()->get_HorizontalAxis()->set_AxisBetweenCategories(true);

pres->Save(u"AsposeScatterChart.pptx", SaveFormat::Pptx);

在圖表值座標軸上啟用顯示單位標籤

Aspose.Slides for C++ 允許您設定圖表在其值座標軸上顯示單位標籤。以下 C++ 程式碼示範了此操作：

auto pres = System::MakeObject<Presentation>(u"Test.pptx");
auto shapes = pres->get_Slides()->idx_get(0)->get_Shapes();
auto chart = shapes->AddChart(ChartType::ClusteredColumn, 50.0f, 50.0f, 450.0f, 300.0f);
chart->get_Axes()->get_VerticalAxis()->set_DisplayUnit(DisplayUnitType::Millions);

pres->Save(u"Result.pptx", SaveFormat::Pptx);

常見問答

如何設定一個座標軸交叉另一個座標軸的位置（座標軸交叉）？

座標軸提供了 crossing setting：您可以選擇在零點、最大類別/值或特定數值處交叉。此功能有助於將 X 軸上移或下移，或強調基線。

如何相對於座標軸定位刻度標籤（旁邊、外側、內側）？

將 label position 設為 “cross”、“outside” 或 “inside”。這會影響可讀性，並有助於在小型圖表上節省空間。