نحوه تنظیم ویژگی های محور نمودار

اگر می خواهید با محور نمودار، مقیاس بندی و واحدهای نمایش برای محور ارزش کار کنید، لطفا از کلاس های ChartAxis، AxisDisplayUnit و AxisScaling استفاده کنید.

مثال کد زیر نشان می دهد که چگونه ویژگی های محور X و 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

چگونه مقدار تاریخ و زمان محور را تنظیم کنیم

مثال کد زیر نشان می دهد که چگونه مقادیر تاریخ/زمان را به ویژگی های محور تنظیم کنید:

	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

نحوه قالب بندی تعداد ارزش محور

مثال کد زیر نشان می دهد که چگونه فرمت اعداد را در محور ارزش تغییر دهید:

	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

نحوه تنظیم مرزهای محور

کلاس AxisBound حداقل یا حداکثر مرز مقادیر محور را نشان می دهد. Bound را می توان به عنوان یک مقدار عددی، تاریخ و زمان یا یک مقدار ویژه “خودکار” مشخص کرد.

مثال کد زیر نشان می دهد که چگونه مرزهای یک محور را تنظیم کنید:

	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

نحوه تنظیم واحد فاصله بین برچسب ها

مثال کد زیر نشان می دهد که چگونه واحد فاصله بین برچسب ها را در یک محور تنظیم کنیم:

	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

چگونه برای پنهان کردن محور نمودار

اگر می خواهید محور نمودار را نشان دهید یا پنهان کنید، می توانید به سادگی با تنظیم مقدار ویژگی set_Hidden به این هدف برسید.

مثال کد زیر نشان می دهد که چگونه محور 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::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

چگونه برچسب نمودار را تراز کنیم

اگر می خواهید یک تراز متن برای برچسب های چند خطی تنظیم کنید، می توانید به سادگی با تنظیم مقدار ویژگی TickLabelAlignment به این هدف برسید. مثال کد زیر نشان می دهد که چگونه تراز برچسب را تیک بزنید.

	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

کار با نمودارها از طریق Shape.Chart Object کار با برچسب Chart Data در C++