Cum să setați proprietățile axei diagramei

Dacă doriți să lucrați cu axa diagramei, scalarea și unitățile de afișare pentru axa valorii, vă rugăm să utilizați clasele ChartAxis, AxisDisplayUnit și AxisScaling.

Următorul exemplu de cod arată cum se definesc proprietățile axei X și Y:

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	System::SharedPtr<Document> doc = System::MakeObject<Document>();
	System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

	// Insert chart.
	System::SharedPtr<Shape> shape = builder->InsertChart(ChartType::Area, 432, 252);
	System::SharedPtr<Chart> chart = shape->get_Chart();

	// Clear demo data.
	chart->get_Series()->Clear();

	// Fill data.
	System::ArrayPtr<System::DateTime> dates = System::MakeArray<System::DateTime>({System::DateTime(2002, 1, 1),
	System::DateTime(2002, 6, 1),
	System::DateTime(2002, 7, 1),
	System::DateTime(2002, 8, 1),
	System::DateTime(2002, 9, 1)});
	chart->get_Series()->Add(u"AW Series 1", dates, System::MakeArray<double>({640, 320, 280, 120, 150}));

	System::SharedPtr<ChartAxis> xAxis = chart->get_AxisX();
	System::SharedPtr<ChartAxis> yAxis = chart->get_AxisY();

	// Change the X axis to be category instead of date, so all the points will be put with equal interval on the X axis.
	xAxis->set_CategoryType(AxisCategoryType::Category);

	// Define X axis properties.
	xAxis->set_Crosses(AxisCrosses::Custom);
	xAxis->set_CrossesAt(3);
	// measured in display units of the Y axis (hundreds)
	xAxis->set_ReverseOrder(true);
	xAxis->set_MajorTickMark(AxisTickMark::Cross);
	xAxis->set_MinorTickMark(AxisTickMark::Outside);
	xAxis->set_TickLabelOffset(200);

	// Define Y axis properties.
	yAxis->set_TickLabelPosition(AxisTickLabelPosition::High);
	yAxis->set_MajorUnit(100);
	yAxis->set_MinorUnit(50);
	yAxis->get_DisplayUnit()->set_Unit(AxisBuiltInUnit::Hundreds);
	yAxis->get_Scaling()->set_Minimum(System::MakeObject<AxisBound>(100));
	yAxis->get_Scaling()->set_Maximum(System::MakeObject<AxisBound>(700));

	System::String outputPath = outputDataDir + u"WorkingWithChartAxis.DefineXYAxisProperties.docx";
	doc->Save(outputPath);

view raw cpp-Programming-Documents-Charts-WorkingWithChartAxis-DefineXYAxisProperties.cpp hosted with ❤ by GitHub

Cum se setează valoarea dată-oră a axei

Următorul exemplu de cod arată cum să setați valorile datei/orei la proprietățile axei:

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	System::SharedPtr<Document> doc = System::MakeObject<Document>();
	System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

	// Insert chart.
	System::SharedPtr<Shape> shape = builder->InsertChart(ChartType::Column, 432, 252);
	System::SharedPtr<Chart> chart = shape->get_Chart();

	// Clear demo data.
	chart->get_Series()->Clear();

	// Fill data.
	System::ArrayPtr<System::DateTime> dates = System::MakeArray<System::DateTime>({System::DateTime(2017, 11, 6),
	System::DateTime(2017, 11, 9),
	System::DateTime(2017, 11, 15),
	System::DateTime(2017, 11, 21),
	System::DateTime(2017, 11, 25),
	System::DateTime(2017, 11, 29)});
	chart->get_Series()->Add(u"AW Series 1", dates, System::MakeArray<double>({1.2, 0.3, 2.1, 2.9, 4.2, 5.3}));

	// Set X axis bounds.
	System::SharedPtr<ChartAxis> xAxis = chart->get_AxisX();
	xAxis->get_Scaling()->set_Minimum(System::MakeObject<AxisBound>((System::DateTime(2017, 11, 5)).ToOADate()));
	xAxis->get_Scaling()->set_Maximum(System::MakeObject<AxisBound>((System::DateTime(2017, 12, 3)).ToOADate()));

	// Set major units to a week and minor units to a day.
	xAxis->set_MajorUnit(7);
	xAxis->set_MinorUnit(1);
	xAxis->set_MajorTickMark(AxisTickMark::Cross);
	xAxis->set_MinorTickMark(AxisTickMark::Outside);

	System::String outputPath = outputDataDir + u"WorkingWithChartAxis.SetDateTimeValuesToAxis.docx";
	doc->Save(outputPath);

view raw cpp-Programming-Documents-Charts-WorkingWithChartAxis-SetDateTimeValuesToAxis.cpp hosted with ❤ by GitHub

Cum se formatează valoarea numerică a axei

Următorul exemplu de cod arată cum să modificați formatul numerelor pe axa valorii:

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	System::SharedPtr<Document> doc = System::MakeObject<Document>();
	System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

	// Insert chart.
	System::SharedPtr<Shape> shape = builder->InsertChart(ChartType::Column, 432, 252);
	System::SharedPtr<Chart> chart = shape->get_Chart();

	// Clear demo data.
	chart->get_Series()->Clear();

	// Fill data.
	chart->get_Series()->Add(u"AW Series 1",
	System::MakeArray<System::String>({u"Item 1", u"Item 2", u"Item 3", u"Item 4", u"Item 5"}),
	System::MakeArray<double>({1900000, 850000, 2100000, 600000, 1500000}));

	// Set number format.
	chart->get_AxisY()->get_NumberFormat()->set_FormatCode(u"#,##0");

	System::String outputPath = outputDataDir + u"WorkingWithChartAxis.SetNumberFormatForAxis.docx";
	doc->Save(outputPath);

