مدیریت سری‌های داده نمودار در ارائه‌ها بر روی اندروید

نمای کلی

این مقاله نقش ChartSeries را در Aspose.Slides توضیح می‌دهد و بر چگونگی ساختاردهی و تجسم داده‌ها در ارائه‌ها تمرکز می‌کند. این اشیاء عناصر پایه‌ای را فراهم می‌کنند که مجموعه‌های جداگانه‌ای از نقاط داده، دسته‌ها و پارامترهای ظاهر در یک نمودار را تعریف می‌کنند. با کار با ChartSeries، توسعه‌دهندگان می‌توانند به‌راحتی منابع داده‌ پایه را یکپارچه کرده و کنترل کامل بر نمایش اطلاعات داشته باشند و در نتیجه ارائه‌های پویا و مبتنی بر داده تولید کنند که بینش‌ها و تحلیل‌ها را به‌ وضوح منتقل می‌کنند.

یک سری، ردیف یا ستونی از اعداد است که در یک نمودار ترسیم می‌شود.

chart-series-powerpoint

تنظیم همپوشانی سری نمودار

با متد IChartSeries.getOverlap می‌توانید مقدار همپوشانی میله‌ها و ستون‌ها را در یک نمودار دو‌بعدی تعیین کنید (محدوده: -100 تا 100). این ویژگی برای تمام سری‌های گروه سری والد اعمال می‌شود: این یک نمایش از ویژگی گروه مناسب است. بنابراین، این ویژگی فقط-خواندنی است.

از متد getParentSeriesGroup().setOverlap() برای تنظیم مقدار دلخواه همپوشانی استفاده کنید.

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. یک نمودار ستونی خوشه‌ای به یک اسلاید اضافه کنید.
  3. به اولین سری نمودار دسترسی پیدا کنید.
  4. به ParentSeriesGroup سری نمودار دسترسی پیدا کنید و مقدار همپوشانی دلخواه خود را تنظیم کنید.
  5. ارائهٔ اصلاح‌شده را در یک فایل PPTX بنویسید.

این کد جاوا نشان می‌دهد چگونه همپوشانی یک سری نمودار را تنظیم کنید:

Presentation pres = new Presentation();
try {
    // افزودن نمودار
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 400, true);
    IChartSeriesCollection series = chart.getChartData().getSeries();
    if (series.get_Item(0).getOverlap() == 0)
    {
        // تنظیم همپوشانی سری
        series.get_Item(0).getParentSeriesGroup().setOverlap((byte)-30);
    }

    // ذخیرهٔ فایل ارائه روی دیسک
    pres.save("SetChartSeriesOverlap_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

تغییر رنگ سری

Aspose.Slides for Android via Java به شما امکان می‌دهد رنگ یک سری را به این شکل تغییر دهید:

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. یک نمودار به اسلاید اضافه کنید.
  3. سری‌ای که می‌خواهید رنگ آن را تغییر دهید، دسترسی پیدا کنید.
  4. نوع پر کردن و رنگ پر کردن دلخواه خود را تنظیم کنید.
  5. ارائهٔ اصلاح‌شده را ذخیره کنید.

این کد جاوا نشان می‌دهد چگونه رنگ یک سری را تغییر دهید:

Presentation pres = new Presentation("test.pptx");
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Pie, 50, 50, 600, 400);
    IChartDataPoint point = chart.getChartData().getSeries().get_Item(0).getDataPoints().get_Item(1);

    point.setExplosion(30);
    point.getFormat().getFill().setFillType(FillType.Solid);
    point.getFormat().getFill().getSolidFillColor().setColor(Color.BLUE);

    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

تغییر رنگ دسته‌بندی سری

Aspose.Slides for Android via Java به شما امکان می‌دهد رنگ دسته‌بندی یک سری را به این شکل تغییر دهید:

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. یک نمودار به اسلاید اضافه کنید.
  3. دسته‌بندی سری‌ای که می‌خواهید رنگ آن را تغییر دهید، دسترسی پیدا کنید.
  4. نوع پر کردن و رنگ پر کردن دلخواه خود را تنظیم کنید.
  5. ارائهٔ اصلاح‌شده را ذخیره کنید.

