مدیریت برچسبهای داده نمودار در ارائهها با استفاده از جاوا
مقدمه
برچسبهای داده اطلاعاتی درباره سریهای نمودار و نقاط دادهٔ فردی نمایش میدهند و به خوانندگان کمک میکنند مقادیر را شناسایی کرده و نمودار را درک کنند. این مقاله توضیح میدهد چگونه مقادیر را قالببندی کنیم، درصدها را نمایش دهیم، متن برچسب را بخوانیم، برچسبها را فراتر از حداکثر محور کنترل کنیم، فاصلهٔ برچسبهای محور دستهبندی را تنظیم کنیم و موقعیت برچسبهای نمودار دایرهای را تنظیم کنیم.
شمارش برچسبهای دادهٔ قابل مشاهده
از getCountOfVisibleDataLabels برای بررسی اینکه قبل از انتشار ارائه چند برچسب داده برای نمایش فعال شدهاند استفاده کنید. برخلاف getCount که تعداد کل برچسبهای موجود در مجموعه را برمیگرداند، این متد تنظیمات پیشفرض سریها و تنظیمات برچسبهای فردی را در نظر میگیرد.
این مثال یک نمودار ستونی با یک سری و سه نقطه داده ایجاد میکند. با استفاده از getLabels به مجموعه برچسبهای سری دسترسی پیدا میکند و شمارش قابل مشاهده را هنگام تغییر تنظیمات چاپ میکند: 0, 3, 2, 3. شمارش کل ثابت میماند 3.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 300);
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
IChartDataCell seriesCell = workbook.getCell(0, 0, 1, "Values");
IChartSeries series = chart.getChartData().getSeries().add(seriesCell, chart.getType());
for (int i = 0; i < 3; i++) {
IChartDataCell categoryCell = workbook.getCell(0, i + 1, 0, "Category " + (i + 1));
chart.getChartData().getCategories().add(categoryCell);
IChartDataCell valueCell = workbook.getCell(0, i + 1, 1, (i + 1) * 10);
series.getDataPoints().addDataPointForBarSeries(valueCell);
}
IDataLabelCollection labels = series.getLabels();
System.out.println("Total: " + labels.getCount() + "; visible: " + labels.getCountOfVisibleDataLabels()); // کل: 3; قابل مشاهده: 0
labels.getDefaultDataLabelFormat().setShowValue(true);
System.out.println("Visible: " + labels.getCountOfVisibleDataLabels()); // قابل مشاهده: 3
labels.get_Item(1).getDataLabelFormat().setShowValue(false);
System.out.println("Visible: " + labels.getCountOfVisibleDataLabels()); // قابل مشاهده: 2
labels.get_Item(1).getDataLabelFormat().setShowLegendKey(true);
System.out.println("Visible: " + labels.getCountOfVisibleDataLabels()); // قابل مشاهده: 3
} finally {
presentation.dispose();
}
متد getDefaultDataLabelFormat تنظیمات پیشفرض را فراهم میکند. عبور مقدار true به setShowValue در آن باعث نمایش مقادیر برای هر سه برچسب میشود. عبور مقدار false از طریق getDataLabelFormat یک برچسب خاص، آن تنظیمات را برای برچسب انتخاب شده بازنویسی میکند. عبور مقدار true به setShowLegendKey باعث میشود همان برچسب دوباره بهعنوان قابل مشاهده در شمارش درآید، حتی اگر مقدار آن مخفی بماند.
شمارش قابل مشاهده بازتاب تنظیمات قابلیت نمایش است. این شمارش نشاندهندهی این نیست که برچسبها همپوشانی داشته باشند، بریده شوند یا در نمودار رندر شده قابل خواندن باشند.
تنظیم دقت عددی در برچسبهای دادهٔ نمودار
از setNumberFormatOfValues برای قالببندی مقادیر سریها استفاده کنید. این مثال یک نمودار خطی با دادههای پیشفرض ایجاد میکند، جدول دادههای آن را نمایش میدهد و برای سری اول برچسبهای مقدار را فعال میکند. قالب #,##0.00 جداکنندهٔ هزارگان و دو رقم اعشار را بدون تغییر مقادیر اصلی نشان میدهد.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.Line, 50, 50, 450, 300);
chart.setDataTable(true);
IChartSeries series = chart.getChartData().getSeries().get_Item(0);
series.setNumberFormatOfValues("#,##0.00");
series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
presentation.save("PrecisionOfDatalabels_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
برای قالببندی سلولهای عددی در کتابکار جاسازیشدهٔ نمودار، به Set Custom Number Formats for Workbook Cells مراجعه کنید. آن مثال همچنین نشان میدهد برچسبهای مقدار بر اساس قالب سلولهای منبع خود نمایش داده میشوند در حالی که مقادیر عددی ذخیرهشده حفظ میشوند.
نمایش درصد بهعنوان برچسب
برای یک نمودار ستونی انباشته، هر مقدار را بهعنوان درصدی از مجموع دستهٔ مربوطه محاسبه کنید و متن را به قاب متنی که توسط getTextFrameForOverriding بازگردانده میشود اختصاص دهید. این مثال از دادههای پیشفرض نمودار استفاده میکند و درصدها را با دو رقم اعشار در قلم ۸‑نقطهای نمایش میدهد. دستههایی که مجموعشان صفر باشد برای جلوگیری از تقسیم بر صفر نادیده گرفته میشوند. اگر دادههای نمودار تغییر کنند متن برچسب سفارشی را بازمحاسبه کنید.
import com.aspose.slides.*;
import java.util.Locale;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.StackedColumn, 20, 20, 400, 400);
double[] categoryTotals = new double[chart.getChartData().getCategories().size()];
for (int k = 0; k < chart.getChartData().getCategories().size(); k++) {
for (int i = 0; i < chart.getChartData().getSeries().size(); i++) {
IChartSeries series = chart.getChartData().getSeries().get_Item(i);
Number pointValue = (Number) series.getDataPoints().get_Item(k).getValue().getData();
categoryTotals[k] += pointValue.doubleValue();
}
}
for (int x = 0; x < chart.getChartData().getSeries().size(); x++) {
IChartSeries series = chart.getChartData().getSeries().get_Item(x);
series.getLabels().getDefaultDataLabelFormat().setShowLegendKey(false);
for (int j = 0; j < series.getDataPoints().size(); j++) {
IDataLabel label = series.getDataPoints().get_Item(j).getLabel();
if (categoryTotals[j] == 0) {
continue;
}
Number pointValue = (Number) series.getDataPoints().get_Item(j).getValue().getData();
double dataPointPercent = (pointValue.doubleValue() / categoryTotals[j]) * 100;
IPortion portion = new Portion();
portion.setText(String.format(Locale.US, "%.2f %%", dataPointPercent));
portion.getPortionFormat().setFontHeight(8f);
label.getTextFrameForOverriding().setText("");
IParagraph paragraph = label.getTextFrameForOverriding().getParagraphs().get_Item(0);
paragraph.getPortions().add(portion);
label.getDataLabelFormat().setShowValue(true);
label.getDataLabelFormat().setShowSeriesName(false);
label.getDataLabelFormat().setShowPercentage(false);
label.getDataLabelFormat().setShowLegendKey(false);
label.getDataLabelFormat().setShowCategoryName(false);
label.getDataLabelFormat().setShowBubbleSize(false);
}
}
presentation.save("DisplayPercentageAsLabels_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
تنظیم علامت درصد با برچسبهای دادهٔ نمودار
زمانی که مقادیر بهصورت کسر ذخیره میشوند، از setNumberFormat برای نمایش درصدها استفاده کنید. مقدار false را به setNumberFormatLinkedToSource بدهید تا قالب برچسب مستقل از سلولهای منبع اعمال شود.
این مثال یک نمودار ستونی ۱۰۰٪ انباشته با سریهای قرمز و آبی در چهار دسته ایجاد میکند. هر جفت مقدار بهصورت مجموع ۱ میشود. قالب برچسب 0.0% مقدار 0.30 را بهصورت 30.0% نشان میدهد، در حالی که محور عمودی از دو رقم اعشار استفاده میکند. هر دو سری از متن برچسب سفید با اندازهٔ ۱۰‑نقطهای استفاده میکنند.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.PercentsStackedColumn, 20, 20, 500, 400);
chart.getAxes().getVerticalAxis().setNumberFormatLinkedToSource(false);
chart.getAxes().getVerticalAxis().setNumberFormat("0.00%");
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
int worksheetIndex = 0;
for (int i = 0; i < 4; i++) {
IChartDataCell categoryCell = workbook.getCell(worksheetIndex, i + 1, 0, "Category " + (i + 1));
chart.getChartData().getCategories().add(categoryCell);
}
String[] seriesNames = { "Reds", "Blues" };
Color[] seriesColors = { Color.RED, Color.BLUE };
double[][] values = { { 0.30, 0.50, 0.80, 0.65 }, { 0.70, 0.50, 0.20, 0.35 } };
for (int i = 0; i < seriesNames.length; i++) {
IChartDataCell seriesCell = workbook.getCell(worksheetIndex, 0, i + 1, seriesNames[i]);
IChartSeries series = chart.getChartData().getSeries().add(seriesCell, chart.getType());
for (int j = 0; j < 4; j++) {
IChartDataCell valueCell = workbook.getCell(worksheetIndex, j + 1, i + 1, values[i][j]);
series.getDataPoints().addDataPointForBarSeries(valueCell);
}
series.getFormat().getFill().setFillType(FillType.Solid);
series.getFormat().getFill().getSolidFillColor().setColor(seriesColors[i]);
IDataLabelFormat labelFormat = series.getLabels().getDefaultDataLabelFormat();
labelFormat.setShowValue(true);
labelFormat.setNumberFormatLinkedToSource(false);
labelFormat.setNumberFormat("0.0%");
labelFormat.getTextFormat().getPortionFormat().setFontHeight(10);
labelFormat.getTextFormat().getPortionFormat().getFillFormat().setFillType(FillType.Solid);
labelFormat.getTextFormat().getPortionFormat().getFillFormat().getSolidFillColor().setColor(Color.WHITE);
}
presentation.save("SetDataLabelsPercentageSign_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
خواندن متن واقعی برچسبهای داده
از getActualLabelText برای بازیابی متنی که توسط تنظیمات برچسب داده تولید میشود استفاده کنید. این متد هنگام استخراج برچسبها برای گزارشها، جستجو در محتوای ارائه یا اعتبارسنجی نمودارهای تولیدشده مفید است. در مثال زیر، قالب پیشفرض data label format ترکیبی از نام دسته، نام سری و مقدار را میسازد. یک نقطه مقدار خود را بهصورت درصد قالببندی میکند و دیگری از متن سفارشی که توسط getTextFrameForOverriding بازگردانده میشود استفاده میکند.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 300);
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
IChartDataCell firstCategoryCell = workbook.getCell(0, 1, 0, "Q1");
chart.getChartData().getCategories().add(firstCategoryCell);
IChartDataCell secondCategoryCell = workbook.getCell(0, 2, 0, "Q2");
chart.getChartData().getCategories().add(secondCategoryCell);
IChartDataCell northSeriesCell = workbook.getCell(0, 0, 1, "North");
IChartSeries north = chart.getChartData().getSeries().add(northSeriesCell, chart.getType());
IChartDataCell northFirstValueCell = workbook.getCell(0, 1, 1, 0.25);
north.getDataPoints().addDataPointForBarSeries(northFirstValueCell);
IChartDataCell northSecondValueCell = workbook.getCell(0, 2, 1, 0.75);
north.getDataPoints().addDataPointForBarSeries(northSecondValueCell);
IChartDataCell southSeriesCell = workbook.getCell(0, 0, 2, "South");
IChartSeries south = chart.getChartData().getSeries().add(southSeriesCell, chart.getType());
IChartDataCell southFirstValueCell = workbook.getCell(0, 1, 2, 0.40);
south.getDataPoints().addDataPointForBarSeries(southFirstValueCell);
IChartDataCell southSecondValueCell = workbook.getCell(0, 2, 2, 0.60);
south.getDataPoints().addDataPointForBarSeries(southSecondValueCell);
for (IChartSeries series : chart.getChartData().getSeries()) {
IDataLabelFormat format = series.getLabels().getDefaultDataLabelFormat();
format.setShowCategoryName(true);
format.setShowSeriesName(true);
format.setShowValue(true);
}
north.getLabels().get_Item(1).getDataLabelFormat().setNumberFormatLinkedToSource(false);
north.getLabels().get_Item(1).getDataLabelFormat().setNumberFormat("0%");
south.getLabels().get_Item(0).getTextFrameForOverriding().setText("Reviewed");
for (IChartSeries series : chart.getChartData().getSeries()) {
for (IChartDataPoint point : series.getDataPoints()) {
IDataLabel label = point.getLabel();
if (!label.isVisible()) {
continue;
}
System.out.println("Value: " + point.getValue().getData() + "; label: " + label.getActualLabelText());
}
}
} finally {
presentation.dispose();
}
عدد ذخیرهشده در یک نقطه داده همچنان 0.75 میماند، حتی اگر برچسب آن 75% را همراه با نام دسته و سری نشان دهد. متن سفارشی متن تولیدشدهٔ برچسب را جایگزین میکند. getActualLabelText رشتهٔ برچسب نهایی را در هر دو حالت برمیگرداند. برای استخراج تنها برچسبهای قابل مشاهده، همانطور که در بالا نشان داده شد، بهصورت جداگانه isVisible را بررسی کنید.
کنترل برچسبهای داده فراتر از حداکثر محور
هنگامی که بازهٔ یک محور را بهصورت دستی محدود میکنید، ممکن است برخی نقاط داده از حداکثر آن بیشتر شوند. از setShowDataLabelsOverMaximum برای کنترل اینکه آیا برچسبهای دادهٔ آنها نشان داده شوند یا نه استفاده کنید. این تنظیم فقط قابلیت نمایش برچسب را تغییر میدهد؛ بازهٔ محور یا مقادیر دادهٔ زیرین را تغییر نمیدهد.
مثال زیر یک نمودار ستونی خوشهای دوبعدی با مقادیر ۶۰ و ۱۲۰ ایجاد میکند. مقدار false را به setAutomaticMaxValue میفرستد و حداکثر را با setMaxValue بر روی محور عمودی به ۱۰۰ تنظیم میکند. اسلاید اول اجازه میدهد برچسبها فراتر از حداکثر نمایش داده شوند؛ نسخهٔ کپی آن اسلاید این ویژگی را غیرفعال میکند. هر دو اسلاید در DataLabelsOverMaximum.pptx ذخیره میشوند.
با setShowValue برچسبهای مقدار را فعال کنید. تنظیم سطح نمودار بهتنهایی نمایش مقدار را فعال نمیکند یا تنظیم غیر فعال یک برچسب فرد را نادیده نمیگیرد. این مثال مقادیر را برای تمام سری فعال میکند و با استفاده از setPosition برچسبها را در انتهای بیرونی هر ستون قرار میدهد.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 400);
chart.setLegend(false);
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
IChartDataCell firstCategory = workbook.getCell(0, 1, 0, "Within range");
IChartDataCell secondCategory = workbook.getCell(0, 2, 0, "Above maximum");
chart.getChartData().getCategories().add(firstCategory);
chart.getChartData().getCategories().add(secondCategory);
IChartDataCell seriesName = workbook.getCell(0, 0, 1, "Values");
IChartSeries series = chart.getChartData().getSeries().add(seriesName, chart.getType());
IChartDataCell firstValue = workbook.getCell(0, 1, 1, 60);
IChartDataCell secondValue = workbook.getCell(0, 2, 1, 120);
series.getDataPoints().addDataPointForBarSeries(firstValue);
series.getDataPoints().addDataPointForBarSeries(secondValue);
series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
series.getLabels().getDefaultDataLabelFormat().setPosition(LegendDataLabelPosition.OutsideEnd);
chart.getAxes().getVerticalAxis().setAutomaticMaxValue(false);
chart.getAxes().getVerticalAxis().setMaxValue(100);
chart.setShowDataLabelsOverMaximum(true);
ISlide secondSlide = presentation.getSlides().addClone(slide);
IChart secondChart = (IChart) secondSlide.getShapes().get_Item(0);
secondChart.setShowDataLabelsOverMaximum(false);
presentation.save("DataLabelsOverMaximum.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
تصاویر زیر اسلایدهای ذخیرهشدهٔ رندر شده توسط Microsoft PowerPoint را نشان میدهند. با true، برچسب 120 در مرز بالا قابل مشاهده است؛ با false مخفی میشود. برچسب 60 همچنان قابل مشاهده است، حداکثر محور در 100 باقی میماند و نقطهٔ دادهٔ دوم در هر دو حالت 120 است.
| setShowDataLabelsOverMaximum(true) | setShowDataLabelsOverMaximum(false) |
|---|---|
![]() |
![]() |
Chart Type
این مثال از یک نمودار ستونی دوبعدی با محور مقدار استفاده میکند. نمودارهایی که محور مقدار ندارند، مانند نمودارهای دایرهای و دونات، حداکثر محوری برای محدود کردن بهاین شکل ندارند.تنظیم فاصله برچسب از محور
از setLabelOffset برای کنترل فاصلهٔ بین برچسبهای محور دستهبندی و محور استفاده کنید. مقدار بهصورت درصدی از حداکثر اندازهٔ قلم برچسبهای محور محاسبه میشود. این مثال یک نمودار ستونی خوشهای ایجاد میکند و فاصلهٔ برچسب محور افقی را به ۵۰۰ تنظیم میکند. این تنظیم برچسبهای محور دستهبندی را تحت تأثیر قرار میدهد نه برچسبهای متصل به نقاط دادهٔ فردی.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 300);
chart.getAxes().getHorizontalAxis().setLabelOffset(500);
presentation.save("SetCategoryAxisLabelDistance_out.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
تنظیم مکان برچسب
در یک نمودار دایرهای، موقعیت برچسبهای داده را برای بهبود فاصله و ایجاد فضا برای خطوط راهنما تنظیم کنید.
این مثال مقدار اولین نقطه داده را نمایش میدهد، برچسب آن را خارج از برش قرار میدهد و افستهای افقی و عمودی آن را با استفاده از setX و setY تنظیم میکند. این افستها بهصورت نسبی به عرض و ارتفاع نمودار هستند.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.Pie, 50, 50, 200, 200);
IChartSeriesCollection series = chart.getChartData().getSeries();
IDataLabel label = series.get_Item(0).getLabels().get_Item(0);
label.getDataLabelFormat().setShowValue(true);
label.getDataLabelFormat().setPosition(LegendDataLabelPosition.OutsideEnd);
label.setX(0.71f);
label.setY(0.04f);
presentation.save("presentation.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}

قالببندی خطوط راهنما
زمانی که برچسبهای نمودار دایرهای خارج از برشهای خود قرار میگیرند، خطوط راهنما به خوانندگان کمک میکند تا هر مقدار را به برش صحیح مطابقت دهند. رنگ متضاد و خط کمی ضخیم میتواند این ارتباطها را راحتتر قابل دنبالکردن کند، در حالی که شفافیت و سبک خطچین ظاهر خطوط را کمتاثیر نگه میدارد.
از getLeaderLinesFormat برای قالببندی خطوط راهنما در سطح مجموعهٔ برچسبهای دادهٔ سری استفاده کنید. تنظیمات موجود در series.getLabels().getLeaderLinesFormat().getLine() به کلیهٔ مجموعه اعمال میشود، نه به یک برچسب منفرد.
این مثال یک نمودار دایرهای با دادههای پیشفرض ایجاد میکند، مقادیر را خارج از برشها نمایش میدهد و با setShowLeaderLines خطوط راهنما را فعال میکند. دو برچسب را با استفاده از افستهای setX و setY که بهصورت کسر از عرض و ارتفاع نمودار بیان میشوند، دورتر از برشهایشان میبرد. ورودی ارائهای لازم نیست.
متد getFillFormat خط را با رنگ آبی ثابت و مقدار آلفای ۱۹۱ از ۲۵۵ (حدود ۲۵٪ شفافیت) تنظیم میکند. setWidth ضخامت را به ۲ نقطه تنظیم میکند و setDashStyle خط را خطچین میکند.
import com.aspose.slides.*;
import java.awt.Color;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.Pie, 80, 50, 560, 400);
chart.setLegend(false);
IChartSeries series = chart.getChartData().getSeries().get_Item(0);
IDataLabelFormat labelFormat = series.getLabels().getDefaultDataLabelFormat();
labelFormat.setShowValue(true);
labelFormat.setPosition(LegendDataLabelPosition.OutsideEnd);
labelFormat.setShowLeaderLines(true);
// دو برچسب را دورتر از برشهایشان جابجا کنید.
series.getLabels().get_Item(0).setX(0.10f);
series.getLabels().get_Item(0).setY(-0.05f);
series.getLabels().get_Item(1).setX(-0.10f);
series.getLabels().get_Item(1).setY(0.05f);
ILineFormat line = series.getLabels().getLeaderLinesFormat().getLine();
line.getFillFormat().setFillType(FillType.Solid);
line.getFillFormat().getSolidFillColor().setColor(new Color(30, 90, 160, 191));
line.setWidth(2);
line.setDashStyle(LineDashStyle.Dash);
presentation.save("FormattedLeaderLines.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
فعالسازی خطوط راهنما تضمین نمیکند که برای هر برچسب خطی ظاهر شود. قابلیت مشاهده به موقعیت برچسب و رفتار چیدمان نمودار وابسته است. در این مثال، دو برچسب جابجا شده دارای خطوط راهنمای قابل مشاهده هستند؛ برچسبهایی که نزدیک به برشهایشان میمانند نیازی به آنها ندارند.
تصویر زیر فایل ذخیرهشدهٔ FormattedLeaderLines.pptx را که توسط Aspose.Slides رندر شده نشان میدهد:

اضافه کردن ردیفهای متعدد برچسب داده بالای یک نمودار ستونی
این مثال یک نمودار ستونی با دو ردیف برچسب داده بالای ناحیهٔ رسم ایجاد میکند. سری A ستونهای قابل مشاهده را نشان میدهد، در حالی که سریهای B و C برچسبهای اضافی را فراهم میکنند. ستونهای آنها با حذف پر و خط حاشیه مخفی میشوند. متد ChartSeriesGroup.setOverlap تمام سه سری را با همان مرکزهای دسته همراستا میکند.
تنظیمات ChartPlotArea فضای لازم برای ردیفهای برچسب را نگهداری میکند. پس از اینکه Chart.validateChartLayout موقعیتهای پیشفرض را محاسبه کرد، DataLabel.setX و DataLabel.setY همترازی افقی را حفظ کرده و افستهای عمودی را برای ساماندهی برچسبها در دو ردیف اعمال میکنند. اعداد همچنان برچسبهای دادهٔ متصل به مقادیر سری هستند؛ تنها سرعنوانهای ردیف بهصورت شکلهای متنی جداگانه هستند.
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 40, 40, 640, 200);
chart.setTitle(false);
chart.setLegend(false);
chart.getTextFormat().getPortionFormat().setFontHeight(12);
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
workbook.clear(0);
String[] categories = {"North", "South", "East", "West"};
String[] seriesNames = {"Series A", "Series B", "Series C"};
double[][] seriesValues = {
{35, 42, 28, 47},
{22, 31, 19, 26},
{12, 16, 14, 18}
};
for (int categoryIndex = 0; categoryIndex < categories.length; categoryIndex++) {
chart.getChartData().getCategories().add(
workbook.getCell(0, categoryIndex + 1, 0, categories[categoryIndex]));
}
for (int seriesIndex = 0; seriesIndex < seriesNames.length; seriesIndex++) {
IChartSeries series = chart.getChartData().getSeries().add(
workbook.getCell(0, 0, seriesIndex + 1, seriesNames[seriesIndex]),
ChartType.ClusteredColumn);
for (int categoryIndex = 0; categoryIndex < categories.length; categoryIndex++) {
series.getDataPoints().addDataPointForBarSeries(workbook.getCell(
0, categoryIndex + 1, seriesIndex + 1,
seriesValues[seriesIndex][categoryIndex]));
}
if (seriesIndex > 0) {
// ستونهای B و C را مخفی کنید، اما برچسبهای دادهی آنها را نگه دارید.
series.getFormat().getFill().setFillType(FillType.NoFill);
series.getFormat().getLine().getFillFormat().setFillType(FillType.NoFill);
series.getLabels().getDefaultDataLabelFormat().setShowValue(true);
series.getLabels().getDefaultDataLabelFormat()
.getTextFormat().getPortionFormat().setFontHeight(12);
IFillFormat labelFill = series.getLabels().getDefaultDataLabelFormat()
.getTextFormat().getPortionFormat().getFillFormat();
labelFill.setFillType(FillType.Solid);
labelFill.getSolidFillColor().setColor(java.awt.Color.BLACK);
series.getLabels().getDefaultDataLabelFormat().setPosition(
LegendDataLabelPosition.InsideBase);
}
}
// تمام سه سری را با مراکز دسته یکسان تنظیم کنید.
chart.getChartData().getSeries().get_Item(0)
.getParentSeriesGroup().setOverlap((byte) 100);
// برای این مثال جمع و جور، خطوط شبکه کمتری استفاده کنید.
chart.getAxes().getVerticalAxis().setAutomaticMajorUnit(false);
chart.getAxes().getVerticalAxis().setMajorUnit(10);
// فضای بالای نمودار را برای دو ردیف برچسب داده رزرو کنید.
chart.getPlotArea().setLayoutTargetType(LayoutTargetType.Inner);
chart.getPlotArea().setX(0.15f);
chart.getPlotArea().setY(0.32f);
chart.getPlotArea().setWidth(0.80f);
chart.getPlotArea().setHeight(0.48f);
chart.validateChartLayout();
for (int seriesIndex = 1; seriesIndex < seriesNames.length; seriesIndex++) {
IChartSeries series = chart.getChartData().getSeries().get_Item(seriesIndex);
float rowTop = seriesIndex == 1 ? 0.15f : 0.03f;
for (int categoryIndex = 0; categoryIndex < categories.length; categoryIndex++) {
IDataLabel dataLabel = series.getDataPoints().get_Item(categoryIndex).getLabel();
// موقعیت افقی پیشفرض را حفظ کنید. Y یک افست از
// موقعیت پیشفرض برچسب است، که به صورت کسری از ارتفاع نمودار بیان میشود.
dataLabel.setX(0);
dataLabel.setY(rowTop - dataLabel.getActualY() / chart.getHeight());
}
// فقط سرعنوان ردیف یک شکل متنی جداگانه است.
IAutoShape rowHeading = slide.getShapes().addAutoShape(
ShapeType.Rectangle, chart.getX(),
chart.getY() + rowTop * chart.getHeight(), 85, 18);
rowHeading.getFillFormat().setFillType(FillType.NoFill);
rowHeading.getLineFormat().getFillFormat().setFillType(FillType.NoFill);
rowHeading.addTextFrame(seriesNames[seriesIndex]);
rowHeading.getTextFrame().getTextFrameFormat().setMarginTop(0);
rowHeading.getTextFrame().getTextFrameFormat().setMarginBottom(0);
IPortionFormat headingFormat = rowHeading.getTextFrame().getParagraphs()
.get_Item(0).getPortions().get_Item(0).getPortionFormat();
headingFormat.setFontHeight(12);
headingFormat.getFillFormat().setFillType(FillType.Solid);
headingFormat.getFillFormat().getSolidFillColor().setColor(java.awt.Color.BLACK);
}
presentation.save("multiple-rows-of-labels.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}

سؤالات متداول
چگونه میتوانم از همپوشانی برچسبهای داده در نمودارهای چگال جلوگیری کنم؟
از ترکیب مکانیابی خودکار برچسب، خطوط راهنما و کاهش اندازهٔ قلم استفاده کنید؛ در صورت لزوم برخی فیلدها (مثلاً دسته) را مخفی کنید یا فقط برای مقادیر انتهایی یا نقاط کلیدی برچسب نشان دهید.
چگونه میتوانم برچسبها را فقط برای مقادیر صفر، منفی یا خالی غیرفعال کنم؟
پیش از فعالسازی برچسبها نقاط داده را فیلتر کنید و نمایش برای مقادیر ۰، مقادیر منفی یا مقادیر گمشده را بر اساس قاعدهٔ تعریفشده خاموش کنید.
چگونه میتوانم سبک برچسب را هنگام استخراج به PDF/تصاویر ثابت نگه دارم؟
قلم خانواده و اندازه را بهطور صریح تنظیم کنید و اطمینان حاصل کنید که قلم در محیط رندر موجود است تا از استفاده از قلم جایگزین جلوگیری شود.