view raw cpp-Programming-Documents-Charts-WorkingWithChartAxis-SetNumberFormatForAxis.cpp hosted with ❤ by GitHub

Cum să setați limitele axei

Clasa AxisBound reprezintă o limită minimă sau maximă a valorilor axei. Bound poate fi specificat ca o valoare numerică, dată-oră sau o valoare specială “auto”.

Următorul exemplu de cod arată cum să setați limitele unei axe:

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	System::SharedPtr<Document> doc = System::MakeObject<Document>();
	System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

	// Insert chart.
	System::SharedPtr<Shape> shape = builder->InsertChart(ChartType::Column, 432, 252);
	System::SharedPtr<Chart> chart = shape->get_Chart();

	// Clear demo data.
	chart->get_Series()->Clear();

	// Fill data.
	chart->get_Series()->Add(u"AW Series 1",
	System::MakeArray<System::String>({u"Item 1", u"Item 2", u"Item 3", u"Item 4", u"Item 5"}),
	System::MakeArray<double>({1.2, 0.3, 2.1, 2.9, 4.2}));

	chart->get_AxisY()->get_Scaling()->set_Minimum(System::MakeObject<AxisBound>(0));
	chart->get_AxisY()->get_Scaling()->set_Maximum(System::MakeObject<AxisBound>(6));

	System::String outputPath = outputDataDir + u"WorkingWithChartAxis.SetBoundsOfAxis.docx";
	doc->Save(outputPath);

view raw cpp-Programming-Documents-Charts-WorkingWithChartAxis-SetboundsOfAxis.cpp hosted with ❤ by GitHub

Cum să setați unitatea de Interval între etichete

Următorul exemplu de cod arată cum să setați unitatea de interval între etichete pe o axă:

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	System::SharedPtr<Document> doc = System::MakeObject<Document>();
	System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

	// Insert chart.
	System::SharedPtr<Shape> shape = builder->InsertChart(ChartType::Column, 432, 252);
	System::SharedPtr<Chart> chart = shape->get_Chart();

	// Clear demo data.
	chart->get_Series()->Clear();

	// Fill data.
	chart->get_Series()->Add(u"AW Series 1",
	System::MakeArray<System::String>({u"Item 1", u"Item 2", u"Item 3", u"Item 4", u"Item 5"}),
	System::MakeArray<double>({1.2, 0.3, 2.1, 2.9, 4.2}));

	chart->get_AxisX()->set_TickLabelSpacing(2);

	System::String outputPath = outputDataDir + u"WorkingWithChartAxis.SetIntervalUnitBetweenLabelsOnAxis.docx";
	doc->Save(outputPath);

view raw cpp-Programming-Documents-Charts-WorkingWithChartAxis-SetIntervalUnitBetweenLabelsOnAxis.cpp hosted with ❤ by GitHub

Cum să ascundeți Axa diagramei

Dacă doriți să afișați sau să ascundeți axa diagramei, puteți realiza acest lucru pur și simplu setând valoarea proprietății set_Hidden.

Următorul exemplu de cod arată cum să ascundeți axa Y a diagramei:

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	System::SharedPtr<Document> doc = System::MakeObject<Document>();
	System::SharedPtr<DocumentBuilder> builder = System::MakeObject<DocumentBuilder>(doc);

	// Insert chart.
	System::SharedPtr<Shape> shape = builder->InsertChart(ChartType::Column, 432, 252);
	System::SharedPtr<Chart> chart = shape->get_Chart();

	// Clear demo data.
	chart->get_Series()->Clear();

	// Fill data.
	chart->get_Series()->Add(u"AW Series 1",
	System::MakeArray<System::String>({u"Item 1", u"Item 2", u"Item 3", u"Item 4", u"Item 5"}),
	System::MakeArray<double>({1.2, 0.3, 2.1, 2.9, 4.2}));

	// Hide the Y axis.
	chart->get_AxisY()->set_Hidden(true);

	System::String outputPath = outputDataDir + u"WorkingWithChartAxis.HideChartAxis.docx";
	doc->Save(outputPath);

view raw cpp-Programming-Documents-Charts-WorkingWithChartAxis-HideChartAxis.cpp hosted with ❤ by GitHub

Cum să aliniați eticheta diagramei

Dacă doriți să setați o aliniere a textului pentru etichete cu mai multe linii, puteți realiza acest lucru pur și simplu setând valoarea proprietății TickLabelAlignment. Următorul exemplu de cod arată cum să bifați alinierea etichetelor.

	For complete examples and data files, please go to https://github.com/aspose-words/Aspose.Words-for-C
	System::SharedPtr<Document> doc = System::MakeObject<Document>(inputDataDir + u"Document.docx");
	System::SharedPtr<Shape> shape = System::DynamicCast<Shape>(doc->GetChild(NodeType::Shape, 0, true));
	System::SharedPtr<ChartAxis> axis = shape->get_Chart()->get_AxisX();

	//This property has effect only for multi-line labels.
	axis->set_TickLabelAlignment(ParagraphAlignment::Right);

	doc->Save(outputDataDir + u"WorkingWithChartAxis.TickMultiLineLabelAlignment.docx");

view raw cpp-Programming-Documents-Charts-WorkingWithChartAxis-TickMultiLineLabelAlignment.cpp hosted with ❤ by GitHub

Lucrul cu diagrame prin Shape.Chart obiect Lucrul cu eticheta de date grafice în C++