Come impostare le proprietà dell'asse grafico

Se si desidera lavorare con l’asse grafico, il ridimensionamento e le unità di visualizzazione per l’asse dei valori, utilizzare le classi ChartAxis, AxisDisplayUnit e AxisScaling.

L’esempio di codice seguente mostra come definire le proprietà degli assi X e 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

Come impostare il valore Data-Ora dell’asse

L’esempio di codice seguente mostra come impostare i valori di data/ora sulle proprietà dell’asse:

	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

Come formattare il valore numerico dell’asse

Il seguente esempio di codice mostra come modificare il formato dei numeri sull’asse dei valori:

	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

Come impostare i limiti dell’asse

La classe AxisBound rappresenta un limite minimo o massimo dei valori degli assi. Bound può essere specificato come un valore numerico, data-ora o uno speciale valore “auto”.

L’esempio di codice seguente mostra come impostare i limiti di un asse:

	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

Come impostare l’unità di intervallo tra le etichette

L’esempio di codice seguente mostra come impostare l’unità di intervallo tra le etichette su un asse:

	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

Come nascondere l’asse del grafico

Se si desidera mostrare o nascondere l’asse del grafico, è sufficiente impostare il valore della proprietà set_Hidden.

Il seguente esempio di codice mostra come nascondere l’asse Y del grafico:

	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

Come allineare l’etichetta del grafico

Se si desidera impostare un allineamento del testo per le etichette a più righe, è sufficiente impostare il valore della proprietà TickLabelAlignment. Il seguente esempio di codice mostra come spuntare l’allineamento delle etichette.

	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

Lavorare con i grafici tramite l'oggetto Shape.Chart Lavorare con l'etichetta dei dati del grafico in C++