این کد جاوا نشان می‌دهد چگونه رنگ یک دسته‌بندی سری را تغییر دهید:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 400);
    IChartDataPoint point = chart.getChartData().getSeries().get_Item(0).getDataPoints().get_Item(0);

    point.getFormat().getFill().setFillType(FillType.Solid);
    point.getFormat().getFill().getSolidFillColor().setColor(Color.BLUE);

    pres.save("output.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

تغییر نام سری

به‌طور پیش‌فرض، نام‌های افسانه (legend) برای یک نمودار محتوای سلول‌های بالای هر ستون یا ردیف داده هستند.

در مثال ما (تصویر نمونه)،

  • ستون‌ها Series 1, Series 2, و Series 3 هستند؛
  • ردیف‌ها Category 1, Category 2, Category 3, و Category 4 هستند.

Aspose.Slides for Android via Java به شما امکان می‌دهد نام یک سری را در داده‌های نمودار و افسانهٔ آن به‌روزرسانی یا تغییر دهید.

این کد جاوا نشان می‌دهد چگونه نام یک سری را در ChartDataWorkbook داده‌های نمودار تغییر دهید:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Column3D, 50, 50, 600, 400, true);

    IChartDataCell seriesCell = chart.getChartData().getChartDataWorkbook().getCell(0, 0, 1);
    seriesCell.setValue("New name");

    pres.save("pres.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

این کد جاوا نشان می‌دهد چگونه نام یک سری را از طریق Series در افسانه تغییر دهید:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.Column3D, 50, 50, 600, 400, true);
    IChartSeries series = chart.getChartData().getSeries().get_Item(0);

    IStringChartValue name = series.getName();
    name.getAsCells().get_Item(0).setValue("New name");
} finally {
    if (pres != null) pres.dispose();
}

تنظیم رنگ پر خودکار برای سری نمودار

Aspose.Slides for Android via Java به شما امکان می‌دهد رنگ پر خودکار را برای سری‌های نمودار داخل ناحیهٔ رسم به این شکل تنظیم کنید:

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. مرجع یک اسلاید را با استفاده از ایندکس آن دریافت کنید.
  3. یک نمودار با داده‌های پیش‌فرض بر اساس نوع دلخواه خود اضافه کنید (در مثال زیر از ChartType.ClusteredColumn استفاده کردیم).
  4. به سری نمودار دسترسی پیدا کنید و رنگ پر را به Automatic تنظیم کنید.
  5. ارائه را در یک فایل PPTX ذخیره کنید.

این کد جاوا نشان می‌دهد چگونه رنگ پر خودکار را برای یک سری نمودار تنظیم کنید:

Presentation pres = new Presentation();
try {
    // یک نمودار ستونی خوشه‌ای ایجاد می‌کند
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 100, 50, 600, 400);

    // قالب پر کردن سری را به حالت خودکار تنظیم می‌کند
    for (int i = 0; i < chart.getChartData().getSeries().size(); i++)
    {
        chart.getChartData().getSeries().get_Item(i).getAutomaticSeriesColor();
    }

    // فایل ارائه را روی دیسک می‌نویسد
    pres.save("AutoFillSeries_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

تنظیم رنگ پر معکوس برای سری نمودار

Aspose.Slides به شما امکان می‌دهد رنگ پر معکوس را برای سری‌های نمودار داخل ناحیهٔ رسم به این شکل تنظیم کنید:

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. مرجع یک اسلاید را با استفاده از ایندکس آن دریافت کنید.
  3. یک نمودار با داده‌های پیش‌فرض بر اساس نوع دلخواه خود اضافه کنید (در مثال زیر از ChartType.ClusteredColumn استفاده کردیم).
  4. به سری نمودار دسترسی پیدا کنید و رنگ پر را به invert تنظیم کنید.
  5. ارائه را در یک فایل PPTX ذخیره کنید.

این کد جاوا عملیات را نشان می‌دهد:

Color inverColor = Color.RED;
Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 100, 100, 400, 300);
    IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook();

    chart.getChartData().getSeries().clear();
    chart.getChartData().getCategories().clear();

    // سری‌ها و دسته‌بندی‌های جدید را اضافه می‌کند
    chart.getChartData().getSeries().add(workBook.getCell(0, 0, 1, "Series 1"), chart.getType());
    chart.getChartData().getCategories().add(workBook.getCell(0, 1, 0, "Category 1"));
    chart.getChartData().getCategories().add(workBook.getCell(0, 2, 0, "Category 2"));
    chart.getChartData().getCategories().add(workBook.getCell(0, 3, 0, "Category 3"));

    // سری اول نمودار را گرفته و داده‌های سری آن را پر می‌کند.
    IChartSeries series = chart.getChartData().getSeries().get_Item(0);
    series.getDataPoints().addDataPointForBarSeries(workBook.getCell(0, 1, 1, -20));
    series.getDataPoints().addDataPointForBarSeries(workBook.getCell(0, 2, 1, 50));
    series.getDataPoints().addDataPointForBarSeries(workBook.getCell(0, 3, 1, -30));
    Color seriesColor = series.getAutomaticSeriesColor();
    series.setInvertIfNegative(true);
    series.getFormat().getFill().setFillType(FillType.Solid);
    series.getFormat().getFill().getSolidFillColor().setColor(seriesColor);
    series.getInvertedSolidFillColor().setColor(inverColor);
    
    pres.save("SetInvertFillColorChart_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

تنظیم معکوس شدن سری وقتی مقدار منفی است

Aspose.Slides به شما امکان می‌دهد معکوس شدن را از طریق ویژگی‌های IChartDataPoint.InvertIfNegative و ChartDataPoint.InvertIfNegative تنظیم کنید. وقتی معکوس با استفاده از این ویژگی‌ها تنظیم شود، نقطه داده رنگ‌های خود را در صورت دریافت مقدار منفی معکوس می‌کند.

این کد جاوا عملیات را نشان می‌دهد:

Presentation pres = new Presentation();
try {
    IChart chart = pres.getSlides().get_Item(0).getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 400, true);
    IChartSeriesCollection series = chart.getChartData().getSeries();
    chart.getChartData().getSeries().clear();

    IChartSeries chartSeries = series.add(chart.getChartData().getChartDataWorkbook().getCell(0, "B1"), chart.getType());
    chartSeries.getDataPoints().addDataPointForBarSeries(chart.getChartData().getChartDataWorkbook().getCell(0, "B2", -5));
    chartSeries.getDataPoints().addDataPointForBarSeries(chart.getChartData().getChartDataWorkbook().getCell(0, "B3", 3));
    chartSeries.getDataPoints().addDataPointForBarSeries(chart.getChartData().getChartDataWorkbook().getCell(0, "B4", -2));
    chartSeries.getDataPoints().addDataPointForBarSeries(chart.getChartData().getChartDataWorkbook().getCell(0, "B5", 1));

    chartSeries.setInvertIfNegative(false);

    chartSeries.getDataPoints().get_Item(2).setInvertIfNegative(true);

    pres.save("out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

پاک‌سازی داده‌های نقطه خاص

Aspose.Slides for Android via Java به شما امکان می‌دهد داده‌های DataPoints یک سری نمودار خاص را به این شکل پاک کنید:

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. مرجع یک اسلاید را از طریق ایندکس آن دریافت کنید.
  3. مرجع یک نمودار را از طریق ایندکس آن دریافت کنید.
  4. تمام DataPoints نمودار را پیمایش کرده و XValue و YValue را به null تنظیم کنید.
  5. تمام DataPoints برای سری نمودار خاص را پاک کنید.
  6. ارائهٔ اصلاح‌شده را در یک فایل PPTX بنویسید.

این کد جاوا عملیات را نشان می‌دهد:

Presentation pres = new Presentation("TestChart.pptx");
try {
    ISlide sl = pres.getSlides().get_Item(0);

    IChart chart = (IChart)sl.getShapes().get_Item(0);

    for (IChartDataPoint dataPoint : chart.getChartData().getSeries().get_Item(0).getDataPoints())
    {
        dataPoint.getXValue().getAsCell().setValue(null);
        dataPoint.getYValue().getAsCell().setValue(null);
    }

    chart.getChartData().getSeries().get_Item(0).getDataPoints().clear();

    pres.save("ClearSpecificChartSeriesDataPointsData.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

تنظیم عرض فاصله بین سری‌ها (Gap Width)

Aspose.Slides for Android via Java به شما امکان می‌دهد عرض فاصله بین سری‌ها را از طریق ویژگی GapWidth به این شکل تنظیم کنید:

  1. یک نمونه از کلاس Presentation ایجاد کنید.
  2. اولین اسلاید را دسترسی پیدا کنید.
  3. نمودار با داده‌های پیش‌فرض اضافه کنید.
  4. به هر سری نمودار دسترسی پیدا کنید.
  5. ویژگی GapWidth را تنظیم کنید.
  6. ارائهٔ اصلاح‌شده را در یک فایل PPTX بنویسید.

این کد جاوا نشان می‌دهد چگونه عرض فاصله بین سری‌ها را تنظیم کنید:

// یک ارائه خالی ایجاد می‌کند 
Presentation pres = new Presentation();
try {
    // به اسلاید اول ارائه دسترسی پیدا می‌کند
    ISlide slide = pres.getSlides().get_Item(0);
    
    // یک نمودار با داده‌های پیش‌فرض اضافه می‌کند
    IChart chart = slide.getShapes().addChart(ChartType.StackedColumn, 0, 0, 500, 500);
    
    // ایندکس شیت داده‌های نمودار را تنظیم می‌کند
    int defaultWorksheetIndex = 0;
    
    // شیت داده‌های نمودار را دریافت می‌کند
    IChartDataWorkbook fact = chart.getChartData().getChartDataWorkbook();
    
    // سری‌ها را اضافه می‌کند
    chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 1, "Series 1"), chart.getType());
    chart.getChartData().getSeries().add(fact.getCell(defaultWorksheetIndex, 0, 2, "Series 2"), chart.getType());
    
    // دسته‌بندی‌ها را اضافه می‌کند
    chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 1, 0, "Caetegoty 1"));
    chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 2, 0, "Caetegoty 2"));
    chart.getChartData().getCategories().add(fact.getCell(defaultWorksheetIndex, 3, 0, "Caetegoty 3"));
    
    // سری دوم نمودار را می‌گیرد
    IChartSeries series = chart.getChartData().getSeries().get_Item(1);
    
    // داده‌های سری را پر می‌کند
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 1, 20));
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 1, 50));
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 1, 30));
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 1, 2, 30));
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 2, 2, 10));
    series.getDataPoints().addDataPointForBarSeries(fact.getCell(defaultWorksheetIndex, 3, 2, 60));
    
    // مقدار GapWidth را تنظیم می‌کند
    series.getParentSeriesGroup().setGapWidth(50);
    
    // ارائه را روی دیسک ذخیره می‌کند
    pres.save("GapWidth_out.pptx", SaveFormat.Pptx);
} finally {
    if (pres != null) pres.dispose();
}

سوالات متداول

آیا محدودیتی برای تعداد سری‌هایی که یک نمودار می‌تواند داشته باشد وجود دارد؟

Aspose.Slides محدودیت ثابت خاصی برای تعداد سری‌های اضافه‌شده اعمال نمی‌کند. سقف عملی توسط قابلیت خواندن نمودار و حافظه موجود برای برنامه شما تعیین می‌شود.

اگر ستون‌های داخل یک خوشه خیلی نزدیک یا خیلی دور از هم باشند چه کاری باید انجام داد؟

تنظیم GapWidth برای آن سری (یا گروه سری والد آن) را تغییر دهید. افزایش مقدار، فضای بین ستون‌ها را widen می‌کند، در حالی که کاهش مقدار آن‌ها را به‑یکدیگر نزدیک می‌کند.