سفارشی‌سازی جداول داده‌های نمودار در ارائه‌ها در .NET

نمای کلی

Aspose.Slides برای .NET به شما امکان می‌دهد جدول داده‌های یک نمودار را نمایش دهید و قالب‌بندی متن، حاشیه‌ها و کلیدهای افسانه‌ای آن را سفارشی کنید. این مقاله توضیح می‌دهد چگونه جدول را فعال کنید، متن آن را فرمت‌بندی کنید، هر نوع حاشیره را کنترل کنید و کلیدهای افسانه‌ای را نشان یا مخفی کنید. مثال‌ها نمودارهای پیکربندی‌شده را در فایل‌های PPTX ذخیره می‌کنند.

تنظیم ویژگی‌های قلم

برای نمایش جدول داده‌های یک نمودار، ویژگی HasDataTable را به true تنظیم کنید. برای دسترسی به جدول و پیکربندی قالب‌بندی متن آن از ChartDataTable استفاده کنید.

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

مثال زیر به فایل test.pptx در پوشهٔ کاری با حداقل یک اسلاید نیاز دارد. این مثال یک نمودار با داده‌های پیش‌فرض را در موقعیت (50, 50) اضافه می‌کند، با عرض 600 پوینت و ارتفاع 400 پوینت. فایل ذخیره‌شدهٔ output.pptx شامل نمودار با جدول داده‌ها فعال و تنظیمات قلم مشخص‌شده است.

using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;

using var presentation = new Presentation("test.pptx");
var slide = presentation.Slides[0];

var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 50, 600, 400);
chart.HasDataTable = true;

var portionFormat = chart.ChartDataTable.TextFormat.PortionFormat;
portionFormat.FontBold = NullableBool.True;
portionFormat.FontHeight = 20;

presentation.Save("output.pptx", SaveFormat.Pptx);

سفارشی‌سازی حاشیه‌های جدول داده‌ها

جدول را با IChart.HasDataTable فعال کنید و از طریق IChart.ChartDataTable به آن دسترسی پیدا کنید. می‌توانید سه نوع حاشیه را به‌صورت مستقل کنترل کنید:

  • HasBorderHorizontal حاشیه‌های افقی سلول‌ها را کنترل می‌کند.
  • HasBorderVertical حاشیه‌های عمودی سلول‌ها را کنترل می‌کند.
  • HasBorderOutline حاشیهٔ بیرونی جدول را کنترل می‌کند.

هر ویژگی را به true تنظیم کنید تا حاشیهٔ مربوطه نمایش داده شود یا به false برای مخفی کردن آن. مثال زیر یک نمودار ستونی خوشه‌ای با داده‌های پیش‌فرض ایجاد می‌کند، حاشیه‌های افقی و حاشیهٔ بیرونی را نمایش می‌دهد و حاشیه‌های عمودی را مخفی می‌کند. این مثال نیازی به فایل ورودی ندارد. موقعیت و اندازهٔ نمودار بر حسب پوینت مشخص می‌شود.

using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 50, 600, 400);
chart.HasDataTable = true;

var dataTable = chart.ChartDataTable;
dataTable.HasBorderHorizontal = true;
dataTable.HasBorderVertical = false;
dataTable.HasBorderOutline = true;

presentation.Save("data-table-borders.pptx", SaveFormat.Pptx);

مقایسهٔ زیر همان جدول را با کلیدهای افسانهٔ فعال و غیرفعال نشان می‌دهد. تمام حاشیه‌ها فعال می‌مانند و افسانهٔ جداگانهٔ نمودار در هر دو حالت مخفی است.

جداول داده‌های نمودار با کلیدهای افسانه در سمت چپ نشان داده شده و در سمت راست مخفی شده‌اند

نمایش یا مخفی کردن کلیدهای افسانه

کلیدهای افسانه، نشانگرهای رنگی کوچک کنار نام‌های سری‌ها در جدول داده‌ها هستند. آنها به خوانندگان کمک می‌کنند تا هر ردیف جدول را به یک سری نمودار مرتبط کنند. برای نمایش این نشانگرها، ویژگی ShowLegendKey را به true تنظیم کنید یا برای مخفی کردن آنها به false.

افسانهٔ جداگانهٔ نمودار توسط IChart.HasLegend کنترل می‌شود. این تنظیمات مستقل هستند: مخفی کردن افسانهٔ جداگانه، کلیدهای داخل جدول داده‌ها را مخفی نمی‌کند و مخفی کردن کلیدهای جدول، افسانهٔ جداگانه را مخفی نمی‌کند.

مثال زیر یک نمودار با داده‌های پیش‌فرض ایجاد می‌کند، جدول داده‌های آن را فعال می‌سازد و کلیدهای افسانه را داخل آن نشان می‌دهد در حالی که افسانهٔ جداگانه مخفی می‌شود. تمام حاشیه‌های جدول به‌وضوح فعال هستند. نیازی به ارائهٔ ورودی نیست. برای مخفی کردن فقط کلیدهای جدول، مقدار dataTable.ShowLegendKey را به false تغییر دهید.

using Aspose.Slides;
using Aspose.Slides.Charts;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 50, 50, 600, 400);
chart.HasDataTable = true;
chart.HasLegend = false;

var dataTable = chart.ChartDataTable;
dataTable.HasBorderHorizontal = true;
dataTable.HasBorderVertical = true;
dataTable.HasBorderOutline = true;
dataTable.ShowLegendKey = true;

presentation.Save("data-table-legend-keys.pptx", SaveFormat.Pptx);

مقایسهٔ زیر همان جدول را با کلیدهای افسانهٔ فعال و غیرفعال نشان می‌دهد. تمام حاشیه‌ها فعال می‌مانند و افسانهٔ جداگانهٔ نمودار در هر دو حالت مخفی است.

جداول داده‌های نمودار با کلیدهای افسانه در سمت چپ نشان داده شده و در سمت راست مخفی شده‌اند

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

آیا می‌توانم کلیدهای افسانه را در جدول داده‌های یک نمودار نشان دهم؟

بله. ویژگی ShowLegendKey را به true تنظیم کنید تا کلیدهای افسانه نمایش داده شوند یا به false برای مخفی کردن آنها.

آیا جدول داده‌ها هنگام خروجی گرفتن ارائه به PDF، HTML یا تصاویر حفظ می‌شود؟

بله. Aspose.Slides هنگام خروجی گرفتن به PDF، HTML، یا images، نمودار و جدول داده‌های نمایش‌داده‌شده را به‌عنوان بخشی از اسلاید رندر می‌کند.

آیا می‌توانم با جدول داده‌ها در نمودارهایی که از یک قالب بارگذاری شده‌اند کار کنم؟

بله. برای نموداری که از یک ارائه یا قالب موجود بارگذاری شده است، می‌توانید از HasDataTable برای بررسی یا تغییر وضعیت نمایش جدول داده‌ها استفاده کنید.

چگونه می‌توانم نمودارهایی را پیدا کنم که جدول داده آن‌ها فعال باشد؟

در هر اسلاید، تمام اشکال را پیمایش کنید، نمودارها را شناسایی کنید و ویژگی HasDataTable آن‌ها را بررسی کنید. مقدار true نشان می‌دهد که جدول داده فعال است.