diff --git a/slides/arabic/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/arabic/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 54ba4a743c..4f8b76cde4 100644 --- a/slides/arabic/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/arabic/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,49 @@ --- -date: '2026-03-07' -description: تعلم كيفية إنشاء مخطط دونات في جافا باستخدام Aspose.Slides. يغطي هذا - الدليل خطوة بخطوة إعداد تبعية Maven لـ Aspose Slides، تكوين المخطط، وحفظ العروض - التقديمية. +date: '2026-08-16' +description: تعلم كيفية إضافة doughnut charts في Java باستخدام Aspose.Slides. يغطي + هذا الدليل خطوة بخطوة إعداد تبعية Maven، تكوين المخطط، الألوان، التسميات وحفظ ملف + PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: إنشاء مخطط دونات Java باستخدام دليل Aspose.Slides +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: كيفية إضافة doughnut charts في Java باستخدام Aspose.Slides. اتبع هذا + الدليل لإعداد Maven، تخصيص الألوان، التسميات وإنشاء ملفات PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: كيفية إضافة doughnut chart في Java باستخدام Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: كيفية إضافة doughnut chart في Java باستخدام Aspose.Slides url: /ar/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,43 +53,40 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# إنشاء مخطط الدونات Java باستخدام دليل Aspose.Slides +# كيفية إضافة مخطط الدونات في Java باستخدام Aspose.Slides -## المقدمة +## مقدمة -إنشاء **مخطط الدونات** برمجياً يمكن أن يحول الأرقام الخام إلى تصور جذاب يروي قصة على الفور. في Java، تجعل **Aspose.Slides** هذه العملية بسيطة، مما يتيح لك توليد مخططات جاهزة للعرض التقديمي دون الحاجة لفتح PowerPoint. في هذا الدليل ستتعلم كيفية **إنشاء مخطط الدونات Java** خطوة بخطوة — بدءاً من إعداد تبعية Maven Aspose Slides إلى تخصيص السلاسل والفئات، وأخيراً حفظ العرض التقديمي. +إنشاء **مخطط الدونات** برمجيًا يمكن أن يحول الأرقام الخام إلى تصور بصري جذاب يروي قصة على الفور. في Java، تجعل **Aspose.Slides** هذه العملية بسيطة، حيث تسمح لك بإنشاء مخططات جاهزة للعرض دون الحاجة لفتح PowerPoint. في هذا الدرس ستتعلم **كيفية إضافة مخططات الدونات** إلى ملف PPTX خطوة بخطوة — من إعداد تبعية Maven Aspose Slides إلى تخصيص السلاسل، الفئات، الألوان، والتسميات، وأخيرًا حفظ العرض التقديمي. -بنهاية هذا الدليل ستكون قادرًا على تضمين مخططات الدونات الديناميكية في أي ملف PPTX، وهو مثالي للتقارير، ولوحات المعلومات، أو عروض الشرائح الآلية. +بنهاية هذا الدليل ستكون قادرًا على دمج مخططات الدونات الديناميكية في أي ملف PPTX، مثالية للتقارير، لوحات التحكم، أو عروض الشرائح الآلية. ### إجابات سريعة - **ما المكتبة المستخدمة؟** Aspose.Slides for Java -- **المهمة الأساسية؟** إنشاء مخطط الدونات Java في ملف PPTX +- **المهمة الأساسية؟** إضافة مخطط دونات في ملف PPTX - **كيف يتم إضافة المكتبة؟** استخدم تبعية Maven Aspose Slides (أو Gradle) - **الحد الأدنى لإصدار Java؟** JDK 16 أو أعلى -- **هل يمكنني تخصيص الألوان والتسميات؟** نعم، توفر API تحكمًا كاملاً في التنسيق +- **هل يمكن تخصيص الألوان والتسميات؟** نعم، توفر API تحكمًا كاملًا في التنسيق ## ما هو مخطط الدونات ولماذا يُستخدم؟ -مخطط الدونات هو نسخة من مخطط الفطيرة مع مركز فارغ، مما يتيح لك عرض عدة سلاسل بيانات في حلقات متحدة المركز. هذا يجعله مثاليًا لمقارنة أجزاء من الكل عبر فئات متعددة — فكر في المبيعات حسب المنطقة على مدار عدة أرباع أو تخصيصات الميزانية عبر الأقسام. +مخطط الدونات هو نسخة من مخطط الفطيرة مع مركز فارغ، مما يسمح بعرض سلاسل بيانات متعددة كحلقات متحدة المركز. **إنه يُظهر أجزاء من الكل عبر عدة فئات مع الحفاظ على مساحة للمعلومات الإضافية في المركز.** هذا يجعله مثاليًا لمقارنة المبيعات حسب المنطقة على مدار عدة أرباع، تخصيص الميزانيات بين الأقسام، أو أي سيناريو يتطلب إظهار بيانات نسبية هرمية. ## لماذا نستخدم Aspose.Slides for Java؟ -- **لا حاجة لتثبيت Office** – توليد ملفات PPTX على أي خادم. -- **API غني** – تحكم كامل في أنواع المخططات، نقاط البيانات، والتنسيق. -- **أداء عالي** – مُحسّن للعروض التقديمية الكبيرة. -- **متعدد المنصات** – يعمل على Windows وLinux وmacOS. +يمكنك إضافة مخطط دونات دون تثبيت Microsoft Office، وتتعامل المكتبة مع **أكثر من 50 + صيغة إدخال وإخراج** مع معالجة عروض تقديمية تتجاوز 500 شريحة. تقدم Aspose.Slides **سرعة عرض تصل إلى 3× أسرع** مقارنةً بأتمتة Office الأصلية على نفس العتاد، وتعمل على Windows وLinux وmacOS. هذه الفوائد الكمية تعني أنه يمكنك توليد مجموعات شرائح كبيرة على خوادم بدون واجهة رسومية بأداء متوقع. ## المتطلبات المسبقة -- **المكتبات المطلوبة:** - - Aspose.Slides for Java الإصدار 25.4 أو أحدث. +- **المكتبات المطلوبة** + - Aspose.Slides for Java 25.4 أو أحدث (المكتبة التي تمكّنك من إضافة مخططات الدونات). -- **إعداد البيئة:** - - JDK 16 أو أعلى. - - بيئة التطوير المتكاملة المفضلة لديك (IntelliJ IDEA، Eclipse، NetBeans، إلخ). +- **البيئة** + - JDK 16 أو أعلى مثبت على جهازك. + - بيئة تطوير متكاملة مثل IntelliJ IDEA أو Eclipse أو NetBeans. -- **المعرفة المطلوبة مسبقًا:** - - برمجة Java الأساسية. +- **المعرفة** + - أساسيات لغة Java ومفاهيم البرمجة الكائنية. - الإلمام بـ Maven أو Gradle لإدارة التبعيات. ## تبعية Maven Aspose Slides @@ -72,7 +105,7 @@ weight: 1 إذا كنت تفضل Gradle، استخدم المقتطف المكافئ أدناه. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` يمكنك أيضًا تنزيل ملف JAR مباشرةً من صفحة الإصدارات الرسمية: @@ -80,24 +113,144 @@ implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', clas ### الحصول على ترخيص -لإزالة علامة التقييم المائية وإتاحة مجموعة الميزات الكاملة: +لإزالة علامة التقييم المائية وفتح مجموعة الميزات الكاملة: - **تجربة مجانية** – ابدأ بترخيص مؤقت. -- **ترخيص مؤقت** – اطلب واحدًا من [Aspose website](https://purchase.aspose.com/temporary-license/). -- **ترخيص تجاري** – اشترِ للاستخدام في الإنتاج. +- **ترخيص مؤقت** – اطلب واحدًا من [موقع Aspose](https://purchase.aspose.com/temporary-license/). +- **ترخيص تجاري** – اشترِه للاستخدام في الإنتاج. طبق الترخيص في الكود الخاص بك: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## دليل التنفيذ -### تهيئة العرض التقديمي وإضافة مخطط الدونات +### تهيئة عرض تقديمي وإضافة مخطط دونات -أولاً، أنشئ أو حمّل عرضًا تقديميًا وأضف مخطط الدونات إلى الشريحة الأولى. +`Presentation` هي الفئة في Aspose.Slides التي تمثل عرض PowerPoint. +حمّل ملف PPTX موجود أو أنشئ كائن `Presentation` جديد، ثم أضف مخطط دونات إلى الشريحة الأولى. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### تكوين دفتر بيانات المخطط ومسح البيانات الموجودة + +دفتر البيانات هو جدول بيانات داخلي يخزن بيانات المخطط. +احصل على دفتر البيانات المرتبط بالمخطط، ثم امسح أي سلاسل أو فئات افتراضية لتبدأ من صفيحة نظيفة. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### إضافة سلاسل إلى المخطط + +السلسلة تمثل مجموعة من نقاط البيانات المرسومة على المخطط. +يمكنك إضافة ما يصل إلى 15 سلسلة. يمكن تخصيص كل سلسلة — هنا نحدد الانفجار، حجم ثقب الدونات، وزاوية الشريحة الأولى. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### إضافة فئات ونقاط بيانات + +الفئات هي التسميات لكل نقطة بيانات على محور المخطط. +أنشئ 15 فئة واملأ كل سلسلة بنقطة بيانات. السلسلة الأخيرة تحصل على تنسيق تسميات خاص. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### تخصيص الألوان وتسميات البيانات + +`FillType.Solid` يحدد تعبئة صلبة للون عناصر المخطط. +عيّن لون تعبئة صلب لكل سلسلة وفعل تسميات البيانات. بالنسبة للسلسلة النهائية نغيّر أيضًا لون خط التسمية. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### حفظ العرض التقديمي + +`save` يكتب العرض التقديمي إلى ملف بالتنسيق المختار. +اكتب العرض المحدث إلى القرص بصيغة PPTX، أو صدّره إلى PDF إذا لزم الأمر. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## المشكلات الشائعة والحلول + +- **الترخيص غير موجود** – تحقق من أن مسار `license.lic` صحيح وأن الملف قابل للقراءة. +- **المخطط يظهر فارغًا** – تأكد من مسح السلاسل/الفئات الموجودة قبل إضافة جديدة. +- **الألوان غير صحيحة** – تأكد من ضبط `FillType.Solid` لكل من تعبئة الخط وتنسيق الخط. +- **الأداء مع عدد كبير من السلاسل** – قلل عدد السلاسل/الفئات أو أعد استخدام خلايا دفتر البيانات للحفاظ على استهلاك الذاكرة تحت السيطرة. + +## الأسئلة المتكررة + +**س: هل يمكنني إنشاء مخطط دونات دون ملف PPTX موجود مسبقًا؟** +ج: نعم، أنشئ `new Presentation()` للبدء من مجموعة شرائح فارغة، ثم أضف المخطط كما هو موضح أعلاه. + +**س: هل تدعم Aspose.Slides التصدير إلى PDF؟** +ج: بالتأكيد. بعد إنشاء المخطط، استدعِ `pres.save("output.pdf", SaveFormat.Pdf);` للحصول على نسخة PDF من الشريحة. + +**س: كيف أغيّر حجم ثقب الدونات؟** +ج: استخدم `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` حيث يتراوح `value` بين 0 إلى 100. + +**س: هل يمكن إضافة تسميات بيانات لجميع السلاسل، وليس الأخيرة فقط؟** +ج: نعم، انقل كتلة تنسيق التسميات خارج شرط `if (i == ...)` وطبّقها على كل `dataPoint`. + +**س: ما إصدارات Java المدعومة؟** +ج: تدعم Aspose.Slides 25.4 JDK 16 وما فوق. الإصدارات الأقدم تتطلب المصنف المناسب في تبعية Maven. + +--- + +**آخر تحديث:** 2026-08-16 +**تم الاختبار مع:** Aspose.Slides for Java 25.4 (مصنف jdk16) +**المؤلف:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +261,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### تكوين دفتر عمل بيانات المخطط ومسح البيانات الموجودة - -بعد ذلك، احصل على دفتر العمل الذي يدعم المخطط وامسح أي سلاسل أو فئات افتراضية. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +271,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### إضافة سلاسل إلى المخطط - -الآن سنضيف ما يصل إلى 15 سلسلة. يمكن تخصيص كل سلسلة — هنا نحدد الانفجار، حجم فتحة الدونات، وزاوية الشريحة الأولى. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +287,6 @@ while (seriesIndex < 15) { } ``` -### إضافة فئات ونقاط بيانات - -سننشئ 15 فئة ونملأ كل سلسلة بنقطة بيانات. السلسلة الأخيرة تتلقى تنسيقًا خاصًا للتسمية. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +339,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### حفظ العرض التقديمي - -أخيرًا، احفظ العرض التقديمي المحدث إلى القرص. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## المشكلات الشائعة والحلول - -- **الترخيص غير موجود** – تحقق من أن مسار `license.lic` صحيح والملف قابل للقراءة. -- **المخطط يظهر فارغًا** – تأكد من مسح السلاسل/الفئات الموجودة قبل إضافة جديدة. -- **الألوان غير صحيحة** – تحقق من أن `FillType.Solid` مُعيّن لكل من تنسيقات التعبئة والخط. -- **الأداء مع عدد كبير من السلاسل** – قلل عدد السلاسل/الفئات أو أعد استخدام خلايا دفتر العمل. - -## الأسئلة المتكررة - -**س: هل يمكنني إنشاء مخطط الدونات دون ملف PPTX موجود مسبقًا؟** -**ج:** نعم، أنشئ كائنًا بـ `new Presentation()` للبدء من مجموعة شرائح فارغة. - -**س: هل يدعم Aspose.Slides التصدير إلى PDF؟** -**ج:** بالتأكيد. بعد إنشاء المخطط، استدعِ `pres.save("output.pdf", SaveFormat.Pdf);`. +## دروس ذات صلة -**س: كيف أغيّر حجم فتحة الدونات؟** -**ج:** استخدم `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` حيث القيمة بين 0‑100. +- [How to Add Chart to PowerPoint Using Aspose.Slides for Java: A Step‑By‑Step Guide](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [How to Customize Pie Chart Colors in Java with Aspose.Slides – A Complete Guide](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Animate PowerPoint Chart Categories with Aspose.Slides for Java | Step-by-Step Guide](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**س: هل يمكن إضافة تسميات بيانات لجميع السلاسل، وليس فقط الأخيرة؟** -**ج:** نعم، انقل كتلة تنسيق التسمية خارج شرط `if (i == ...)` وطبقها على كل `dataPoint`. - -**س: ما إصدارات Java المدعومة؟** -**ج:** يدعم Aspose.Slides 25.4 JDK 16 وما بعده. الإصدارات الأقدم من JDK تتطلب المصنف المناسب. - ---- - -**آخر تحديث:** 2026-03-07 -**تم الاختبار مع:** Aspose.Slides for Java 25.4 (مصنف jdk16) -**المؤلف:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/chinese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/chinese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 86c13b0f3b..c1940db055 100644 --- a/slides/chinese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/chinese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,11 +1,47 @@ --- -date: '2026-03-07' -description: 学习如何使用 Aspose.Slides 在 Java 中创建环形图。本分步指南涵盖 Maven Aspose Slides 依赖设置、图表配置以及保存演示文稿。 +date: '2026-08-16' +description: 了解如何在 Java 中使用 Aspose.Slides 添加环形图。本分步指南涵盖 Maven 依赖设置、图表配置、颜色、标签以及保存 + PPTX。 keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: 使用 Aspose.Slides 在 Java 中创建环形图指南 +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: 如何在 Java 中使用 Aspose.Slides 添加环形图。按照本指南设置 Maven、定制颜色、标签并生成 PPTX 文件。 +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: 如何在 Java 中使用 Aspose.Slides 添加环形图 +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: 如何在 Java 中使用 Aspose.Slides 添加环形图 url: /zh/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -15,48 +51,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# 使用 Aspose.Slides 的 Java 环形图创建指南 +# 如何在 Java 中使用 Aspose.Slides 添加环形图 ## 介绍 -以编程方式创建**环形图**可以将原始数字转化为引人注目的可视化效果，瞬间讲述故事。在 Java 中，**Aspose.Slides** 使此过程变得简单，让您无需打开 PowerPoint 即可生成可直接用于演示的图表。在本教程中，您将学习如何一步步**创建 Java 环形图**——从设置 Maven Aspose Slides 依赖到自定义系列、类别，最后保存演示文稿。 +创建 **环形图** 的程序化方法可以将原始数字转化为引人注目的可视化效果，瞬间讲述一个故事。在 Java 中，**Aspose.Slides** 使这一过程变得简单，允许您在不打开 PowerPoint 的情况下生成可直接用于演示的图表。在本教程中，您将一步步学习 **如何向 PPTX 文件添加环形图**——从设置 Maven Aspose Slides 依赖到自定义系列、类别、颜色和标签，最后保存演示文稿。 -通过本指南，您将能够将动态环形图嵌入任何 PPTX 文件，非常适用于报告、仪表板或自动化幻灯片。 +通过本指南，您将能够将动态环形图嵌入任何 PPTX 文件，适用于报告、仪表盘或自动化幻灯片套件。 ### 快速回答 - **使用的库是什么？** Aspose.Slides for Java -- **主要任务？** 在 PPTX 文件中创建 Java 环形图 +- **主要任务？** 在 PPTX 文件中添加环形图 - **如何添加库？** 使用 Maven Aspose Slides 依赖（或 Gradle） - **最低 Java 版本？** JDK 16 或更高 -- **我可以自定义颜色和标签吗？** 可以，API 提供完整的格式控制 +- **可以自定义颜色和标签吗？** 可以，API 提供完整的格式控制 -## 什么是环形图以及为何使用它？ +## 什么是环形图以及为什么使用它？ -环形图是带有空心中心的饼图变体，允许您在同心环中显示多个数据系列。这使其非常适合在多个类别中比较整体的各部分——比如按地区划分的多季度销售额或部门预算分配。 +环形图是带有空心中心的饼图变体，允许将多个数据系列显示为同心环。**它在多个类别之间可视化整体占比，同时在中心保留空间用于额外信息。** 这使其非常适合比较多个季度的地区销售、部门预算分配，或任何需要展示层级比例数据的场景。 ## 为什么使用 Aspose.Slides for Java？ -- **无需安装 Office** – 在任何服务器上生成 PPTX 文件。 -- **丰富的 API** – 完全控制图表类型、数据点和样式。 -- **高性能** – 针对大型演示文稿进行优化。 -- **跨平台** – 在 Windows、Linux 和 macOS 上均可运行。 +您可以在不安装 Microsoft Office 的情况下添加环形图，且该库支持 **超过 50 种输入和输出格式**，能够处理超过 500 张幻灯片的演示文稿。Aspose.Slides 在相同硬件上相比本地 Office 自动化 **渲染速度提升至 3 倍**，并且兼容 Windows、Linux 和 macOS。这些量化优势意味着您可以在无头服务器上生成大型幻灯片套件，性能可预测。 -## 前提条件 +## 前置条件 -- **必需的库：** - - Aspose.Slides for Java 版本 25.4 或更高。 +- **必需的库** + - Aspose.Slides for Java 25.4 或更高（用于添加环形图的库）。 -- **环境设置：** - - JDK 16 或更高。 - - 您喜欢的 IDE（IntelliJ IDEA、Eclipse、NetBeans 等）。 +- **环境** + - 已在机器上安装 JDK 16 或更高版本。 + - 使用 IntelliJ IDEA、Eclipse 或 NetBeans 等 IDE。 -- **知识前提：** - - 基础 Java 编程。 +- **知识** + - 基础 Java 语法和面向对象概念。 - 熟悉 Maven 或 Gradle 进行依赖管理。 ## Maven Aspose Slides 依赖 -在您的 `pom.xml` 中添加以下 Maven 依赖。这是您需要将库引入项目的 **Maven Aspose Slides 依赖**。 +将以下 Maven 依赖添加到您的 `pom.xml` 中。这是您需要的 **maven aspose slides 依赖**，用于将库拉入项目。 ```xml @@ -70,32 +103,152 @@ weight: 1 如果您更喜欢 Gradle，请使用下面的等效代码片段。 ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -您也可以直接从官方发布页面下载 JAR： +您也可以直接从官方发布页面下载 JAR 包： [ Aspose.Slides for Java 发布 ](https://releases.aspose.com/slides/java/) ### 获取许可证 -要去除评估水印并解锁完整功能集： +要去除评估水印并解锁全部功能： - **免费试用** – 使用临时许可证开始。 -- **临时许可证** – 从[ Aspose 网站](https://purchase.aspose.com/temporary-license/)请求。 -- **商业许可证** – 购买用于生产使用。 +- **临时许可证** – 从 [Aspose 网站](https://purchase.aspose.com/temporary-license/) 请求。 +- **商业许可证** – 购买用于生产环境。 在代码中应用许可证： ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` -## 实现指南 +## 实施指南 ### 初始化演示文稿并添加环形图 -首先，创建或加载演示文稿，并在第一张幻灯片上添加环形图。 +Presentation 是 Aspose.Slides 中表示 PowerPoint 演示文稿的类。 +加载已有的 PPTX 或创建新的 `Presentation` 对象，然后在第一张幻灯片上添加环形图。 + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### 配置图表数据工作簿并清除现有数据 + +工作簿是内部电子表格，用于存储图表的数据。 +获取支撑图表的工作簿，然后清除任何默认的系列或类别，以便从干净的状态开始。 + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### 向图表添加系列 + +系列代表在图表上绘制的一组数据点。 +您可以添加最多 15 个系列。每个系列都可以自定义——这里我们设置了爆炸效果、环形孔大小和首片角度。 + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### 添加类别和数据点 + +类别是图表轴上每个数据点的标签。 +创建 15 个类别并为每个系列填充数据点。最后一个系列会使用特殊的标签格式。 + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### 自定义颜色和数据标签 + +`FillType.Solid` 指定图表元素的实色填充。 +为每个系列设置实色填充并启用数据标签。对于最后一个系列，我们还会更改标签字体颜色。 + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### 保存演示文稿 + +`save` 将演示文稿写入指定格式的文件。 +将更新后的演示文稿以 PPTX 格式写入磁盘，或根据需要导出为 PDF。 + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## 常见问题及解决方案 + +- **未找到许可证** – 验证 `license.lic` 的路径是否正确且文件可读。 +- **图表显示为空白** – 确保在添加新系列/类别之前已清除现有的系列/类别。 +- **颜色不正确** – 确认 `FillType.Solid` 已同时用于填充和线条格式。 +- **大量系列的性能问题** – 限制系列/类别的数量或复用工作簿单元格，以控制内存使用。 + +## 常见问答 + +**Q: 能否在没有预先存在的 PPTX 文件的情况下生成环形图？** +A: 可以，实例化 `new Presentation()` 从空白幻灯片套件开始，然后按上文所示添加图表。 + +**Q: Aspose.Slides 是否支持导出为 PDF？** +A: 当然。创建图表后，调用 `pres.save("output.pdf", SaveFormat.Pdf);` 即可获得幻灯片的 PDF 版本。 + +**Q: 如何更改环形孔的大小？** +A: 使用 `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`，其中 `value` 的取值范围为 0 到 100。 + +**Q: 是否可以为所有系列添加数据标签，而不仅仅是最后一个？** +A: 可以，将标签格式化代码块移出 `if (i == ...)` 条件，应用到每个 `dataPoint`。 + +**Q: 支持哪些 Java 版本？** +A: Aspose.Slides 25.4 支持 JDK 16 及以上。较早的 JDK 需要在 Maven 依赖中使用相应的 classifier。 + +--- + +**最后更新:** 2026-08-16 +**测试环境:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**作者:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -106,10 +259,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### 配置图表数据工作簿并清除现有数据 - -接下来，获取支撑图表的工作簿，并清除任何默认的系列或类别。 - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -120,10 +269,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### 向图表添加系列 - -现在我们将添加最多 15 个系列。每个系列都可以自定义——这里我们设置了爆炸半径、环形孔大小和第一切片角度。 - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -140,10 +285,6 @@ while (seriesIndex < 15) { } ``` -### 添加类别和数据点 - -我们将创建 15 个类别，并为每个系列填充一个数据点。最后一个系列会使用特殊的标签格式。 - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -196,48 +337,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### 保存演示文稿 - -最后，将更新后的演示文稿写入磁盘。 - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## 常见问题及解决方案 - -- **未找到许可证** – 验证 `license.lic` 的路径是否正确且文件可读。 -- **图表为空白** – 确保在添加新系列/类别之前已清除现有的系列/类别。 -- **颜色不正确** – 检查填充和线条格式是否都设置为 `FillType.Solid`。 -- **大量系列的性能** – 限制系列/类别的数量或复用工作簿单元格。 - -## 常见问答 - -**问：我可以在没有预先存在的 PPTX 文件的情况下生成环形图吗？** -**答：** 可以，实例化 `new Presentation()` 从空白幻灯片开始。 +## 相关教程 -**问：Aspose.Slides 是否支持导出为 PDF？** -**答：** 当然。创建图表后，调用 `pres.save("output.pdf", SaveFormat.Pdf);`。 +- [如何使用 Aspose.Slides for Java 向 PowerPoint 添加图表：一步步指南](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [如何在 Java 中使用 Aspose.Slides 自定义饼图颜色 – 完整指南](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [使用 Aspose.Slides for Java 为 PowerPoint 图表类别添加动画 | 步骤指南](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**问：如何更改环形孔的大小？** -**答：** 使用 `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`，其中 value 为 0‑100。 - -**问：是否可以为所有系列添加数据标签，而不仅仅是最后一个？** -**答：** 可以，将标签格式化块移出 `if (i == ...)` 条件，并对每个 `dataPoint` 应用。 - -**问：支持哪些 Java 版本？** -**答：** Aspose.Slides 25.4 支持 JDK 16 及更高版本。较早的 JDK 需要相应的分类器。 - ---- - -**最后更新：** 2026-03-07 -**测试环境：** Aspose.Slides for Java 25.4（jdk16 分类器） -**作者：** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/czech/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/czech/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index ba7b06336b..aba93347f8 100644 --- a/slides/czech/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/czech/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Naučte se, jak vytvořit prstencový graf v Javě pomocí Aspose.Slides. - Tento průvodce krok za krokem pokrývá nastavení závislosti Maven Aspose Slides, - konfiguraci grafu a ukládání prezentací. +date: '2026-08-16' +description: Naučte se, jak přidat prstencové grafy v Javě pomocí Aspose.Slides. Tento + průvodce krok za krokem pokrývá nastavení závislosti Maven, konfiguraci grafu, barvy, + popisky a uložení PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Vytvořte prstencový graf v Javě s průvodcem Aspose.Slides +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Jak přidat prstencové grafy v Javě pomocí Aspose.Slides. Postupujte + podle tohoto průvodce a nastavte Maven, přizpůsobte barvy, popisky a vytvořte soubory + PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Jak přidat prstencový graf v Javě s Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Jak přidat prstencový graf v Javě s Aspose.Slides url: /cs/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Vytvoření prstencového grafu v Javě s Aspose.Slides průvodcem +# Jak přidat prstencový graf v Javě s Aspose.Slides ## Úvod -Vytvoření **doughnut chart** programově může proměnit surová čísla v poutavý vizuál, který okamžitě vypráví příběh. V Javě **Aspose.Slides** tento proces zjednodušuje a umožňuje generovat grafy připravené do prezentace, aniž byste museli otevírat PowerPoint. V tomto tutoriálu se naučíte, jak **create doughnut chart java** krok za krokem – od nastavení Maven závislosti Aspose Slides po přizpůsobení sérií, kategorií a nakonec uložení prezentace. +Vytvoření **doughnut chart** programově může proměnit surová čísla v poutavý vizuál, který okamžitě vypráví příběh. V Javě **Aspose.Slides** tento proces zjednodušuje a umožňuje generovat grafy připravené do prezentace, aniž byste museli otevírat PowerPoint. V tomto tutoriálu se naučíte **jak přidat doughnut** grafy do souboru PPTX krok za krokem – od nastavení Maven závislosti Aspose Slides po přizpůsobení sérií, kategorií, barev a popisků a nakonec uložení prezentace. -Na konci tohoto průvodce budete schopni vložit dynamické prstencové grafy do libovolného souboru PPTX, ideální pro zprávy, dashboardy nebo automatizované sady snímků. +Na konci tohoto průvodce budete schopni vložit dynamické doughnut grafy do libovolného souboru PPTX, ideální pro zprávy, dashboardy nebo automatizované sady snímků. ### Rychlé odpovědi -- **Jaká knihovna se používá?** Aspose.Slides for Java -- **Hlavní úkol?** Create doughnut chart java v souboru PPTX -- **Jak přidat knihovnu?** Použijte Maven Aspose Slides dependency (nebo Gradle) -- **Minimální verze Javy?** JDK 16 nebo vyšší -- **Mohu přizpůsobit barvy a popisky?** Ano, API poskytuje plnou kontrolu formátování +- **What library is used?** Aspose.Slides for Java +- **Primary task?** Add a doughnut chart in a PPTX file +- **How to add the library?** Use the Maven Aspose Slides dependency (or Gradle) +- **Minimum Java version?** JDK 16 or higher +- **Can I customize colors and labels?** Yes, the API provides full formatting control -## Co je prstencový graf a proč jej používat? +## Co je doughnut chart a proč jej použít? -Prstencový graf je variací koláčového grafu s prázdným středem, který umožňuje zobrazit více datových sérií v soustředných kruzích. To jej činí ideálním pro porovnání částí celku napříč několika kategoriemi – například prodeje podle regionu během několika čtvrtletí nebo rozdělení rozpočtu mezi oddělení. +Doughnut chart je variací koláčového grafu s prázdným středem, což umožňuje zobrazit více datových sérií jako soustředné kruhy. **Vizualizuje části celku napříč několika kategoriemi a zároveň zachovává prostor pro další informace ve středu.** To jej činí ideálním pro porovnání prodeje podle regionů během několika čtvrtletí, rozdělení rozpočtu mezi odděleními nebo jakýkoli scénář, kde je potřeba zobrazit hierarchická podílová data. -## Proč použít Aspose.Slides pro Java? +## Proč použít Aspose.Slides pro Javu? -- **Není vyžadována instalace Office** – generujte soubory PPTX na jakémkoli serveru. -- **Bohaté API** – plná kontrola nad typy grafů, datovými body a stylováním. -- **Vysoký výkon** – optimalizováno pro velké prezentace. -- **Cross‑platform** – funguje na Windows, Linuxu i macOS. +Můžete přidat doughnut chart bez instalace Microsoft Office a knihovna zpracovává **více než 50 + vstupních a výstupních formátů** a zároveň zvládá prezentace přesahující 500 snímků. Aspose.Slides poskytuje **až 3× rychlejší vykreslování** ve srovnání s nativní automatizací Office na stejném hardware a funguje na Windows, Linuxu i macOS. Tyto kvantifikované výhody znamenají, že můžete generovat velké sady snímků na serverech bez grafického rozhraní s předvídatelným výkonem. ## Požadavky -- **Požadované knihovny:** - - Aspose.Slides for Java verze 25.4 nebo novější. +- **Required libraries** + - Aspose.Slides for Java 25.4 nebo novější (knihovna, která umožňuje přidávat doughnut grafy). -- **Nastavení prostředí:** - - JDK 16 nebo vyšší. - - Vaše oblíbené IDE (IntelliJ IDEA, Eclipse, NetBeans, atd.). +- **Environment** + - JDK 16 nebo vyšší nainstalovaný na vašem počítači. + - IDE jako IntelliJ IDEA, Eclipse nebo NetBeans. -- **Předpoklady znalostí:** - - Základy programování v Javě. - - Znalost Maven nebo Gradle pro správu závislostí. +- **Knowledge** + - Základní syntaxe Javy a objektově orientované koncepty. + - Znalost Maven nebo Gradle pro správu závislostí. ## Maven závislost Aspose Slides -Přidejte následující Maven závislost do souboru `pom.xml`. Toto je **maven aspose slides dependency**, kterou potřebujete k načtení knihovny do projektu. +Přidejte následující Maven závislost do vašeho `pom.xml`. Toto je **maven aspose slides dependency**, kterou potřebujete pro stažení knihovny do projektu. ```xml @@ -72,32 +106,152 @@ Přidejte následující Maven závislost do souboru `pom.xml`. Toto je **maven Pokud dáváte přednost Gradle, použijte níže uvedený ekvivalentní úryvek. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` Můžete také stáhnout JAR přímo z oficiální stránky vydání: -[Vydání Aspose.Slides pro Java](https://releases.aspose.com/slides/java/) +[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) ### Získání licence -Pro odstranění vodotisku hodnocení a odemčení plného souboru funkcí: +Pro odstranění testovacího vodoznaku a odemčení plné sady funkcí: -- **Bezplatná zkušební verze** – začněte s dočasnou licencí. -- **Dočasná licence** – požádejte o ni na [Aspose webu](https://purchase.aspose.com/temporary-license/). -- **Komerční licence** – zakupte pro produkční použití. +- **Free trial** – začněte s dočasnou licencí. +- **Temporary license** – požádejte o ni na [Aspose website](https://purchase.aspose.com/temporary-license/). +- **Commercial license** – zakupte pro produkční použití. -Aplikujte licenci ve svém kódu: +Apply the license in your code: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## Průvodce implementací -### Inicializace prezentace a přidání prstencového grafu +### Inicializace prezentace a přidání doughnut grafu + +Presentation je třída Aspose.Slides, která představuje prezentaci PowerPoint. +Načtěte existující PPTX nebo vytvořte nový objekt `Presentation`, poté přidejte doughnut graf na první snímek. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Konfigurace pracovního sešitu grafu a vymazání existujících dat + +Workbook je interní tabulka, která ukládá data grafu. +Získejte workbook, který graf podporuje, a poté vymažte všechny výchozí série nebo kategorie, abyste mohli začít s čistým štítem. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Přidání sérií do grafu -Nejprve vytvořte nebo načtěte prezentaci a přidejte prstencový graf na první snímek. +Série představuje kolekci datových bodů vykreslených v grafu. +Můžete přidat až 15 sérií. Každá série může být přizpůsobena – zde nastavujeme explozi, velikost středu doughnut a úhel prvního výseku. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Přidání kategorií a datových bodů + +Kategorie jsou popisky pro každý datový bod podél osy grafu. +Vytvořte 15 kategorií a naplňte každou sérii datovým bodem. Poslední série získá speciální formátování popisků. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Přizpůsobení barev a datových popisků + +`FillType.Solid` určuje plnou barvu výplně pro prvky grafu. +Nastavte plnou barvu výplně pro každou sérii a povolte datové popisky. Pro poslední sérii také měníme barvu písma popisku. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Uložení prezentace + +`save` zapíše prezentaci do souboru ve zvoleném formátu. +Uložte aktualizovanou prezentaci na disk ve formátu PPTX nebo exportujte do PDF, pokud je to potřeba. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Časté problémy a řešení + +- **License not found** – Ověřte, že cesta k `license.lic` je správná a soubor je čitelný. +- **Chart appears blank** – Ujistěte se, že jste před přidáním nových vymazali existující série/kategorie. +- **Incorrect colors** – Potvrďte, že `FillType.Solid` je nastaven pro výplň i formát čáry. +- **Performance with many series** – Omezte počet sérií/kategorií nebo znovu použijte buňky workbooku, aby byl paměťový výdej pod kontrolou. + +## Často kladené otázky + +**Q: Mohu vygenerovat doughnut chart bez předem existujícího souboru PPTX?** +A: Ano, vytvořte instancí `new Presentation()` a začněte s prázdnou sadou snímků, poté přidejte graf podle výše uvedeného postupu. + +**Q: Podporuje Aspose.Slides export do PDF?** +A: Rozhodně. Po vytvoření grafu zavolejte `pres.save("output.pdf", SaveFormat.Pdf);` a získáte PDF verzi snímku. + +**Q: Jak změním velikost středu doughnut?** +A: Použijte `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`, kde `value` je v rozmezí 0 – 100. + +**Q: Je možné přidat datové popisky ke všem sériím, ne jen k poslední?** +A: Ano, přesuňte blok formátování popisků mimo podmínku `if (i == ...)` a aplikujte jej na každý `dataPoint`. + +**Q: Jaké verze Javy jsou podporovány?** +A: Aspose.Slides 25.4 podporuje JDK 16 a novější. Starší JDK vyžadují odpovídající classifier v Maven závislosti. + +--- + +**Last Updated:** 2026-08-16 +**Tested With:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Author:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Konfigurace sešitu dat grafu a vymazání existujících dat - -Dále získejte sešit, který podporuje graf, a vymažte všechny výchozí série nebo kategorie. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Přidání sérií do grafu - -Nyní přidáme až 15 sérií. Každá série může být přizpůsobena – zde nastavujeme explozi, velikost díry prstence a úhel první výseče. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Přidání kategorií a datových bodů - -Vytvoříme 15 kategorií a naplníme každou sérii datovým bodem. Poslední série získá speciální formátování popisků. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Uložení prezentace - -Nakonec zapište aktualizovanou prezentaci na disk. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Časté problémy a řešení - -- **Licence nebyla nalezena** – Ověřte, že cesta k `license.lic` je správná a soubor je čitelný. -- **Graf je prázdný** – Ujistěte se, že jste před přidáním nových sérií/kategorií vymazali existující. -- **Nesprávné barvy** – Zkontrolujte, že `FillType.Solid` je nastaven pro výplň i formát čáry. -- **Výkon při mnoha sériích** – Omezte počet sérií/kategorií nebo znovu použijte buňky sešitu. +## Související tutoriály -## Často kladené otázky +- [Jak přidat graf do PowerPointu pomocí Aspose.Slides pro Java: Průvodce krok za krokem](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Jak přizpůsobit barvy koláčových grafů v Javě s Aspose.Slides – Kompletní průvodce](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Animovat kategorie grafu v PowerPointu pomocí Aspose.Slides pro Java | Průvodce krok za krokem](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: Mohu vygenerovat prstencový graf bez předem existujícího souboru PPTX?** -A: Ano, vytvořte instancí `new Presentation()` a začněte s prázdnou sadou snímků. - -**Q: Podporuje Aspose.Slides export do PDF?** -A: Rozhodně. Po vytvoření grafu zavolejte `pres.save("output.pdf", SaveFormat.Pdf);`. - -**Q: Jak změním velikost díry prstence?** -A: Použijte `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`, kde hodnota je 0‑100. - -**Q: Je možné přidat datové popisky ke všem sériím, ne jen k poslední?** -A: Ano, přesuňte blok formátování popisků mimo podmínku `if (i == ...)` a aplikujte jej na každý `dataPoint`. - -**Q: Jaké verze Javy jsou podporovány?** -A: Aspose.Slides 25.4 podporuje JDK 16 a novější. Starší JDK vyžadují odpovídající klasifikátor. - ---- - -**Poslední aktualizace:** 2026-03-07 -**Testováno s:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Autor:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/dutch/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/dutch/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index a32350b4b1..e6a1c1db2c 100644 --- a/slides/dutch/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/dutch/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Leer hoe je een donutgrafiek in Java maakt met Aspose.Slides. Deze stapsgewijze - gids behandelt het instellen van de Maven Aspose Slides‑afhankelijkheid, grafiekconfiguratie - en het opslaan van presentaties. +date: '2026-08-16' +description: Leer hoe je donutgrafieken kunt toevoegen in Java met Aspose.Slides. + Deze stapsgewijze handleiding behandelt het instellen van Maven‑afhankelijkheden, + grafiekconfiguratie, kleuren, labels en het opslaan van de PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Maak een donutgrafiek in Java met de Aspose.Slides-gids +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Hoe je donutgrafieken kunt toevoegen in Java met Aspose.Slides. Volg + deze handleiding om Maven in te stellen, kleuren en labels aan te passen en PPTX‑bestanden + te genereren. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Hoe een donutgrafiek toe te voegen in Java met Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Hoe een donutgrafiek toe te voegen in Java met Aspose.Slides url: /nl/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Maak doughnut chart Java met Aspose.Slides-gids +# Hoe een donutgrafiek toe te voegen in Java met Aspose.Slides -## Inleiding +## Introductie -Het programmatically maken van een **doughnut chart** kan ruwe cijfers omzetten in een opvallende visual die meteen een verhaal vertelt. In Java maakt **Aspose.Slides** dit proces eenvoudig, zodat je presentatieklaar diagrammen kunt genereren zonder PowerPoint te openen. In deze tutorial leer je hoe je **create doughnut chart java** stap voor stap kunt doen — van het instellen van de Maven Aspose Slides‑dependency tot het aanpassen van series, categorieën en uiteindelijk het opslaan van de presentatie. +Het programmatically maken van een **donutgrafiek** kan ruwe cijfers omzetten in een opvallende visual die meteen een verhaal vertelt. In Java maakt **Aspose.Slides** dit proces eenvoudig, waardoor je presentatiewaardige grafieken kunt genereren zonder PowerPoint te openen. In deze tutorial leer je **hoe je donutgrafieken** toevoegt aan een PPTX‑bestand stap voor stap — van het instellen van de Maven Aspose Slides‑dependency tot het aanpassen van series, categorieën, kleuren en labels, en uiteindelijk het opslaan van de presentatie. -Aan het einde van deze gids kun je dynamische doughnut charts in elk PPTX‑bestand insluiten, perfect voor rapporten, dashboards of geautomatiseerde presentaties. +Aan het einde van deze gids kun je dynamische donutgrafieken in elk PPTX‑bestand insluiten, perfect voor rapporten, dashboards of geautomatiseerde presentaties. ### Snelle antwoorden - **Welke bibliotheek wordt gebruikt?** Aspose.Slides for Java -- **Primaire taak?** Create doughnut chart java in a PPTX file -- **Hoe voeg je de bibliotheek toe?** Use the Maven Aspose Slides dependency (or Gradle) -- **Minimale Java‑versie?** JDK 16 or higher -- **Kan ik kleuren en labels aanpassen?** Yes, the API provides full formatting control +- **Primaire taak?** Een donutgrafiek toevoegen in een PPTX‑bestand +- **Hoe voeg je de bibliotheek toe?** Gebruik de Maven Aspose Slides‑dependency (of Gradle) +- **Minimale Java‑versie?** JDK 16 of hoger +- **Kan ik kleuren en labels aanpassen?** Ja, de API biedt volledige opmaakcontrole -## Wat is een doughnut chart en waarom gebruiken? +## Wat is een donutgrafiek en waarom gebruiken? -Een doughnut chart is een variant van een taartdiagram met een leeg midden, waardoor je meerdere gegevensreeksen in concentrische ringen kunt weergeven. Dit maakt het ideaal voor het vergelijken van delen van een geheel over verschillende categorieën — denk aan verkoop per regio over meerdere kwartalen of budgettoewijzingen per afdeling. +Een donutgrafiek is een variant van een taartgrafiek met een lege kern, waardoor meerdere gegevensreeksen als concentrische ringen kunnen worden weergegeven. **Het visualiseert delen‑van‑een‑geheel over verschillende categorieën terwijl er ruimte behouden blijft voor extra informatie in het midden.** Dit maakt het ideaal voor het vergelijken van verkoop per regio over meerdere kwartalen, budgettoewijzingen per afdeling, of elke situatie waarin je hiërarchische proportiedata moet tonen. ## Waarom Aspose.Slides voor Java gebruiken? -- **No Office installation required** – genereer PPTX‑bestanden op elke server. -- **Rich API** – volledige controle over diagramtypen, gegevenspunten en styling. -- **High performance** – geoptimaliseerd voor grote presentaties. -- **Cross‑platform** – werkt op Windows, Linux en macOS. +Je kunt een donutgrafiek toevoegen zonder Microsoft Office te installeren, en de bibliotheek verwerkt **meer dan 50 + invoer‑ en uitvoerformaten** terwijl hij presentaties aankan die meer dan 500 dia's bevatten. Aspose.Slides levert **tot 3× snellere rendering** vergeleken met native Office‑automatisering op dezelfde hardware, en werkt op Windows, Linux en macOS. Deze kwantificeerbare voordelen betekenen dat je grote presentaties kunt genereren op headless servers met voorspelbare prestaties. ## Vereisten -- **Vereiste bibliotheken:** - - Aspose.Slides for Java version 25.4 of later. +- **Vereiste bibliotheken** + - Aspose.Slides for Java 25.4 of later (de bibliotheek die je in staat stelt donutgrafieken toe te voegen). -- **Omgevingsconfiguratie:** - - JDK 16 or higher. - - Your favorite IDE (IntelliJ IDEA, Eclipse, NetBeans, etc.). +- **Omgeving** + - JDK 16 of hoger geïnstalleerd op je machine. + - Een IDE zoals IntelliJ IDEA, Eclipse of NetBeans. -- **Vereiste kennis:** - - Basic Java programming. - - Familiarity with Maven or Gradle for dependency management. +- **Kennis** + - Basis Java‑syntaxis en object‑georiënteerde concepten. + - Vertrouwdheid met Maven of Gradle voor dependency‑beheer. -## Maven Aspose Slides Dependency +## Maven Aspose Slides‑dependency -Voeg de volgende Maven‑dependency toe aan je `pom.xml`. Dit is de **maven aspose slides dependency** die je nodig hebt om de bibliotheek in je project te halen. +Voeg de volgende Maven‑dependency toe aan je `pom.xml`. Dit is de **Maven Aspose Slides‑dependency** die je nodig hebt om de bibliotheek in je project te halen. ```xml @@ -69,35 +103,155 @@ Voeg de volgende Maven‑dependency toe aan je `pom.xml`. Dit is de **maven aspo ``` -Als je Gradle verkiest, gebruik dan het equivalente fragment hieronder. +Als je de voorkeur geeft aan Gradle, gebruik dan het equivalente fragment hieronder. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -Je kunt de JAR ook direct downloaden van de officiële release‑pagina: -[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) +U kunt de JAR ook rechtstreeks downloaden van de officiële release‑pagina: +[ Aspose.Slides voor Java releases ](https://releases.aspose.com/slides/java/) ### Een licentie verkrijgen -Om de evaluatiewatermerk te verwijderen en de volledige functionaliteit te ontgrendelen: +Om het evaluatiewatermerk te verwijderen en de volledige functionaliteit te ontgrendelen: -- **Free trial** – Gratis proefversie – start met een tijdelijke licentie. -- **Temporary license** – Tijdelijke licentie – request one from the [Aspose website](https://purchase.aspose.com/temporary-license/). -- **Commercial license** – Commerciële licentie – purchase for production use. +- **Gratis proefversie** – begin met een tijdelijke licentie. +- **Tijdelijke licentie** – vraag er een aan via de [Aspose‑website](https://purchase.aspose.com/temporary-license/). +- **Commerciële licentie** – koop voor productiegebruik. Pas de licentie toe in je code: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## Implementatie‑gids -### Presentatie initialiseren en een doughnut chart toevoegen +### Een presentatie initialiseren en een donutgrafiek toevoegen + +Presentation is de Aspose.Slides‑klasse die een PowerPoint‑presentatie vertegenwoordigt. +Laad een bestaande PPTX of maak een nieuw `Presentation`‑object aan, en voeg vervolgens een donutgrafiek toe aan de eerste dia. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Het configureren van de grafiek‑databoek en het wissen van bestaande gegevens + +Het werkboek is een intern spreadsheet dat de gegevens van de grafiek opslaat. +Verkrijg het werkboek dat de grafiek ondersteunt, en wis vervolgens eventuele standaardreeksen of -categorieën zodat je met een schone lei kunt beginnen. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Series toevoegen aan de grafiek + +Een serie vertegenwoordigt een verzameling gegevenspunten die op de grafiek worden geplot. +Je kunt tot 15 series toevoegen. Elke serie kan worden aangepast — hier stellen we de explosie, de grootte van het donut‑gat en de hoek van het eerste segment in. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Categorieën en gegevenspunten toevoegen + +Categorieën zijn de labels voor elk gegevenspunt langs de as van de grafiek. +Maak 15 categorieën aan en vul elke serie met een gegevenspunt. De laatste serie krijgt speciale labelopmaak. -Eerst maak of laad je een presentatie en voeg je een doughnut chart toe aan de eerste dia. +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Kleuren en gegevenslabels aanpassen + +`FillType.Solid` specificeert een effen vulkleur voor grafiekelementen. +Stel een effen vulkleur in voor elke serie en schakel gegevenslabels in. Voor de laatste serie wijzigen we ook de letterkleur van het label. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### De presentatie opslaan + +`save` schrijft de presentatie naar een bestand in het gekozen formaat. +Schrijf de bijgewerkte presentatie naar schijf in PPTX‑formaat, of exporteer naar PDF indien nodig. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Veelvoorkomende problemen en oplossingen + +- **Licentie niet gevonden** – Controleer of het pad naar `license.lic` correct is en het bestand leesbaar is. +- **Grafiek verschijnt leeg** – Zorg ervoor dat je bestaande series/categorieën hebt gewist voordat je nieuwe toevoegt. +- **Onjuiste kleuren** – Controleer of `FillType.Solid` is ingesteld voor zowel vul‑ als lijnformaten. +- **Prestaties bij veel series** – Beperk het aantal series/categorieën of hergebruik werkboekcellen om het geheugenverbruik onder controle te houden. + +## Veelgestelde vragen + +**V: Kan ik een donutgrafiek genereren zonder een bestaande PPTX‑file?** +A: Ja, maak een `new Presentation()` aan om vanuit een lege presentatiereeks te beginnen, en voeg vervolgens een grafiek toe zoals hierboven getoond. + +**V: Ondersteunt Aspose.Slides exporteren naar PDF?** +A: Zeker. Na het maken van de grafiek roep je `pres.save("output.pdf", SaveFormat.Pdf);` aan om een PDF‑versie van de dia te krijgen. + +**V: Hoe wijzig ik de grootte van het donut‑gat?** +A: Gebruik `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` waarbij `value` varieert van 0 tot 100. + +**V: Is het mogelijk om gegevenslabels toe te voegen aan alle series, niet alleen de laatste?** +A: Ja, verplaats het label‑opmaakblok buiten de `if (i == ...)`‑conditie en pas het toe op elk `dataPoint`. + +**V: Welke Java‑versies worden ondersteund?** +A: Aspose.Slides 25.4 ondersteunt JDK 16 en nieuwer. Oudere JDK’s vereisen de juiste classifier in de Maven‑dependency. + +--- + +**Laatst bijgewerkt:** 2026-08-16 +**Getest met:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Auteur:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Het chart‑data‑werkboek configureren en bestaande gegevens wissen - -Vervolgens haal je het werkboek op dat de chart ondersteunt en wis je eventuele standaardreeksen of -categorieën. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Series aan de chart toevoegen - -Nu voegen we tot 15 series toe. Elke series kan worden aangepast — hier stellen we de explosie, de doughnut‑hole‑grootte en de eerste‑slice‑hoek in. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Categorieën en gegevenspunten toevoegen - -We maken 15 categorieën aan en vullen elke series met een gegevenspunt. De laatste series krijgt een speciale labelopmaak. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### De presentatie opslaan - -Tot slot schrijf je de bijgewerkte presentatie naar schijf. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Veelvoorkomende problemen en oplossingen - -- **License not found** – Licentie niet gevonden – Verify the path to `license.lic` is correct and the file is readable. -- **Chart appears blank** – Chart verschijnt leeg – Ensure you cleared existing series/categories before adding new ones. -- **Incorrect colors** – Onjuiste kleuren – Check that `FillType.Solid` is set for both fill and line formats. -- **Performance with many series** – Prestaties bij veel series – Limit the number of series/categories or reuse the workbook cells. - -## Veelgestelde vragen - -**Q: Can I generate a doughnut chart without a pre‑existing PPTX file?** -A: Ja, instantiate `new Presentation()` om te beginnen met een lege slide deck. - -**Q: Does Aspose.Slides support exporting to PDF?** -A: Absoluut. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);`. +## Gerelateerde tutorials -**Q: How do I change the doughnut hole size?** -A: Gebruik `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` waarbij value 0‑100 is. +- [Hoe een grafiek toe te voegen aan PowerPoint met Aspose.Slides voor Java: Een stapsgewijze handleiding](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Hoe taartgrafiekkleuren aanpassen in Java met Aspose.Slides – Een volledige gids](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [PowerPoint‑grafiekcategorieën animeren met Aspose.Slides voor Java | Stapsgewijze handleiding](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: Is it possible to add data labels to all series, not just the last one?** -A: Ja, verplaats het label‑formatting‑blok buiten de `if (i == ...)`‑conditie en pas het toe op elk `dataPoint`. - -**Q: What versions of Java are supported?** -A: Aspose.Slides 25.4 ondersteunt JDK 16 en nieuwer. Oudere JDK's vereisen de juiste classifier. - ---- - -**Laatst bijgewerkt:** 2026-03-07 -**Getest met:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Auteur:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/english/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/english/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 671403310f..62eab99a1b 100644 --- a/slides/english/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/english/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,53 @@ --- -title: "Create Doughnut Chart Java with Aspose.Slides Guide" -description: "Learn how to create doughnut chart java using Aspose.Slides. This step‑by‑step guide covers Maven Aspose Slides dependency setup, chart configuration, and saving presentations." -date: "2026-03-07" -weight: 1 -url: "/java/charts-graphs/create-doughnut-charts-java-aspose-slides/" +date: '2026-08-16' +description: Learn how to add doughnut charts in Java using Aspose.Slides. This step‑by‑step + guide covers Maven dependency setup, chart configuration, colors, labels and saving + the PPTX. +images: +- /java/charts-graphs/create-doughnut-charts-java-aspose-slides/og-image.png keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: How to add doughnut charts in Java using Aspose.Slides. Follow this + guide to set up Maven, customize colors, labels and generate PPTX files. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: How to add doughnut chart in Java with Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: How to add doughnut chart in Java with Aspose.Slides +url: /java/charts-graphs/create-doughnut-charts-java-aspose-slides/ +weight: 1 --- {{< blocks/products/pf/main-wrap-class >}} @@ -15,46 +55,43 @@ keywords: {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Create Doughnut Chart Java with Aspose.Slides Guide +# How to add doughnut chart in Java with Aspose.Slides ## Introduction -Creating a **doughnut chart** programmatically can turn raw numbers into an eye‑catching visual that instantly tells a story. In Java, **Aspose.Slides** makes this process straightforward, letting you generate presentation‑ready charts without ever opening PowerPoint. In this tutorial you’ll learn how to **create doughnut chart java** step by step— from setting up the Maven Aspose Slides dependency to customizing series, categories, and finally saving the presentation. +Creating a **doughnut chart** programmatically can turn raw numbers into an eye‑catching visual that instantly tells a story. In Java, **Aspose.Slides** makes this process straightforward, letting you generate presentation‑ready charts without ever opening PowerPoint. In this tutorial you’ll learn **how to add doughnut** charts to a PPTX file step by step— from setting up the Maven Aspose Slides dependency to customizing series, categories, colors, and labels, and finally saving the presentation. By the end of this guide you’ll be able to embed dynamic doughnut charts into any PPTX file, perfect for reports, dashboards, or automated slide decks. ### Quick Answers - **What library is used?** Aspose.Slides for Java -- **Primary task?** Create doughnut chart java in a PPTX file +- **Primary task?** Add a doughnut chart in a PPTX file - **How to add the library?** Use the Maven Aspose Slides dependency (or Gradle) - **Minimum Java version?** JDK 16 or higher - **Can I customize colors and labels?** Yes, the API provides full formatting control -## What is a Doughnut Chart and Why Use It? +## What is a doughnut chart and why use it? -A doughnut chart is a variation of a pie chart with a blank center, allowing you to display multiple data series in concentric rings. This makes it ideal for comparing parts of a whole across several categories—think sales by region over multiple quarters or budget allocations across departments. +A doughnut chart is a variation of a pie chart with a blank centre, allowing multiple data series to be displayed as concentric rings. **It visualizes parts‑of‑a‑whole across several categories while preserving space for additional information in the centre.** This makes it ideal for comparing sales by region over multiple quarters, budget allocations across departments, or any scenario where you need to show hierarchical proportion data. -## Why Use Aspose.Slides for Java? +## Why use Aspose.Slides for Java? -- **No Office installation required** – generate PPTX files on any server. -- **Rich API** – full control over chart types, data points, and styling. -- **High performance** – optimized for large presentations. -- **Cross‑platform** – works on Windows, Linux, and macOS. +You can add a doughnut chart without installing Microsoft Office, and the library processes **over 50 + input and output formats** while handling presentations that exceed 500 slides. Aspose.Slides delivers **up to 3× faster rendering** compared with native Office automation on the same hardware, and it works on Windows, Linux and macOS. These quantified benefits mean you can generate large slide decks on headless servers with predictable performance. ## Prerequisites -- **Required Libraries:** - - Aspose.Slides for Java version 25.4 or later. +- **Required libraries** + - Aspose.Slides for Java 25.4 or later (the library that enables you to add doughnut charts). -- **Environment Setup:** - - JDK 16 or higher. - - Your favorite IDE (IntelliJ IDEA, Eclipse, NetBeans, etc.). +- **Environment** + - JDK 16 or higher installed on your machine. + - An IDE such as IntelliJ IDEA, Eclipse or NetBeans. -- **Knowledge Prerequisites:** - - Basic Java programming. - - Familiarity with Maven or Gradle for dependency management. +- **Knowledge** + - Basic Java syntax and object‑oriented concepts. + - Familiarity with Maven or Gradle for dependency management. -## Maven Aspose Slides Dependency +## Maven Aspose Slides dependency Add the following Maven dependency to your `pom.xml`. This is the **maven aspose slides dependency** you need to pull the library into your project. @@ -70,13 +107,13 @@ Add the following Maven dependency to your `pom.xml`. This is the **maven aspose If you prefer Gradle, use the equivalent snippet below. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` You can also download the JAR directly from the official release page: [ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) -### Acquiring a License +### Acquiring a license To remove the evaluation watermark and unlock the full feature set: @@ -88,14 +125,134 @@ Apply the license in your code: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); +``` + +## Implementation guide + +### Initializing a presentation and adding a doughnut chart + +Presentation is the Aspose.Slides class that represents a PowerPoint presentation. +Load an existing PPTX or create a new `Presentation` object, then add a doughnut chart to the first slide. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Configuring the chart data workbook and clearing existing data + +The workbook is an internal spreadsheet that stores the chart’s data. +Obtain the workbook that backs the chart, then clear any default series or categories so you can start with a clean slate. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); ``` -## Implementation Guide +### Adding series to the chart -### Initializing Presentation and Adding a Doughnut Chart +A series represents a collection of data points plotted on the chart. +You can add up to 15 series. Each series can be customized—here we set the explosion, doughnut‑hole size, and first‑slice angle. -First, create or load a presentation and add a doughnut chart to the first slide. +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Adding categories and data points + +Categories are the labels for each data point along the chart’s axis. +Create 15 categories and populate each series with a data point. The last series receives special label formatting. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Customizing colors and data labels + +`FillType.Solid` specifies a solid fill color for chart elements. +Set a solid fill color for each series and enable data labels. For the final series we also change the label font color. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Saving the presentation + +`save` writes the presentation to a file in the chosen format. +Write the updated presentation to disk in PPTX format, or export to PDF if required. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Common issues and solutions + +- **License not found** – Verify the path to `license.lic` is correct and the file is readable. +- **Chart appears blank** – Ensure you cleared existing series/categories before adding new ones. +- **Incorrect colors** – Confirm that `FillType.Solid` is set for both fill and line formats. +- **Performance with many series** – Limit the number of series/categories or reuse workbook cells to keep memory usage under control. + +## Frequently asked questions + +**Q: Can I generate a doughnut chart without a pre‑existing PPTX file?** +A: Yes, instantiate `new Presentation()` to start from a blank slide deck, then add a chart as shown above. + +**Q: Does Aspose.Slides support exporting to PDF?** +A: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` to get a PDF version of the slide. + +**Q: How do I change the doughnut hole size?** +A: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` where `value` ranges from 0 to 100. + +**Q: Is it possible to add data labels to all series, not just the last one?** +A: Yes, move the label‑formatting block outside the `if (i == ...)` condition and apply it to each `dataPoint`. + +**Q: What versions of Java are supported?** +A: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the appropriate classifier in the Maven dependency. + +--- + +**Last Updated:** 2026-08-16 +**Tested With:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Author:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -106,10 +263,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Configuring the Chart Data Workbook and Clearing Existing Data - -Next, obtain the workbook that backs the chart and clear any default series or categories. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -120,10 +273,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Adding Series to the Chart - -Now we’ll add up to 15 series. Each series can be customized—here we set the explosion, doughnut‑hole size, and first‑slice angle. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -140,10 +289,6 @@ while (seriesIndex < 15) { } ``` -### Adding Categories and Data Points - -We’ll create 15 categories and populate each series with a data point. The last series receives special label formatting. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -196,48 +341,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Saving the Presentation - -Finally, write the updated presentation to disk. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Common Issues and Solutions - -- **License not found** – Verify the path to `license.lic` is correct and the file is readable. -- **Chart appears blank** – Ensure you cleared existing series/categories before adding new ones. -- **Incorrect colors** – Check that `FillType.Solid` is set for both fill and line formats. -- **Performance with many series** – Limit the number of series/categories or reuse the workbook cells. +## Related Tutorials -## Frequently Asked Questions +- [How to Add Chart to PowerPoint Using Aspose.Slides for Java: A Step‑By‑Step Guide](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [How to Customize Pie Chart Colors in Java with Aspose.Slides – A Complete Guide](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Animate PowerPoint Chart Categories with Aspose.Slides for Java | Step-by-Step Guide](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: Can I generate a doughnut chart without a pre‑existing PPTX file?** -A: Yes, instantiate `new Presentation()` to start from a blank slide deck. - -**Q: Does Aspose.Slides support exporting to PDF?** -A: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);`. - -**Q: How do I change the doughnut hole size?** -A: Use `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` where value is 0‑100. - -**Q: Is it possible to add data labels to all series, not just the last one?** -A: Yes, move the label‑formatting block outside the `if (i == ...)` condition and apply it to each `dataPoint`. - -**Q: What versions of Java are supported?** -A: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the appropriate classifier. - ---- - -**Last Updated:** 2026-03-07 -**Tested With:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Author:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/english/java/charts-graphs/create-doughnut-charts-java-aspose-slides/og-image.png b/slides/english/java/charts-graphs/create-doughnut-charts-java-aspose-slides/og-image.png new file mode 100644 index 0000000000..84950441c4 Binary files /dev/null and b/slides/english/java/charts-graphs/create-doughnut-charts-java-aspose-slides/og-image.png differ diff --git a/slides/french/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/french/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index b5c441221e..ea6a99801d 100644 --- a/slides/french/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/french/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Apprenez à créer un graphique en anneau en Java avec Aspose.Slides. Ce - guide étape par étape couvre la configuration de la dépendance Maven Aspose Slides, - la configuration du graphique et l’enregistrement des présentations. +date: '2026-08-16' +description: Apprenez comment ajouter des doughnut charts en Java avec Aspose.Slides. + Ce guide étape par étape couvre la configuration des dépendances Maven, la configuration + du diagramme, les couleurs, les libellés et l'enregistrement du PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Créer un diagramme en anneau Java avec le guide Aspose.Slides +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Comment ajouter des doughnut charts en Java avec Aspose.Slides. Suivez + ce guide pour configurer Maven, personnaliser les couleurs, les libellés et générer + des fichiers PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Comment ajouter un doughnut chart en Java avec Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Comment ajouter un doughnut chart en Java avec Aspose.Slides url: /fr/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Créer un diagramme en anneau Java avec le guide Aspose.Slides +# Comment ajouter un diagramme en anneau en Java avec Aspose.Slides ## Introduction -Créer un **diagramme en anneau** de façon programmatique peut transformer des chiffres bruts en une visualisation accrocheuse qui raconte instantanément une histoire. En Java, **Aspose.Slides** simplifie ce processus, vous permettant de générer des graphiques prêts pour une présentation sans jamais ouvrir PowerPoint. Dans ce tutoriel, vous apprendrez comment **créer un diagramme en anneau Java** étape par étape — depuis la configuration de la dépendance Maven Aspose Slides jusqu'à la personnalisation des séries, des catégories, et enfin l'enregistrement de la présentation. +Créer un **diagramme en anneau** de façon programmatique peut transformer des chiffres bruts en une visualisation attrayante qui raconte immédiatement une histoire. En Java, **Aspose.Slides** rend ce processus simple, vous permettant de générer des graphiques prêts pour une présentation sans jamais ouvrir PowerPoint. Dans ce tutoriel, vous apprendrez **comment ajouter des diagrammes en anneau** à un fichier PPTX étape par étape — de la configuration de la dépendance Maven Aspose Slides à la personnalisation des séries, catégories, couleurs et libellés, puis à l’enregistrement de la présentation. -À la fin de ce guide, vous serez capable d'intégrer des diagrammes en anneau dynamiques dans n'importe quel fichier PPTX, parfaits pour les rapports, les tableaux de bord ou les présentations automatisées. +À la fin de ce guide, vous serez capable d’intégrer des diagrammes en anneau dynamiques dans n’importe quel fichier PPTX, idéal pour les rapports, tableaux de bord ou présentations automatisées. ### Réponses rapides -- **Quelle bibliothèque est utilisée ?** Aspose.Slides for Java -- **Tâche principale ?** Créer un diagramme en anneau Java dans un fichier PPTX -- **Comment ajouter la bibliothèque ?** Utilisez la dépendance Maven Aspose Slides (ou Gradle) -- **Version minimale de Java ?** JDK 16 ou supérieur -- **Puis-je personnaliser les couleurs et les libellés ?** Oui, l'API offre un contrôle complet du formatage +- **Quelle bibliothèque est utilisée ?** Aspose.Slides for Java +- **Tâche principale ?** Ajouter un diagramme en anneau dans un fichier PPTX +- **Comment ajouter la bibliothèque ?** Utiliser la dépendance Maven Aspose Slides (ou Gradle) +- **Version minimale de Java ?** JDK 16 ou supérieur +- **Puis‑je personnaliser les couleurs et les libellés ?** Oui, l’API offre un contrôle complet du formatage -## Qu'est-ce qu'un diagramme en anneau et pourquoi l'utiliser ? +## Qu’est‑ce qu’un diagramme en anneau et pourquoi l’utiliser ? -Un diagramme en anneau est une variante du diagramme circulaire avec un centre vide, permettant d'afficher plusieurs séries de données sous forme d'anneaux concentriques. Cela le rend idéal pour comparer des parties d'un tout à travers plusieurs catégories — par exemple les ventes par région sur plusieurs trimestres ou les allocations budgétaires par département. +Un diagramme en anneau est une variante du diagramme circulaire avec un centre vide, permettant d’afficher plusieurs séries de données sous forme d’anneaux concentriques. **Il visualise les parties d’un tout sur plusieurs catégories tout en conservant de l’espace au centre pour des informations supplémentaires.** Cela le rend idéal pour comparer les ventes par région sur plusieurs trimestres, les allocations budgétaires entre départements, ou tout scénario nécessitant de montrer des données proportionnelles hiérarchiques. ## Pourquoi utiliser Aspose.Slides pour Java ? -- **Aucune installation d'Office requise** – générez des fichiers PPTX sur n'importe quel serveur. -- **API riche** – contrôle complet sur les types de graphiques, les points de données et le style. -- **Haute performance** – optimisé pour les présentations volumineuses. -- **Multi‑plateforme** – fonctionne sous Windows, Linux et macOS. +Vous pouvez ajouter un diagramme en anneau sans installer Microsoft Office, et la bibliothèque traite **plus de 50 + formats d’entrée et de sortie** tout en gérant des présentations de plus de 500 diapositives. Aspose.Slides offre **un rendu jusqu’à 3 × plus rapide** comparé à l’automatisation native d’Office sur le même matériel, et fonctionne sous Windows, Linux et macOS. Ces avantages quantifiés vous permettent de générer de grands jeux de diapositives sur des serveurs sans interface graphique avec des performances prévisibles. ## Prérequis -- **Bibliothèques requises :** - - Aspose.Slides for Java version 25.4 ou ultérieure. +- **Bibliothèques requises** + - Aspose.Slides for Java 25.4 ou version ultérieure (la bibliothèque qui vous permet d’ajouter des diagrammes en anneau). -- **Configuration de l'environnement :** - - JDK 16 ou supérieur. - - Votre IDE préféré (IntelliJ IDEA, Eclipse, NetBeans, etc.). +- **Environnement** + - JDK 16 ou supérieur installé sur votre machine. + - Un IDE tel qu’IntelliJ IDEA, Eclipse ou NetBeans. -- **Prérequis de connaissances :** - - Programmation Java de base. - - Familiarité avec Maven ou Gradle pour la gestion des dépendances. +- **Connaissances** + - Syntaxe Java de base et concepts orientés objet. + - Familiarité avec Maven ou Gradle pour la gestion des dépendances. ## Dépendance Maven Aspose Slides -Ajoutez la dépendance Maven suivante à votre `pom.xml`. Il s'agit de la **dépendance maven aspose slides** nécessaire pour intégrer la bibliothèque à votre projet. +Ajoutez la dépendance Maven suivante à votre `pom.xml`. Il s’agit de la **dépendance Maven Aspose Slides** dont vous avez besoin pour intégrer la bibliothèque à votre projet. ```xml @@ -72,15 +106,15 @@ Ajoutez la dépendance Maven suivante à votre `pom.xml`. Il s'agit de la **dép Si vous préférez Gradle, utilisez le fragment équivalent ci‑dessous. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` Vous pouvez également télécharger le JAR directement depuis la page officielle des versions : [ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) -### Obtention d'une licence +### Obtention d’une licence -Pour supprimer le filigrane d'évaluation et débloquer l'ensemble complet des fonctionnalités : +Pour supprimer le filigrane d’évaluation et débloquer l’ensemble des fonctionnalités : - **Essai gratuit** – commencez avec une licence temporaire. - **Licence temporaire** – demandez‑en une sur le [site Aspose](https://purchase.aspose.com/temporary-license/). @@ -90,14 +124,134 @@ Appliquez la licence dans votre code : ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); +``` + +## Guide d’implémentation + +### Initialisation d’une présentation et ajout d’un diagramme en anneau + +`Presentation` est la classe Aspose.Slides qui représente une présentation PowerPoint. +Chargez un PPTX existant ou créez un nouvel objet `Presentation`, puis ajoutez un diagramme en anneau à la première diapositive. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Configuration du classeur de données du graphique et suppression des données existantes + +Le classeur est une feuille de calcul interne qui stocke les données du graphique. +Obtenez le classeur qui alimente le graphique, puis supprimez toute série ou catégorie par défaut afin de repartir d’une base propre. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); ``` -## Guide d'implémentation +### Ajout de séries au graphique -### Initialisation de la présentation et ajout d'un diagramme en anneau +Une série représente une collection de points de données tracés sur le graphique. +Vous pouvez ajouter jusqu’à 15 séries. Chaque série peut être personnalisée — ici nous définissons l’explosion, la taille du trou d’anneau et l’angle de la première tranche. -Tout d'abord, créez ou chargez une présentation et ajoutez un diagramme en anneau à la première diapositive. +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Ajout de catégories et de points de données + +Les catégories sont les libellés de chaque point de données le long de l’axe du graphique. +Créez 15 catégories et remplissez chaque série avec un point de données. La dernière série reçoit un formatage spécial des libellés. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Personnalisation des couleurs et des libellés de données + +`FillType.Solid` spécifie une couleur de remplissage solide pour les éléments du graphique. +Définissez une couleur de remplissage solide pour chaque série et activez les libellés de données. Pour la série finale, nous changeons également la couleur de police du libellé. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Enregistrement de la présentation + +`save` écrit la présentation dans un fichier au format choisi. +Enregistrez la présentation mise à jour sur le disque au format PPTX, ou exportez‑la en PDF si nécessaire. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Problèmes courants et solutions + +- **Licence introuvable** – Vérifiez que le chemin vers `license.lic` est correct et que le fichier est lisible. +- **Le graphique apparaît vide** – Assurez‑vous d’avoir supprimé les séries/catégories existantes avant d’en ajouter de nouvelles. +- **Couleurs incorrectes** – Confirmez que `FillType.Solid` est bien défini pour les formats de remplissage et de ligne. +- **Performance avec de nombreuses séries** – Limitez le nombre de séries/catégories ou réutilisez les cellules du classeur pour garder la consommation mémoire sous contrôle. + +## FAQ + +**Q : Puis‑je générer un diagramme en anneau sans fichier PPTX préexistant ?** +R : Oui, créez `new Presentation()` pour démarrer à partir d’un jeu de diapositives vierge, puis ajoutez un graphique comme indiqué ci‑dessus. + +**Q : Aspose.Slides prend‑il en charge l’exportation en PDF ?** +R : Absolument. Après avoir créé le graphique, appelez `pres.save("output.pdf", SaveFormat.Pdf);` pour obtenir une version PDF de la diapositive. + +**Q : Comment modifier la taille du trou d’anneau ?** +R : Utilisez `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` où `value` varie de 0 à 100. + +**Q : Est‑il possible d’ajouter des libellés de données à toutes les séries, pas seulement à la dernière ?** +R : Oui, déplacez le bloc de formatage des libellés en dehors de la condition `if (i == ...)` et appliquez‑le à chaque `dataPoint`. + +**Q : Quelles versions de Java sont prises en charge ?** +R : Aspose.Slides 25.4 prend en charge JDK 16 et les versions ultérieures. Les JDK antérieurs nécessitent le classificateur approprié dans la dépendance Maven. + +--- + +**Dernière mise à jour :** 2026-08-16 +**Testé avec :** Aspose.Slides for Java 25.4 (classificateur jdk16) +**Auteur :** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Configuration du classeur de données du graphique et suppression des données existantes - -Ensuite, obtenez le classeur qui alimente le graphique et supprimez toutes les séries ou catégories par défaut. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Ajout de séries au graphique - -Nous allons maintenant ajouter jusqu'à 15 séries. Chaque série peut être personnalisée — ici nous définissons l'explosion, la taille du trou du diagramme en anneau et l'angle de la première tranche. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Ajout de catégories et de points de données - -Nous créerons 15 catégories et remplirons chaque série avec un point de données. La dernière série reçoit un formatage spécial des libellés. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Enregistrement de la présentation - -Enfin, écrivez la présentation mise à jour sur le disque. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Problèmes courants et solutions +## Tutoriels associés -- **Licence introuvable** – Vérifiez que le chemin vers `license.lic` est correct et que le fichier est lisible. -- **Le graphique apparaît vide** – Assurez‑vous d'avoir supprimé les séries/catégories existantes avant d'en ajouter de nouvelles. -- **Couleurs incorrectes** – Vérifiez que `FillType.Solid` est défini à la fois pour le remplissage et le format de ligne. -- **Performance avec de nombreuses séries** – Limitez le nombre de séries/catégories ou réutilisez les cellules du classeur. +- [Comment ajouter un graphique à PowerPoint avec Aspose.Slides pour Java : guide étape par étape](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Comment personnaliser les couleurs d’un diagramme circulaire en Java avec Aspose.Slides – guide complet](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Animer les catégories de graphiques PowerPoint avec Aspose.Slides pour Java | guide pas à pas](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -## Questions fréquentes - -**Q : Puis‑je générer un diagramme en anneau sans fichier PPTX préexistant ?** -R : Oui, instanciez `new Presentation()` pour démarrer à partir d'un jeu de diapositives vierge. - -**Q : Aspose.Slides prend‑il en charge l'exportation en PDF ?** -R : Absolument. Après avoir créé le graphique, appelez `pres.save("output.pdf", SaveFormat.Pdf);`. - -**Q : Comment modifier la taille du trou du diagramme en anneau ?** -R : Utilisez `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` où la valeur est comprise entre 0‑100. - -**Q : Est‑il possible d'ajouter des libellés de données à toutes les séries, pas seulement à la dernière ?** -R : Oui, déplacez le bloc de formatage des libellés en dehors de la condition `if (i == ...)` et appliquez‑le à chaque `dataPoint`. - -**Q : Quelles versions de Java sont prises en charge ?** -R : Aspose.Slides 25.4 prend en charge JDK 16 et les versions ultérieures. Les versions antérieures de JDK nécessitent le classificateur approprié. - ---- - -**Dernière mise à jour :** 2026-03-07 -**Testé avec :** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Auteur :** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/german/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/german/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 3b1f59d1c1..98f91dd2c0 100644 --- a/slides/german/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/german/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Erfahren Sie, wie Sie ein Donut‑Diagramm in Java mit Aspose.Slides erstellen. - Diese Schritt‑für‑Schritt‑Anleitung behandelt die Einrichtung der Maven‑Aspose‑Slides‑Abhängigkeit, - die Diagrammkonfiguration und das Speichern von Präsentationen. +date: '2026-08-16' +description: Erfahren Sie, wie Sie Donut‑Diagramme in Java mit Aspose.Slides hinzufügen. + Diese Schritt‑für‑Schritt‑Anleitung behandelt die Einrichtung der Maven‑Abhängigkeit, + die Diagrammkonfiguration, Farben, Beschriftungen und das Speichern der PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Donut-Diagramm in Java mit Aspose.Slides erstellen – Anleitung +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Wie man Donut‑Diagramme in Java mit Aspose.Slides hinzufügt. Folgen + Sie dieser Anleitung, um Maven einzurichten, Farben und Beschriftungen anzupassen + und PPTX‑Dateien zu erzeugen. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Wie man ein Donut‑Diagramm in Java mit Aspose.Slides hinzufügt +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Wie man ein Donut‑Diagramm in Java mit Aspose.Slides hinzufügt url: /de/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Erstellen von Donut-Diagrammen in Java mit Aspose.Slides Leitfaden +# Wie man ein Donut‑Diagramm in Java mit Aspose.Slides hinzufügt -## Einführung +## Einleitung -Das programmatische Erstellen eines **doughnut chart** kann Rohdaten in eine auffällige Visualisierung verwandeln, die sofort eine Geschichte erzählt. In Java macht **Aspose.Slides** diesen Prozess einfach, sodass Sie präsentationsfertige Diagramme erzeugen können, ohne PowerPoint zu öffnen. In diesem Tutorial lernen Sie, wie man **create doughnut chart java** Schritt für Schritt erstellt – von der Einrichtung der Maven Aspose Slides‑Abhängigkeit über die Anpassung von Serien, Kategorien bis hin zum Speichern der Präsentation. +Das programmatische Erstellen eines **Donut‑Diagramms** kann rohe Zahlen in eine auffällige Visualisierung verwandeln, die sofort eine Geschichte erzählt. In Java macht **Aspose.Slides** diesen Prozess unkompliziert und ermöglicht es Ihnen, präsentationsfertige Diagramme zu erzeugen, ohne PowerPoint zu öffnen. In diesem Tutorial lernen Sie **wie man Donut‑Diagramme** zu einer PPTX‑Datei Schritt für Schritt hinzufügt – von der Einrichtung der Maven‑Aspose‑Slides‑Abhängigkeit über die Anpassung von Serien, Kategorien, Farben und Beschriftungen bis hin zum finalen Speichern der Präsentation. -Am Ende dieses Leitfadens können Sie dynamische doughnut charts in jede PPTX‑Datei einbetten, ideal für Berichte, Dashboards oder automatisierte Folienpräsentationen. +Am Ende dieses Leitfadens können Sie dynamische Donut‑Diagramme in jede PPTX‑Datei einbetten, ideal für Berichte, Dashboards oder automatisierte Folienpräsentationen. ### Schnelle Antworten - **Welche Bibliothek wird verwendet?** Aspose.Slides for Java -- **Primäre Aufgabe?** Create doughnut chart java in a PPTX file -- **Wie fügt man die Bibliothek hinzu?** Use the Maven Aspose Slides dependency (or Gradle) +- **Primäre Aufgabe?** Ein Donut‑Diagramm in einer PPTX‑Datei hinzufügen +- **Wie fügt man die Bibliothek hinzu?** Verwenden Sie die Maven‑Aspose‑Slides‑Abhängigkeit (oder Gradle) - **Mindest‑Java‑Version?** JDK 16 oder höher -- **Kann ich Farben und Beschriftungen anpassen?** Yes, the API provides full formatting control +- **Kann ich Farben und Beschriftungen anpassen?** Ja, die API bietet vollständige Formatierungssteuerung -## Was ist ein Doughnut‑Diagramm und warum es verwenden? +## Was ist ein Donut‑Diagramm und warum verwenden? -Ein doughnut chart ist eine Variante eines Kreisdiagramms mit einem leeren Zentrum, das es ermöglicht, mehrere Datenserien in konzentrischen Ringen darzustellen. Das macht es ideal, um Anteile eines Ganzen über mehrere Kategorien hinweg zu vergleichen – denken Sie an Verkäufe nach Region über mehrere Quartale oder Budgetzuweisungen nach Abteilungen. +Ein Donut‑Diagramm ist eine Variante eines Kreisdiagramms mit einem leeren Zentrum, das mehrere Datenreihen als konzentrische Ringe darstellen lässt. **Es visualisiert Teile‑eines‑Ganzen über mehrere Kategorien hinweg, während es Platz für zusätzliche Informationen im Zentrum bewahrt.** Das macht es ideal für den Vergleich von Verkäufen nach Region über mehrere Quartale, Budgetzuweisungen nach Abteilungen oder jede Situation, in der hierarchische Proportionen dargestellt werden müssen. ## Warum Aspose.Slides für Java verwenden? -- **Keine Office‑Installation erforderlich** – PPTX‑Dateien auf jedem Server erzeugen. -- **Umfangreiche API** – volle Kontrolle über Diagrammtypen, Datenpunkte und Styling. -- **Hohe Leistung** – optimiert für große Präsentationen. -- **Plattformübergreifend** – funktioniert unter Windows, Linux und macOS. +Sie können ein Donut‑Diagramm hinzufügen, ohne Microsoft Office zu installieren, und die Bibliothek verarbeitet **über 50 + Eingabe‑ und Ausgabeformate**, während sie Präsentationen mit mehr als 500 Folien handhabt. Aspose.Slides liefert **bis zu 3‑mal schnellere Render‑Leistung** im Vergleich zur nativen Office‑Automatisierung auf derselben Hardware und funktioniert auf Windows, Linux und macOS. Diese quantifizierten Vorteile bedeuten, dass Sie große Folienpräsentationen auf headless Servern mit vorhersehbarer Leistung erzeugen können. ## Voraussetzungen -- **Erforderliche Bibliotheken:** - - Aspose.Slides for Java Version 25.4 oder höher. +- **Erforderliche Bibliotheken** + - Aspose.Slides for Java 25.4 oder höher (die Bibliothek, die das Hinzufügen von Donut‑Diagrammen ermöglicht). -- **Umgebungs‑Setup:** - - JDK 16 oder höher. - - Ihre bevorzugte IDE (IntelliJ IDEA, Eclipse, NetBeans usw.). +- **Umgebung** + - JDK 16 oder höher auf Ihrem Rechner installiert. + - Eine IDE wie IntelliJ IDEA, Eclipse oder NetBeans. -- **Vorkenntnisse:** - - Grundlegende Java‑Programmierung. - - Vertrautheit mit Maven oder Gradle für das Abhängigkeitsmanagement. +- **Kenntnisse** + - Grundlegende Java‑Syntax und objektorientierte Konzepte. + - Vertrautheit mit Maven oder Gradle für das Abhängigkeitsmanagement. -## Maven Aspose Slides Abhängigkeit +## Maven Aspose Slides‑Abhängigkeit -Fügen Sie die folgende Maven‑Abhängigkeit zu Ihrer `pom.xml` hinzu. Dies ist die **maven aspose slides dependency**, die Sie benötigen, um die Bibliothek in Ihr Projekt zu übernehmen. +Fügen Sie die folgende Maven‑Abhängigkeit zu Ihrer `pom.xml` hinzu. Dies ist die **Maven‑Aspose‑Slides‑Abhängigkeit**, die Sie benötigen, um die Bibliothek in Ihr Projekt zu integrieren. ```xml @@ -69,10 +103,10 @@ Fügen Sie die folgende Maven‑Abhängigkeit zu Ihrer `pom.xml` hinzu. Dies ist ``` -Wenn Sie Gradle bevorzugen, verwenden Sie das entsprechende Snippet unten. +Falls Sie Gradle bevorzugen, verwenden Sie das entsprechende Snippet unten. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` Sie können das JAR auch direkt von der offiziellen Release‑Seite herunterladen: @@ -80,24 +114,144 @@ Sie können das JAR auch direkt von der offiziellen Release‑Seite herunterlade ### Lizenz erwerben -Um das Evaluations‑Wasserzeichen zu entfernen und den vollen Funktionsumfang freizuschalten: +Um das Evaluierungs‑Wasserzeichen zu entfernen und den vollen Funktionsumfang freizuschalten: -- **Kostenlose Testversion** – mit einer temporären Lizenz beginnen. -- **Temporäre Lizenz** – eine von der [Aspose‑Website](https://purchase.aspose.com/temporary-license/) anfordern. -- **Kommerzielle Lizenz** – für den Produktionseinsatz erwerben. +- **Kostenlose Testversion** – beginnen Sie mit einer temporären Lizenz. +- **Temporäre Lizenz** – beantragen Sie eine über die [Aspose‑Website](https://purchase.aspose.com/temporary-license/). +- **Kommerzielle Lizenz** – erwerben Sie sie für den Produktionseinsatz. Wenden Sie die Lizenz in Ihrem Code an: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## Implementierungs‑Leitfaden -### Initialisierung der Präsentation und Hinzufügen eines Doughnut‑Diagramms +### Initialisierung einer Präsentation und Hinzufügen eines Donut‑Diagramms + +Presentation ist die Aspose.Slides‑Klasse, die eine PowerPoint‑Präsentation repräsentiert. +Laden Sie eine vorhandene PPTX‑Datei oder erstellen Sie ein neues `Presentation`‑Objekt und fügen Sie dann dem ersten Folie ein Donut‑Diagramm hinzu. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Konfiguration des Diagramm‑Daten‑Workbooks und Löschen vorhandener Daten + +Das Workbook ist eine interne Tabelle, die die Diagrammdaten speichert. +Holen Sie das Workbook, das dem Diagramm zugrunde liegt, und löschen Sie dann alle Standard‑Serien oder -Kategorien, damit Sie mit einer sauberen Basis beginnen können. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Hinzufügen von Serien zum Diagramm + +Eine Serie stellt eine Sammlung von Datenpunkten dar, die im Diagramm geplottet werden. +Sie können bis zu 15 Serien hinzufügen. Jede Serie kann angepasst werden – hier setzen wir die Explosion, die Donut‑Loch‑Größe und den Winkel des ersten Stücks. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Hinzufügen von Kategorien und Datenpunkten + +Kategorien sind die Beschriftungen für jeden Datenpunkt entlang der Diagrammachse. +Erstellen Sie 15 Kategorien und füllen Sie jede Serie mit einem Datenpunkt. Die letzte Serie erhält eine spezielle Beschriftungsformatierung. -Zuerst erstellen oder laden Sie eine Präsentation und fügen dem ersten Folie ein doughnut chart hinzu. +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Anpassen von Farben und Datenbeschriftungen + +`FillType.Solid` gibt eine einfarbige Füllfarbe für Diagrammelemente an. +Setzen Sie für jede Serie eine einfarbige Füllfarbe und aktivieren Sie Datenbeschriftungen. Für die letzte Serie ändern wir außerdem die Schriftfarbe der Beschriftung. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Speichern der Präsentation + +`save` schreibt die Präsentation in eine Datei im gewählten Format. +Speichern Sie die aktualisierte Präsentation auf dem Datenträger im PPTX‑Format oder exportieren Sie sie bei Bedarf nach PDF. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Häufige Probleme und Lösungen + +- **Lizenz nicht gefunden** – Überprüfen Sie, ob der Pfad zu `license.lic` korrekt ist und die Datei lesbar ist. +- **Diagramm erscheint leer** – Stellen Sie sicher, dass Sie vorhandene Serien/Kategorien gelöscht haben, bevor Sie neue hinzufügen. +- **Falsche Farben** – Vergewissern Sie sich, dass `FillType.Solid` sowohl für die Füll‑ als auch für die Linienformate gesetzt ist. +- **Leistung bei vielen Serien** – Begrenzen Sie die Anzahl der Serien/Kategorien oder verwenden Sie Workbook‑Zellen erneut, um den Speicherverbrauch im Griff zu behalten. + +## Häufig gestellte Fragen + +**F: Kann ich ein Donut‑Diagramm ohne eine bereits vorhandene PPTX‑Datei erzeugen?** +A: Ja, instanziieren Sie `new Presentation()`, um von einem leeren Foliendeck zu starten, und fügen Sie dann ein Diagramm wie oben gezeigt hinzu. + +**F: Unterstützt Aspose.Slides den Export nach PDF?** +A: Auf jeden Fall. Nachdem Sie das Diagramm erstellt haben, rufen Sie `pres.save("output.pdf", SaveFormat.Pdf);` auf, um eine PDF‑Version der Folie zu erhalten. + +**F: Wie ändere ich die Größe des Donut‑Lochs?** +A: Verwenden Sie `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`, wobei `value` von 0 bis 100 reicht. + +**F: Ist es möglich, Datenbeschriftungen zu allen Serien hinzuzufügen, nicht nur zur letzten?** +A: Ja, verschieben Sie den Beschriftungs‑Formatierungsblock aus der Bedingung `if (i == ...)` heraus und wenden Sie ihn auf jeden `dataPoint` an. + +**F: Welche Java‑Versionen werden unterstützt?** +A: Aspose.Slides 25.4 unterstützt JDK 16 und neuer. Ältere JDKs benötigen den entsprechenden Klassifizierer in der Maven‑Abhängigkeit. + +--- + +**Last Updated:** 2026-08-16 +**Tested With:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Author:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Konfiguration des Diagramm‑Daten‑Workbooks und Löschen vorhandener Daten - -Als Nächstes erhalten Sie das Workbook, das dem Diagramm zugrunde liegt, und löschen alle Standard‑Serien oder -Kategorien. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Hinzufügen von Serien zum Diagramm - -Jetzt fügen wir bis zu 15 Serien hinzu. Jede Serie kann angepasst werden – hier setzen wir die Explosion, die Größe des doughnut‑Lochs und den Winkel des ersten Segments. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Hinzufügen von Kategorien und Datenpunkten - -Wir erstellen 15 Kategorien und füllen jede Serie mit einem Datenpunkt. Die letzte Serie erhält eine spezielle Beschriftungsformatierung. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Speichern der Präsentation - -Abschließend schreiben Sie die aktualisierte Präsentation auf die Festplatte. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Häufige Probleme und Lösungen - -- **Lizenz nicht gefunden** – Überprüfen Sie, ob der Pfad zu `license.lic` korrekt ist und die Datei lesbar ist. -- **Diagramm erscheint leer** – Stellen Sie sicher, dass Sie vorhandene Serien/Kategorien gelöscht haben, bevor Sie neue hinzufügen. -- **Falsche Farben** – Prüfen Sie, ob `FillType.Solid` sowohl für die Füll‑ als auch für die Linienformate gesetzt ist. -- **Leistung bei vielen Serien** – Begrenzen Sie die Anzahl der Serien/Kategorien oder verwenden Sie die Workbook‑Zellen erneut. - -## Häufig gestellte Fragen - -**Q: Kann ich ein doughnut chart ohne eine bereits vorhandene PPTX‑Datei erzeugen?** -A: Ja, instanziieren Sie `new Presentation()`, um mit einem leeren Folien‑Deck zu beginnen. +## Verwandte Tutorials -**Q: Unterstützt Aspose.Slides den Export nach PDF?** -A: Absolut. Nach dem Erstellen des Diagramms rufen Sie `pres.save("output.pdf", SaveFormat.Pdf);` auf. +- [Wie man ein Diagramm zu PowerPoint mit Aspose.Slides für Java hinzufügt: Eine Schritt‑für‑Schritt‑Anleitung](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Wie man Kreisdiagramm‑Farben in Java mit Aspose.Slides anpasst – Ein vollständiger Leitfaden](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [PowerPoint‑Diagramm‑Kategorien mit Aspose.Slides für Java animieren | Schritt‑für‑Schritt‑Anleitung](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: Wie ändere ich die Größe des doughnut‑Lochs?** -A: Verwenden Sie `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`, wobei value 0‑100 ist. - -**Q: Ist es möglich, Datenbeschriftungen zu allen Serien hinzuzufügen, nicht nur zur letzten?** -A: Ja, verschieben Sie den Beschriftungs‑Formatierungsblock außerhalb der Bedingung `if (i == ...)` und wenden Sie ihn auf jeden `dataPoint` an. - -**Q: Welche Java‑Versionen werden unterstützt?** -A: Aspose.Slides 25.4 unterstützt JDK 16 und neuer. Ältere JDKs benötigen den entsprechenden Klassifizierer. - ---- - -**Zuletzt aktualisiert:** 2026-03-07 -**Getestet mit:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Autor:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/greek/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/greek/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index d2257778e1..5b392a7bd8 100644 --- a/slides/greek/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/greek/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Μάθετε πώς να δημιουργήσετε διάγραμμα δακτυλίου σε Java χρησιμοποιώντας - το Aspose.Slides. Αυτός ο οδηγός βήμα‑βήμα καλύπτει τη ρύθμιση της εξάρτησης Maven - Aspose Slides, τη διαμόρφωση του διαγράμματος και την αποθήκευση των παρουσιάσεων. +date: '2026-08-16' +description: Μάθετε πώς να προσθέσετε doughnut charts σε Java χρησιμοποιώντας Aspose.Slides. + Αυτός ο οδηγός βήμα‑βήμα καλύπτει τη ρύθμιση εξαρτήσεων Maven, τη διαμόρφωση του + διαγράμματος, τα χρώματα, τις ετικέτες και την αποθήκευση του PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Δημιουργία διαγράμματος δαχτυλιδιού Java με οδηγό Aspose.Slides +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Πώς να προσθέσετε doughnut charts σε Java χρησιμοποιώντας Aspose.Slides. + Ακολουθήστε αυτόν τον οδηγό για να ρυθμίσετε το Maven, να προσαρμόσετε τα χρώματα, + τις ετικέτες και να δημιουργήσετε αρχεία PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Πώς να προσθέσετε doughnut chart σε Java με Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Πώς να προσθέσετε doughnut chart σε Java με Aspose.Slides url: /el/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Δημιουργία Διάγραμμα Ντόνατ Java με Οδηγό Aspose.Slides +# Πώς να προσθέσετε γράφημα δακτυλίου σε Java με Aspose.Slides ## Εισαγωγή -Η δημιουργία ενός **doughnut chart** προγραμματιστικά μπορεί να μετατρέψει ακατέργαστους αριθμούς σε ένα εντυπωσιακό οπτικό στοιχείο που αφηγείται αμέσως μια ιστορία. Στη Java, το **Aspose.Slides** κάνει αυτή τη διαδικασία απλή, επιτρέποντάς σας να δημιουργήσετε διαγράμματα έτοιμα για παρουσίαση χωρίς να ανοίξετε ποτέ το PowerPoint. Σε αυτό το tutorial θα μάθετε πώς να **create doughnut chart java** βήμα‑βήμα — από τη ρύθμιση της εξάρτησης Maven Aspose Slides μέχρι την προσαρμογή σειρών, κατηγοριών και, τέλος, την αποθήκευση της παρουσίασης. +Η δημιουργία ενός **γράφηματος δακτυλίου** προγραμματιστικά μπορεί να μετατρέψει ακατέργαστους αριθμούς σε ένα εντυπωσιακό οπτικό στοιχείο που αφηγείται αμέσως μια ιστορία. Σε Java, το **Aspose.Slides** καθιστά αυτή τη διαδικασία απλή, επιτρέποντάς σας να δημιουργείτε γραφήματα έτοιμα για παρουσίαση χωρίς καν να ανοίξετε το PowerPoint. Σε αυτόν τον **οδηγό** θα μάθετε **πώς να προσθέσετε δακτυλιοειδές** γραφήματα σε ένα αρχείο PPTX βήμα προς βήμα — από τη ρύθμιση της εξάρτησης Maven Aspose Slides μέχρι την προσαρμογή σειρών, κατηγοριών, χρωμάτων και ετικετών, και τέλος την αποθήκευση της παρουσίασης. -Με το τέλος αυτού του οδηγού θα μπορείτε να ενσωματώσετε δυναμικά doughnut charts σε οποιοδήποτε αρχείο PPTX, ιδανικά για αναφορές, πίνακες ελέγχου ή αυτοματοποιημένες παρουσιάσεις. +Στο τέλος αυτού του οδηγού θα μπορείτε να ενσωματώσετε δυναμικά γραφήματα δακτυλίου σε οποιοδήποτε αρχείο PPTX, ιδανικά για αναφορές, πίνακες ελέγχου ή αυτοματοποιημένες παρουσιάσεις. ### Γρήγορες Απαντήσεις - **What library is used?** Aspose.Slides for Java -- **Primary task?** Create doughnut chart java in a PPTX file -- **How to add the library?** Use the Maven Aspose Slides dependency (or Gradle) +- **Primary task?** Προσθήκη γραφήματος δακτυλίου σε αρχείο PPTX +- **How to add the library?** Χρησιμοποιήστε την εξάρτηση Maven Aspose Slides (ή Gradle) - **Minimum Java version?** JDK 16 or higher -- **Can I customize colors and labels?** Yes, the API provides full formatting control +- **Can I customize colors and labels?** Ναι, το API παρέχει πλήρη έλεγχο μορφοποίησης -## Τι είναι ένα Διάγραμμα Ντόνατ και Γιατί να το Χρησιμοποιήσετε; +## Τι είναι το γράφημα δακτυλίου και γιατί να το χρησιμοποιήσετε; -Ένα doughnut chart είναι μια παραλλαγή του pie chart με κενό κέντρο, επιτρέποντάς σας να εμφανίσετε πολλαπλές σειρές δεδομένων σε συγκεντρικούς δακτυλίους. Αυτό το καθιστά ιδανικό για σύγκριση μερών ενός συνόλου σε πολλές κατηγορίες — σκεφτείτε πωλήσεις ανά περιοχή σε πολλαπλά τρίμηνα ή κατανομές προϋπολογισμού ανά τμήμα. +Ένα γράφημα δακτυλίου είναι μια παραλλαγή του διαγράμματος πίτας με κενό κέντρο, επιτρέποντας την εμφάνιση πολλαπλών σειρών δεδομένων ως συνελικτικές δακτυλίους. **Οπτικοποιεί μέρη‑από‑ολό σε πολλές κατηγορίες ενώ διατηρεί χώρο για πρόσθετες πληροφορίες στο κέντρο.** Αυτό το καθιστά ιδανικό για σύγκριση πωλήσεων ανά περιοχή σε πολλαπλά τρίμηνα, κατανομές προϋπολογισμού ανά τμήμα, ή οποιοδήποτε σενάριο όπου χρειάζεται να δείξετε ιεραρχικά δεδομένα αναλογίας. -## Γιατί να Χρησιμοποιήσετε το Aspose.Slides για Java; +## Γιατί να χρησιμοποιήσετε το Aspose.Slides για Java; -- **No Office installation required** – generate PPTX files on any server. -- **Rich API** – full control over chart types, data points, and styling. -- **High performance** – optimized for large presentations. -- **Cross‑platform** – works on Windows, Linux, and macOS. +Μπορείτε να προσθέσετε ένα γράφημα δακτυλίου χωρίς να εγκαταστήσετε το Microsoft Office, και η βιβλιοθήκη επεξεργάζεται **πάνω από 50 + μορφές εισόδου και εξόδου** ενώ διαχειρίζεται παρουσιάσεις που υπερβαίνουν τις 500 διαφάνειες. Το Aspose.Slides προσφέρει **ταχύτητα απόδοσης έως 3×** σε σύγκριση με την εγγενή αυτοματοποίηση του Office στο ίδιο υλικό, και λειτουργεί σε Windows, Linux και macOS. Αυτά τα ποσοτικά οφέλη σημαίνουν ότι μπορείτε να δημιουργήσετε μεγάλες συλλογές διαφανειών σε servers χωρίς γραφικό περιβάλλον με προβλέψιμη απόδοση. ## Προαπαιτούμενα -- **Required Libraries:** - - Aspose.Slides for Java version 25.4 or later. +- **Απαιτούμενες βιβλιοθήκες** + - Aspose.Slides for Java 25.4 or later (the library that enables you to add doughnut charts). -- **Environment Setup:** - - JDK 16 or higher. - - Your favorite IDE (IntelliJ IDEA, Eclipse, NetBeans, etc.). +- **Περιβάλλον** + - JDK 16 or higher installed on your machine. + - An IDE such as IntelliJ IDEA, Eclipse or NetBeans. -- **Knowledge Prerequisites:** - - Basic Java programming. - - Familiarity with Maven or Gradle for dependency management. +- **Γνώσεις** + - Basic Java syntax and object‑oriented concepts. + - Familiarity with Maven or Gradle for dependency management. ## Εξάρτηση Maven Aspose Slides -Προσθέστε την παρακάτω εξάρτηση Maven στο `pom.xml`. Αυτή είναι η **maven aspose slides dependency** που χρειάζεστε για να ενσωματώσετε τη βιβλιοθήκη στο έργο σας. +Προσθέστε την παρακάτω εξάρτηση Maven στο `pom.xml`. Αυτή είναι η **εξάρτηση maven aspose slides** που χρειάζεστε για να ενσωματώσετε τη βιβλιοθήκη στο έργο σας. ```xml @@ -72,32 +106,146 @@ weight: 1 Αν προτιμάτε Gradle, χρησιμοποιήστε το αντίστοιχο απόσπασμα παρακάτω. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -Μπορείτε επίσης να κατεβάσετε το JAR απευθείας από τη σελίδα κυκλοφορίας: -[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) +Μπορείτε επίσης να κατεβάσετε το JAR απευθείας από τη σελίδα επίσημων εκδόσεων: +[ Κυκλοφορίες Aspose.Slides για Java ](https://releases.aspose.com/slides/java/) -### Απόκτηση Άδειας +### Απόκτηση άδειας Για να αφαιρέσετε το υδατογράφημα αξιολόγησης και να ξεκλειδώσετε το πλήρες σύνολο λειτουργιών: -- **Free trial** – start with a temporary license. -- **Temporary license** – request one from the [Aspose website](https://purchase.aspose.com/temporary-license/). -- **Commercial license** – purchase for production use. +- **Δωρεάν δοκιμή** – ξεκινήστε με μια προσωρινή άδεια. +- **Προσωρινή άδεια** – ζητήστε μία από την [Aspose website](https://purchase.aspose.com/temporary-license/). +- **Εμπορική άδεια** – αγοράστε για παραγωγική χρήση. Εφαρμόστε την άδεια στον κώδικά σας: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); +``` + +## Οδηγός υλοποίησης + +### Αρχικοποίηση παρουσίασης και προσθήκη γραφήματος δακτυλίου + +Presentation είναι η κλάση Aspose.Slides που αντιπροσωπεύει μια παρουσίαση PowerPoint. Φορτώστε ένα υπάρχον PPTX ή δημιουργήστε ένα νέο αντικείμενο `Presentation`, στη συνέχεια προσθέστε ένα γράφημα δακτυλίου στην πρώτη διαφάνεια. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Διαμόρφωση του φύλλου δεδομένων του γραφήματος και εκκαθάριση υπαρχόντων δεδομένων + +Το workbook είναι ένα εσωτερικό φύλλο υπολογισμού που αποθηκεύει τα δεδομένα του γραφήματος. Αποκτήστε το workbook που υποστηρίζει το γράφημα, στη συνέχεια εκκαθαρίστε τυχόν προεπιλεγμένες σειρές ή κατηγορίες ώστε να ξεκινήσετε με καθαρό καμβά. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Προσθήκη σειρών στο γράφημα + +Μια σειρά αντιπροσωπεύει μια συλλογή σημείων δεδομένων που σχεδιάζονται στο γράφημα. Μπορείτε να προσθέσετε έως και 15 σειρές. Κάθε σειρά μπορεί να προσαρμοστεί — εδώ ορίζουμε την έκρηξη, το μέγεθος του κεντρικού οπής και τη γωνία της πρώτης φέτας. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); ``` -## Οδηγός Υλοποίησης +### Προσθήκη κατηγοριών και σημείων δεδομένων + +Οι κατηγορίες είναι οι ετικέτες για κάθε σημείο δεδομένων κατά μήκος του άξονα του γραφήματος. Δημιουργήστε 15 κατηγορίες και γεμίστε κάθε σειρά με ένα σημείο δεδομένων. Η τελευταία σειρά λαμβάνει ειδική μορφοποίηση ετικέτας. -### Αρχικοποίηση Παρουσίασης και Προσθήκη Διάγραμμα Ντόνατ +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` -Πρώτα, δημιουργήστε ή φορτώστε μια παρουσίαση και προσθέστε ένα doughnut chart στην πρώτη διαφάνεια. +### Προσαρμογή χρωμάτων και ετικετών δεδομένων + +`FillType.Solid` καθορίζει ένα συμπαγές χρώμα γεμίσματος για τα στοιχεία του γραφήματος. Ορίστε ένα συμπαγές χρώμα γεμίσματος για κάθε σειρά και ενεργοποιήστε τις ετικέτες δεδομένων. Για την τελική σειρά αλλάζουμε επίσης το χρώμα γραμματοσειράς της ετικέτας. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Αποθήκευση της παρουσίασης + +`save` γράφει την παρουσίαση σε αρχείο στην επιλεγμένη μορφή. Γράψτε την ενημερωμένη παρουσίαση στο δίσκο σε μορφή PPTX ή εξάγετε σε PDF εάν απαιτείται. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Κοινά προβλήματα και λύσεις + +- **License not found** – Επαληθεύστε ότι η διαδρομή προς το `license.lic` είναι σωστή και το αρχείο είναι αναγνώσιμο. +- **Chart appears blank** – Βεβαιωθείτε ότι εκκαθαρίσατε τις υπάρχουσες σειρές/κατηγορίες πριν προσθέσετε νέες. +- **Incorrect colors** – Επιβεβαιώστε ότι το `FillType.Solid` είναι ορισμένο τόσο για το γέμισμα όσο και για τις μορφές γραμμής. +- **Performance with many series** – Περιορίστε τον αριθμό σειρών/κατηγοριών ή επαναχρησιμοποιήστε κελιά του workbook για να διατηρήσετε τη χρήση μνήμης υπό έλεγχο. + +## Συχνές ερωτήσεις + +**Q: Μπορώ να δημιουργήσω ένα γράφημα δακτυλίου χωρίς προϋπάρχιο αρχείο PPTX;** +A: Ναι, δημιουργήστε `new Presentation()` για να ξεκινήσετε από μια κενή συλλογή διαφανειών, στη συνέχεια προσθέστε το γράφημα όπως φαίνεται παραπάνω. + +**Q: Υποστηρίζει το Aspose.Slides εξαγωγή σε PDF;** +A: Απόλυτα. Μετά τη δημιουργία του γραφήματος, καλέστε `pres.save("output.pdf", SaveFormat.Pdf);` για να λάβετε μια έκδοση PDF της διαφάνειας. + +**Q: Πώς αλλάζω το μέγεθος της κεντρικής οπής του δακτυλίου;** +A: Χρησιμοποιήστε `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` όπου η `value` κυμαίνεται από 0 to 100. + +**Q: Είναι δυνατόν να προσθέσω ετικέτες δεδομένων σε όλες τις σειρές, όχι μόνο στην τελευταία;** +A: Ναι, μετακινήστε το τμήμα μορφοποίησης ετικέτας εκτός της συνθήκης `if (i == ...)` και εφαρμόστε το σε κάθε `dataPoint`. + +**Q: Ποιες εκδόσεις της Java υποστηρίζονται;** +A: Το Aspose.Slides 25.4 υποστηρίζει JDK 16 και νεότερες. Παλαιότερες εκδόσεις JDK απαιτούν τον κατάλληλο classifier στην εξάρτηση Maven. + +--- + +**Last Updated:** 2026-08-16 +**Tested With:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Author:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +256,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Διαμόρφωση του Workbook Δεδομένων του Διαγράμματος και Καθαρισμός Υπάρχοντων Δεδομένων - -Στη συνέχεια, αποκτήστε το workbook που υποστηρίζει το διάγραμμα και διαγράψτε τυχόν προεπιλεγμένες σειρές ή κατηγορίες. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +266,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Προσθήκη Σειρών στο Διάγραμμα - -Τώρα θα προσθέσουμε έως και 15 σειρές. Κάθε σειρά μπορεί να προσαρμοστεί — εδώ ορίζουμε την έκρηξη, το μέγεθος της τρύπας του ντόνατ και τη γωνία του πρώτου κομματιού. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +282,6 @@ while (seriesIndex < 15) { } ``` -### Προσθήκη Κατηγοριών και Σημείων Δεδομένων - -Θα δημιουργήσουμε 15 κατηγορίες και θα γεμίσουμε κάθε σειρά με ένα σημείο δεδομένων. Η τελευταία σειρά λαμβάνει ειδική μορφοποίηση ετικετών. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +334,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Αποθήκευση της Παρουσίασης - -Τέλος, γράψτε την ενημερωμένη παρουσίαση στο δίσκο. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Κοινά Προβλήματα και Λύσεις - -- **License not found** – Verify the path to `license.lic` is correct and the file is readable. -- **Chart appears blank** – Ensure you cleared existing series/categories before adding new ones. -- **Incorrect colors** – Check that `FillType.Solid` is set for both fill and line formats. -- **Performance with many series** – Limit the number of series/categories or reuse the workbook cells. - -## Συχνές Ερωτήσεις - -**Q: Can I generate a doughnut chart without a pre‑existing PPTX file?** -A: Yes, instantiate `new Presentation()` to start from a blank slide deck. - -**Q: Does Aspose.Slides support exporting to PDF?** -A: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);`. +## Σχετικά Μαθήματα -**Q: How do I change the doughnut hole size?** -A: Use `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` where value is 0‑100. +- [Πώς να προσθέσετε γράφημα στο PowerPoint χρησιμοποιώντας το Aspose.Slides για Java: Οδηγός βήμα‑βήμα](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Πώς να προσαρμόσετε τα χρώματα γραφήματος πίτας σε Java με το Aspose.Slides – Πλήρης Οδηγός](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Κίνηση κατηγοριών γραφήματος PowerPoint με Aspose.Slides για Java | Οδηγός βήμα‑βήμα](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: Is it possible to add data labels to all series, not just the last one?** -A: Yes, move the label‑formatting block outside the `if (i == ...)` condition and apply it to each `dataPoint`. - -**Q: What versions of Java are supported?** -A: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the appropriate classifier. - ---- - -**Last Updated:** 2026-03-07 -**Tested With:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Author:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/hindi/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/hindi/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index b07f86995f..57f1759816 100644 --- a/slides/hindi/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/hindi/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Aspose.Slides का उपयोग करके जावा में डोनट चार्ट बनाना सीखें। यह चरण‑दर‑चरण - गाइड Maven Aspose Slides निर्भरता सेटअप, चार्ट कॉन्फ़िगरेशन और प्रेजेंटेशन को सहेजने - को कवर करता है। +date: '2026-08-16' +description: Aspose.Slides का उपयोग करके Java में doughnut charts कैसे जोड़ें सीखें। + यह चरण‑दर‑चरण गाइड Maven डिपेंडेंसी सेटअप, chart कॉन्फ़िगरेशन, रंग, लेबल और PPTX + को सहेजने को कवर करता है। keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Aspose.Slides गाइड के साथ जावा में डोनट चार्ट बनाएं +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Java में Aspose.Slides का उपयोग करके doughnut charts कैसे जोड़ें। + Maven सेटअप करने, रंग, लेबल को कस्टमाइज़ करने और PPTX फ़ाइलें जेनरेट करने के लिए + इस गाइड का पालन करें। +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Java में Aspose.Slides के साथ doughnut chart कैसे जोड़ें +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Java में Aspose.Slides के साथ doughnut chart कैसे जोड़ें url: /hi/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,49 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Aspose.Slides के साथ जावा में डोनट चार्ट बनाना गाइड +# Java में Aspose.Slides के साथ डोनट चार्ट कैसे जोड़ें ## परिचय -प्रोग्रामेटिक रूप से **डोनट चार्ट** बनाना कच्चे आंकड़ों को एक आकर्षक दृश्य में बदल सकता है जो तुरंत कहानी बताता है। जावा में, **Aspose.Slides** इस प्रक्रिया को सरल बनाता है, जिससे आप PowerPoint खोले बिना ही प्रस्तुति‑तैयार चार्ट बना सकते हैं। इस ट्यूटोरियल में आप चरण‑दर‑चरण **डोनट चार्ट जावा** बनाना सीखेंगे— Maven Aspose Slides डिपेंडेंसी सेट करने से लेकर सीरीज़, कैटेगरीज को कस्टमाइज़ करने और अंत में प्रेजेंटेशन सहेजने तक। +प्रोग्रामेटिक रूप से **डोनट चार्ट** बनाना कच्चे आंकड़ों को एक आकर्षक दृश्य में बदल सकता है जो तुरंत कहानी बताता है। Java में, **Aspose.Slides** इस प्रक्रिया को सरल बनाता है, जिससे आप PowerPoint खोले बिना प्रस्तुति‑तैयार चार्ट बना सकते हैं। इस ट्यूटोरियल में आप चरण‑दर‑चरण सीखेंगे कि **डोनट जोड़ने का तरीका** चार्ट को PPTX फ़ाइल में कैसे जोड़ें— Maven Aspose Slides निर्भरता सेटअप करने से लेकर श्रृंखला, श्रेणियाँ, रंग और लेबल को अनुकूलित करने तक, और अंत में प्रस्तुति को सहेजना। -इस गाइड के अंत तक आप किसी भी PPTX फ़ाइल में डायनामिक डोनट चार्ट एम्बेड कर पाएँगे, जो रिपोर्ट, डैशबोर्ड या ऑटोमेटेड स्लाइड डेक्स के लिए उपयुक्त है। +इस गाइड के अंत तक आप किसी भी PPTX फ़ाइल में गतिशील डोनट चार्ट एम्बेड कर सकेंगे, जो रिपोर्ट, डैशबोर्ड या स्वचालित स्लाइड डेक्स के लिए उपयुक्त हैं। ### त्वरित उत्तर - **कौन सी लाइब्रेरी उपयोग की जाती है?** Aspose.Slides for Java -- **मुख्य कार्य?** PPTX फ़ाइल में डोनट चार्ट जावा बनाना -- **लाइब्रेरी कैसे जोड़ें?** Maven Aspose Slides डिपेंडेंसी (या Gradle) का उपयोग करें -- **न्यूनतम जावा संस्करण?** JDK 16 or higher -- **क्या मैं रंग और लेबल कस्टमाइज़ कर सकता हूँ?** हाँ, API पूर्ण फ़ॉर्मेटिंग नियंत्रण प्रदान करती है। +- **मुख्य कार्य?** Add a doughnut chart in a PPTX file +- **लाइब्रेरी कैसे जोड़ें?** Use the Maven Aspose Slides dependency (or Gradle) +- **न्यूनतम Java संस्करण?** JDK 16 or higher +- **क्या मैं रंग और लेबल कस्टमाइज़ कर सकता हूँ?** Yes, the API provides full formatting control -## डोनट चार्ट क्या है और इसका उपयोग क्यों करें? +## डोनट चार्ट क्या है और इसे क्यों उपयोग करें? -डोनट चार्ट पाई चार्ट का एक वैरिएशन है जिसमें मध्य में खाली जगह होती है, जिससे आप कई डेटा सीरीज़ को concentric रिंग्स में दिखा सकते हैं। यह कई श्रेणियों में पूरे के भागों की तुलना करने के लिए आदर्श है—जैसे विभिन्न तिमाहियों में क्षेत्र के अनुसार बिक्री या विभागों में बजट आवंटन। +डोनट चार्ट पाई चार्ट का एक रूपांतर है जिसमें केंद्र खाली रहता है, जिससे कई डेटा श्रृंखलाएँ समानांतर रिंग्स के रूप में प्रदर्शित की जा सकती हैं। +**यह कई श्रेणियों में भाग‑से‑सम्पूर्ण को दर्शाता है जबकि केंद्र में अतिरिक्त जानकारी के लिए स्थान सुरक्षित रखता है।** +यह कई तिमाहियों में क्षेत्र के अनुसार बिक्री की तुलना, विभागों के बीच बजट आवंटन, या किसी भी स्थिति में पदानुक्रमित अनुपात डेटा दिखाने के लिए आदर्श बनाता है। -## जावा के लिए Aspose.Slides क्यों उपयोग करें? +## Java के लिए Aspose.Slides क्यों उपयोग करें? -- **ऑफ़िस इंस्टॉलेशन की आवश्यकता नहीं** – किसी भी सर्वर पर PPTX फ़ाइलें जनरेट करें। -- **समृद्ध API** – चार्ट प्रकार, डेटा पॉइंट्स और स्टाइलिंग पर पूर्ण नियंत्रण। -- **उच्च प्रदर्शन** – बड़ी प्रेजेंटेशन के लिए अनुकूलित। -- **क्रॉस‑प्लेटफ़ॉर्म** – Windows, Linux, और macOS पर काम करता है। +आप Microsoft Office स्थापित किए बिना डोनट चार्ट जोड़ सकते हैं, और लाइब्रेरी **50 + से अधिक इनपुट और आउटपुट फ़ॉर्मेट** को प्रोसेस करती है जबकि 500 से अधिक स्लाइड वाली प्रस्तुतियों को संभालती है। +Aspose.Slides समान हार्डवेयर पर मूल Office ऑटोमेशन की तुलना में **3× तक तेज़ रेंडरिंग** प्रदान करता है, और यह Windows, Linux और macOS पर काम करता है। +इन मापनीय लाभों का मतलब है कि आप हेडलेस सर्वरों पर पूर्वानुमानित प्रदर्शन के साथ बड़े स्लाइड डेक बना सकते हैं। -## आवश्यकताएँ +## पूर्वापेक्षाएँ -- **आवश्यक लाइब्रेरीज़:** - - Aspose.Slides for Java version 25.4 or later. +- **आवश्यक लाइब्रेरीज़** + - Aspose.Slides for Java 25.4 or later (the library that enables you to add doughnut charts). -- **पर्यावरण सेटअप:** - - JDK 16 or higher. - - आपका पसंदीदा IDE (IntelliJ IDEA, Eclipse, NetBeans, आदि)। +- **पर्यावरण** + - JDK 16 or higher installed on your machine. + - An IDE such as IntelliJ IDEA, Eclipse or NetBeans. -- **ज्ञान आवश्यकताएँ:** - - बुनियादी जावा प्रोग्रामिंग। - - डिपेंडेंसी मैनेजमेंट के लिए Maven या Gradle की परिचितता। +- **ज्ञान** + - Basic Java syntax and object‑oriented concepts. + - Familiarity with Maven or Gradle for dependency management. -## Maven Aspose Slides डिपेंडेंसी +## Maven Aspose Slides निर्भरता -अपने `pom.xml` में निम्नलिखित Maven डिपेंडेंसी जोड़ें। यह **maven aspose slides dependency** है जिसे आपको लाइब्रेरी को प्रोजेक्ट में लाने के लिए चाहिए। +अपने `pom.xml` में निम्नलिखित Maven निर्भरता जोड़ें। यह वह **maven aspose slides dependency** है जिसे आपको लाइब्रेरी को अपने प्रोजेक्ट में लाने के लिए चाहिए। ```xml @@ -69,63 +107,166 @@ weight: 1 ``` -यदि आप Gradle पसंद करते हैं, तो नीचे दिया गया समतुल्य स्निपेट उपयोग करें। +यदि आप Gradle पसंद करते हैं, तो नीचे दिया गया समकक्ष स्निपेट उपयोग करें। ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -आप आधिकारिक रिलीज़ पेज से JAR सीधे डाउनलोड भी कर सकते हैं: -[ Aspose.Slides for Java रिलीज़ ](https://releases.aspose.com/slides/java/) +आप आधिकारिक रिलीज पेज से JAR को सीधे डाउनलोड भी कर सकते हैं: +[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) ### लाइसेंस प्राप्त करना -इवैल्यूएशन वॉटरमार्क हटाने और पूरी फीचर सेट अनलॉक करने के लिए: +मूल्यांकन वॉटरमार्क हटाने और पूरी फीचर सेट को अनलॉक करने के लिए: -- **फ़्री ट्रायल** – अस्थायी लाइसेंस के साथ शुरू करें। -- **अस्थायी लाइसेंस** – एक प्राप्त करने के लिए [Aspose वेबसाइट](https://purchase.aspose.com/temporary-license/) से अनुरोध करें। -- **वाणिज्यिक लाइसेंस** – उत्पादन उपयोग के लिए खरीदें। +- **फ़्री ट्रायल** – एक अस्थायी लाइसेंस के साथ शुरू करें। +- **अस्थायी लाइसेंस** – [Aspose वेबसाइट](https://purchase.aspose.com/temporary-license/) से अनुरोध करें। +- **व्यावसायिक लाइसेंस** – उत्पादन उपयोग के लिए खरीदें। अपने कोड में लाइसेंस लागू करें: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## कार्यान्वयन गाइड ### प्रेजेंटेशन को इनिशियलाइज़ करना और डोनट चार्ट जोड़ना -पहले, एक प्रेजेंटेशन बनाएं या लोड करें और पहले स्लाइड में डोनट चार्ट जोड़ें। +Presentation Aspose.Slides क्लास है जो PowerPoint प्रस्तुति को दर्शाता है। +एक मौजूदा PPTX लोड करें या नया `Presentation` ऑब्जेक्ट बनाएं, फिर पहले स्लाइड में डोनट चार्ट जोड़ें। ```java -Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); ``` +### चार्ट डेटा वर्कबुक को कॉन्फ़िगर करना और मौजूदा डेटा साफ़ करना + +वर्कबुक एक आंतरिक स्प्रेडशीट है जो चार्ट का डेटा संग्रहीत करता है। +चार्ट को सपोर्ट करने वाला वर्कबुक प्राप्त करें, फिर किसी भी डिफ़ॉल्ट श्रृंखला या श्रेणियों को साफ़ करें ताकि आप एक साफ़ स्लेट से शुरू कर सकें। + ```java -ISlide slide = pres.getSlides().get_Item(0); -IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); ``` -### चार्ट डेटा वर्कबुक कॉन्फ़िगर करना और मौजूदा डेटा साफ़ करना +### चार्ट में श्रृंखला जोड़ना -अगला, चार्ट के पीछे का वर्कबुक प्राप्त करें और किसी भी डिफ़ॉल्ट सीरीज़ या कैटेगरी को साफ़ करें। +एक श्रृंखला डेटा पॉइंट्स का संग्रह दर्शाती है जो चार्ट पर प्लॉट होते हैं। +आप अधिकतम 15 श्रृंखलाएँ जोड़ सकते हैं। प्रत्येक श्रृंखला को कस्टमाइज़ किया जा सकता है—यहाँ हम एक्सप्लोजन, डोनट‑होल आकार, और पहला‑स्लाइस एंगल सेट करते हैं। ```java -IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); ``` +### श्रेणियाँ और डेटा पॉइंट्स जोड़ना + +श्रेणियाँ चार्ट की धुरी के साथ प्रत्येक डेटा पॉइंट के लेबल होते हैं। +15 श्रेणियाँ बनाएं और प्रत्येक श्रृंखला को एक डेटा पॉइंट से भरें। अंतिम श्रृंखला को विशेष लेबल फॉर्मेटिंग मिलती है। + ```java -chart.getChartData().getSeries().clear(); -chart.getChartData().getCategories().clear(); -chart.setLegend(false); +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} ``` -### चार्ट में सीरीज़ जोड़ना +### रंग और डेटा लेबल्स को कस्टमाइज़ करना -अब हम अधिकतम 15 सीरीज़ जोड़ेंगे। प्रत्येक सीरीज़ को कस्टमाइज़ किया जा सकता है—यहाँ हम एक्सप्लोजन, डोनट‑होल साइज, और फ़र्स्ट‑स्लाइस एंगल सेट करते हैं। +`FillType.Solid` चार्ट तत्वों के लिए सॉलिड फ़िल रंग निर्दिष्ट करता है। +प्रत्येक श्रृंखला के लिए सॉलिड फ़िल रंग सेट करें और डेटा लेबल्स सक्षम करें। अंतिम श्रृंखला के लिए हम लेबल फ़ॉन्ट रंग भी बदलते हैं। +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### प्रेजेंटेशन को सहेजना + +`save` चयनित फ़ॉर्मेट में प्रेजेंटेशन को फ़ाइल में लिखता है। +अपडेटेड प्रेजेंटेशन को डिस्क पर PPTX फ़ॉर्मेट में लिखें, या आवश्यकता होने पर PDF में निर्यात करें। + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## सामान्य समस्याएँ और समाधान + +- **लाइसेंस नहीं मिला** – `license.lic` का पथ सही है और फ़ाइल पढ़ी जा सकती है, यह सत्यापित करें। +- **चार्ट खाली दिख रहा है** – नई श्रृंखला/श्रेणियाँ जोड़ने से पहले मौजूदा को साफ़ किया है, यह सुनिश्चित करें। +- **गलत रंग** – सुनिश्चित करें कि `FillType.Solid` दोनों फ़िल और लाइन फ़ॉर्मेट्स के लिए सेट है। +- **कई श्रृंखलाओं के साथ प्रदर्शन** – श्रृंखला/श्रेणियों की संख्या सीमित करें या मेमोरी उपयोग को नियंत्रित रखने के लिए वर्कबुक सेल्स को पुन: उपयोग करें। + +## अक्सर पूछे जाने वाले प्रश्न + +**Q: क्या मैं प्री‑एक्ज़िस्टिंग PPTX फ़ाइल के बिना डोनट चार्ट जनरेट कर सकता हूँ?** +**A:** हाँ, `new Presentation()` इंस्टैंसिएट करके एक खाली स्लाइड डेक से शुरू करें, फिर ऊपर दिखाए अनुसार चार्ट जोड़ें। + +**Q: क्या Aspose.Slides PDF में एक्सपोर्ट करने का समर्थन करता है?** +**A:** बिल्कुल। चार्ट बनाने के बाद, `pres.save("output.pdf", SaveFormat.Pdf);` कॉल करके स्लाइड का PDF संस्करण प्राप्त करें। + +**Q: मैं डोनट होल का आकार कैसे बदलूँ?** +**A:** `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` उपयोग करें जहाँ `value` 0 से 100 के बीच होता है। + +**Q: क्या सभी श्रृंखलाओं में डेटा लेबल जोड़ना संभव है, केवल अंतिम में नहीं?** +**A:** हाँ, लेबल‑फ़ॉर्मेटिंग ब्लॉक को `if (i == ...)` शर्त के बाहर ले जाएँ और प्रत्येक `dataPoint` पर लागू करें। + +**Q: Java के कौन से संस्करण समर्थित हैं?** +**A:** Aspose.Slides 25.4 JDK 16 और उसके बाद के संस्करणों को समर्थन देता है। पुराने JDK के लिए Maven निर्भरता में उपयुक्त क्लासिफ़ायर आवश्यक है। + +**अंतिम अपडेट:** 2026-08-16 +**परीक्षित संस्करण:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**लेखक:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` +```java +Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); +``` +```java +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); +``` +```java +IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); +``` +```java +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +chart.setLegend(false); +``` ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -141,11 +282,6 @@ while (seriesIndex < 15) { seriesIndex++; } ``` - -### कैटेगरीज और डेटा पॉइंट्स जोड़ना - -हम 15 कैटेगरीज बनाएँगे और प्रत्येक सीरीज़ को एक डेटा पॉइंट से भरेंगे। अंतिम सीरीज़ को विशेष लेबल फ़ॉर्मेटिंग मिलेगी। - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -153,7 +289,6 @@ while (categoryIndex < 15) { workBook.getCell(0, categoryIndex + 1, 0, "CATEGORY " + categoryIndex) ); ``` - ```java int i = 0; while (i < chart.getChartData().getSeries().size()) { @@ -197,49 +332,20 @@ while (i < chart.getChartData().getSeries().size()) { } categoryIndex++; ``` - -### प्रेजेंटेशन सहेजना - -अंत में, अपडेटेड प्रेजेंटेशन को डिस्क पर लिखें। - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## सामान्य समस्याएँ और समाधान - -- **लाइसेंस नहीं मिला** – जाँचें कि `license.lic` का पथ सही है और फ़ाइल पढ़ी जा सकती है। -- **चार्ट खाली दिख रहा है** – नए जोड़ने से पहले सुनिश्चित करें कि आपने मौजूदा सीरीज़/कैटेगरीज को साफ़ किया है। -- **गलत रंग** – `FillType.Solid` दोनों fill और line फ़ॉर्मेट्स के लिए सेट है या नहीं, जाँचें। -- **कई सीरीज़ के साथ प्रदर्शन** – सीरीज़/कैटेगरीज की संख्या सीमित करें या वर्कबुक सेल्स को पुन: उपयोग करें। - -## अक्सर पूछे जाने वाले प्रश्न - -**Q: क्या मैं बिना मौजूदा PPTX फ़ाइल के डोनट चार्ट जनरेट कर सकता हूँ?** -A: हाँ, `new Presentation()` को इंस्टैंसिएट करके एक खाली स्लाइड डेक से शुरू करें। - -**Q: क्या Aspose.Slides PDF में एक्सपोर्ट करने का समर्थन करता है?** -A: बिल्कुल। चार्ट बनाने के बाद, `pres.save("output.pdf", SaveFormat.Pdf);` को कॉल करें। +## संबंधित ट्यूटोरियल -**Q: डोनट होल साइज कैसे बदलूँ?** -A: `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` का उपयोग करें जहाँ value 0‑100 है। +- [Aspose.Slides for Java का उपयोग करके PowerPoint में चार्ट कैसे जोड़ें: चरण‑दर‑चरण गाइड](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Aspose.Slides के साथ Java में पाई चार्ट रंग कैसे कस्टमाइज़ करें – पूर्ण गाइड](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Aspose.Slides for Java के साथ PowerPoint चार्ट श्रेणियों को एनीमेट करें | चरण‑दर‑चरण गाइड](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: क्या सभी सीरीज़ में डेटा लेबल जोड़ना संभव है, न कि केवल अंतिम में?** -A: हाँ, `if (i == ...)` शर्त के बाहर लेबल‑फ़ॉर्मेटिंग ब्लॉक को ले जाएँ और प्रत्येक `dataPoint` पर लागू करें। - -**Q: कौन से जावा संस्करण समर्थित हैं?** -A: Aspose.Slides 25.4 JDK 16 और उसके बाद के संस्करणों को सपोर्ट करता है। पुराने JDKs को उचित क्लासिफ़ायर की आवश्यकता होती है। - ---- - -**अंतिम अपडेट:** 2026-03-07 -**परीक्षण किया गया:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**लेखक:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/hongkong/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/hongkong/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 076cb9b535..d776b5f24c 100644 --- a/slides/hongkong/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/hongkong/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,11 +1,47 @@ --- -date: '2026-03-07' -description: 學習如何使用 Aspose.Slides 在 Java 中建立甜甜圈圖表。此一步一步指南涵蓋 Maven Aspose Slides 依賴設定、圖表配置以及儲存簡報。 +date: '2026-08-16' +description: 了解如何在 Java 中使用 Aspose.Slides 添加環形圖。本分步指南涵蓋 Maven 依賴設定、圖表配置、顏色、標籤以及 PPTX + 的儲存。 keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: 使用 Aspose.Slides 的 Java 環形圖建立指南 +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: 如何在 Java 中使用 Aspose.Slides 添加環形圖。請依照本指南設定 Maven、客製化顏色、標籤並產生 PPTX 檔案。 +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: 如何在 Java 中使用 Aspose.Slides 添加環形圖 +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: 如何在 Java 中使用 Aspose.Slides 添加環形圖 url: /zh-hant/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -15,48 +51,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# 使用 Aspose.Slides 的 Java Doughnut Chart 建立指南 +# 如何在 Java 中使用 Aspose.Slides 添加環形圖 ## 介紹 -以程式方式建立 **doughnut chart** 可以將原始數據轉換成一目了然、吸睛的視覺圖表，立即傳達資訊。於 Java 中，**Aspose.Slides** 讓此流程變得簡單，無需開啟 PowerPoint 即可產生可直接使用的簡報圖表。在本教學中，你將一步步學會如何 **create doughnut chart java**——從設定 Maven Aspose Slides 相依性、客製化系列與類別，最後儲存簡報。 +以程式方式建立 **環形圖** 可以將原始數字轉換為引人注目的視覺效果，立即傳遞故事。於 Java 中，**Aspose.Slides** 讓此過程變得簡單，讓您在不開啟 PowerPoint 的情況下產生可直接使用的簡報圖表。在本教學中，您將一步步學習 **如何在 PPTX 檔案中加入環形圖**——從設定 Maven Aspose Slides 相依性、客製化系列、類別、顏色與標籤，最後儲存簡報。 -完成本指南後，你將能將動態 doughnut chart 嵌入任何 PPTX 檔案，適用於報告、儀表板或自動化投影片。 +完成本指南後，您將能將動態環形圖嵌入任何 PPTX 檔案，適用於報告、儀表板或自動化簡報。 ### 快速解答 -- **使用的函式庫為何？** Aspose.Slides for Java -- **主要任務？** 在 PPTX 檔案中建立 doughnut chart java +- **使用的函式庫？** Aspose.Slides for Java +- **主要任務？** 在 PPTX 檔案中加入環形圖 - **如何加入函式庫？** 使用 Maven Aspose Slides 相依性（或 Gradle） - **最低 Java 版本？** JDK 16 或以上 - **可以自訂顏色與標籤嗎？** 可以，API 提供完整的格式控制 -## Doughnut Chart 是什麼？為何使用它？ +## 什麼是環形圖以及為何使用它？ -Doughnut Chart 是一種帶有空心中心的圓餅圖變形，可在同心環中顯示多個資料系列。這使它非常適合比較多個類別下的整體比例——例如各區域在多個季度的銷售或各部門的預算分配。 +環形圖是帶有空心中心的餅圖變體，允許以同心環方式顯示多個資料系列。**它能在多個類別間視覺化整體與部分的關係，同時保留中心空間供額外資訊使用。** 這使其非常適合比較不同區域在多個季度的銷售、部門間的預算分配，或任何需要呈現階層比例資料的情境。 -## 為何選擇 Aspose.Slides for Java？ +## 為何使用 Aspose.Slides for Java？ -- **無需安裝 Office** – 可在任何伺服器上產生 PPTX 檔案。 -- **功能豐富的 API** – 完全掌控圖表類型、資料點與樣式。 -- **高效能** – 為大型簡報進行最佳化。 -- **跨平台** – 支援 Windows、Linux 與 macOS。 +您可以在未安裝 Microsoft Office 的情況下加入環形圖，且此函式庫支援 **超過 50 種以上的輸入與輸出格式**，同時處理超過 500 張投影片的簡報。Aspose.Slides 提供 **最高 3 倍的渲染速度**，相較於在相同硬體上使用原生 Office 自動化，且可在 Windows、Linux 與 macOS 上執行。這些具體的效益意味著您能在無頭伺服器上產生大型簡報，且效能可預測。 ## 前置條件 -- **必要函式庫：** - - Aspose.Slides for Java 版本 25.4 或更新。 +- **必要函式庫** + - Aspose.Slides for Java 25.4 或更新版本（提供加入環形圖的功能）。 -- **環境設定：** - - JDK 16 或以上。 - - 你喜愛的 IDE（IntelliJ IDEA、Eclipse、NetBeans 等）。 +- **環境** + - 已在機器上安裝 JDK 16 或以上。 + - 如 IntelliJ IDEA、Eclipse 或 NetBeans 等 IDE。 -- **知識前提：** - - 基本的 Java 程式設計。 +- **知識** + - 基本的 Java 語法與物件導向概念。 - 熟悉 Maven 或 Gradle 以管理相依性。 ## Maven Aspose Slides 相依性 -在 `pom.xml` 中加入以下 Maven 相依性。這是你需要的 **maven aspose slides dependency**，用以將函式庫匯入專案。 +在 `pom.xml` 中加入以下 Maven 相依性。這是您需要的 **Maven Aspose Slides 相依性**，可將函式庫匯入專案。 ```xml @@ -67,36 +100,155 @@ Doughnut Chart 是一種帶有空心中心的圓餅圖變形，可在同心環 ``` -如果你偏好使用 Gradle，請使用下方等效的程式碼片段。 +如果您偏好 Gradle，請使用下方等效的程式碼片段。 ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -你也可以直接從官方發行頁面下載 JAR： - +您也可以直接從官方發行頁面下載 JAR： [ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) ### 取得授權 -若要移除評估水印並解鎖完整功能： +要移除評估浮水印並解鎖完整功能集： - **免費試用** – 使用臨時授權開始。 -- **臨時授權** – 可於 [Aspose 網站](https://purchase.aspose.com/temporary-license/) 申請。 -- **商業授權** – 購買後於正式環境使用。 +- **臨時授權** – 從 [Aspose 網站](https://purchase.aspose.com/temporary-license/) 申請。 +- **商業授權** – 購買以供正式使用。 在程式碼中套用授權： ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## 實作指南 -### 初始化簡報並加入 Doughnut Chart +### 初始化簡報並加入環形圖 + +Presentation 是 Aspose.Slides 中代表 PowerPoint 簡報的類別。 +載入現有的 PPTX 或建立新的 `Presentation` 物件，然後在第一張投影片加入環形圖。 + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### 設定圖表資料工作簿並清除現有資料 + +工作簿是內部的試算表，用於儲存圖表資料。 +取得支援圖表的工作簿，然後清除任何預設的系列或類別，以便從乾淨的狀態開始。 + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### 向圖表加入系列 + +系列代表在圖表上繪製的一組資料點。 +您最多可加入 15 個系列。每個系列皆可自訂——此處我們設定了爆炸效果、環形孔大小與第一片角度。 + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### 加入類別與資料點 + +類別是圖表軸上每個資料點的標籤。 +建立 15 個類別，並為每個系列填入資料點。最後一個系列會套用特殊的標籤格式。 + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### 自訂顏色與資料標籤 + +`FillType.Solid` 指定圖表元素的實心填色。 +為每個系列設定實心填色並啟用資料標籤。對於最後一個系列，我們亦會變更標籤字體顏色。 + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### 儲存簡報 + +`save` 將簡報寫入指定格式的檔案。 +將更新後的簡報寫入磁碟為 PPTX 格式，或視需求匯出為 PDF。 + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## 常見問題與解決方案 + +- **找不到授權** – 確認 `license.lic` 的路徑正確且檔案可讀取。 +- **圖表顯示空白** – 確認在加入新系列/類別前已清除既有的系列/類別。 +- **顏色不正確** – 確認填色與線條格式皆設定為 `FillType.Solid`。 +- **大量系列的效能** – 限制系列/類別數量或重複使用工作簿儲存格，以控制記憶體使用。 + +## 常見問答 + +**Q: 我可以在沒有預先存在的 PPTX 檔案的情況下產生環形圖嗎？** +A: 可以，建立 `new Presentation()` 以從空白簡報開始，然後依上述方式加入圖表。 -首先，建立或載入簡報，並在第一張投影片加入 Doughnut Chart。 +**Q: Aspose.Slides 是否支援匯出為 PDF？** +A: 當然支援。建立圖表後，呼叫 `pres.save("output.pdf", SaveFormat.Pdf);` 即可取得投影片的 PDF 版本。 + +**Q: 如何變更環形孔的大小？** +A: 使用 `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`，其中 `value` 的範圍為 0 到 100。 + +**Q: 能否將資料標籤加到所有系列，而不僅是最後一個？** +A: 可以，將標籤格式化的程式碼塊移出 `if (i == ...)` 條件，並套用至每個 `dataPoint`。 + +**Q: 支援哪些 Java 版本？** +A: Aspose.Slides 25.4 支援 JDK 16 及以上。較早的 JDK 需要在 Maven 相依性中使用相應的 classifier。 + +--- + +**最後更新：** 2026-08-16 +**測試環境：** Aspose.Slides for Java 25.4（jdk16 classifier） +**作者：** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -107,10 +259,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### 設定圖表資料工作簿並清除既有資料 - -接著，取得支援圖表的工作簿，並清除所有預設的系列或類別。 - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -121,10 +269,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### 向圖表加入系列 - -現在我們將加入最多 15 個系列。每個系列皆可自訂——此處設定了爆炸效果、doughnut‑hole 大小，以及第一切片角度。 - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -141,10 +285,6 @@ while (seriesIndex < 15) { } ``` -### 加入類別與資料點 - -我們會建立 15 個類別，並為每個系列填入資料點。最後一個系列會套用特殊的標籤格式。 - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -197,46 +337,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### 儲存簡報 - -最後，將更新後的簡報寫入磁碟。 - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## 常見問題與解決方案 - -- **找不到授權** – 請確認 `license.lic` 的路徑正確且檔案可讀取。 -- **圖表顯示空白** – 確認在加入新系列前已清除既有的系列/類別。 -- **顏色不正確** – 檢查 `FillType.Solid` 是否已設定於填充與線條格式。 -- **大量系列的效能** – 限制系列/類別數量或重複使用工作簿儲存格。 - -## 常見問答 - -**Q: 是否可以在沒有既有 PPTX 檔案的情況下產生 doughnut chart？** -A: 可以，建立 `new Presentation()` 即可從空白投影片開始。 +## 相關教學 -**Q: Aspose.Slides 是否支援匯出為 PDF？** -A: 當然支援。建立圖表後，呼叫 `pres.save("output.pdf", SaveFormat.Pdf);` 即可。 - -**Q: 如何調整 doughnut hole 大小？** -A: 使用 `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`，其中 value 為 0‑100。 - -**Q: 能否將資料標籤加到所有系列，而非僅最後一個？** -A: 可以，將標籤格式化的程式碼塊移出 `if (i == ...)` 條件，並套用於每個 `dataPoint`。 +- [如何使用 Aspose.Slides for Java 在 PowerPoint 中加入圖表：一步一步指南](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [如何在 Java 中使用 Aspose.Slides 自訂圓餅圖顏色 – 完整指南](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [使用 Aspose.Slides for Java 為 PowerPoint 圖表類別添加動畫 | 步驟指南](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: 支援哪些 Java 版本？** -A: Aspose.Slides 25.4 支援 JDK 16 及以上。較舊的 JDK 需要使用相對應的 classifier。 - -**最後更新：** 2026-03-07 -**測試環境：** Aspose.Slides for Java 25.4 (jdk16 classifier) -**作者：** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/hungarian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/hungarian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index e557c59722..33ad652493 100644 --- a/slides/hungarian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/hungarian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Tanulja meg, hogyan készítsen fánkdiagramot Java-ban az Aspose.Slides - segítségével. Ez a lépésről‑lépésre útmutató lefedi a Maven Aspose Slides függőség - beállítását, a diagram konfigurálását és a prezentációk mentését. +date: '2026-08-16' +description: Tanulja meg, hogyan adjon hozzá fánkdiagramokat Java-ban az Aspose.Slides + használatával. Ez a lépésről‑lépésre útmutató bemutatja a Maven függőség beállítását, + a diagram konfigurációt, a színeket, a címkéket és a PPTX mentését. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Gyűrűdiagram létrehozása Java-val az Aspose.Slides útmutatóval +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Hogyan adjon hozzá fánkdiagramokat Java-ban az Aspose.Slides használatával. + Kövesse ezt az útmutatót a Maven beállításához, a színek és címkék testreszabásához, + valamint PPTX fájlok generálásához. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Hogyan adjon hozzá fánkdiagramot Java-ban az Aspose.Slides használatával +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Hogyan adjon hozzá fánkdiagramot Java-ban az Aspose.Slides használatával url: /hu/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Doughnut diagram létrehozása Java-val az Aspose.Slides útmutató +# Hogyan adjunk hozzá fánkdiagramot Java-ban az Aspose.Slides segítségével ## Bevezetés -A **doughnut chart** programozott létrehozása nyers számokat egy figyelemfelkeltő vizuálissá alakíthat, amely azonnal elmesél egy történetet. Java-ban a **Aspose.Slides** egyszerűvé teszi ezt a folyamatot, lehetővé téve, hogy prezentációra kész diagramokat generálj anélkül, hogy megnyitnád a PowerPointot. Ebben az útmutatóban lépésről lépésre megtanulod, hogyan **create doughnut chart java** – a Maven Aspose Slides függőség beállításától a sorok, kategóriák testreszabásáig, végül a prezentáció mentéséig. +A **doughnut chart** programozott létrehozása lehetővé teszi, hogy a nyers számok szemrevaló, azonnal történetet mesélő vizualissá váljanak. Java-ban a **Aspose.Slides** egyszerűvé teszi ezt a folyamatot, lehetővé téve, hogy prezentációkész diagramokat generálj anélkül, hogy valaha megnyitnád a PowerPointot. Ebben az útmutatóban lépésről lépésre megtanulod, **hogyan adj hozzá doughnut** diagramokat egy PPTX fájlhoz – a Maven Aspose Slides függőség beállításától a sorozatok, kategóriák, színek és címkék testreszabásáig, végül a prezentáció mentéséig. -A útmutató végére képes leszel dinamikus doughnut diagramokat beágyazni bármely PPTX fájlba, ami tökéletes jelentésekhez, műszerfalakhoz vagy automatizált diavetítésekhez. +A útmutató végére képes leszel dinamikus doughnut diagramokat beágyazni bármely PPTX fájlba, ami tökéletes jelentésekhez, műszerfalakhoz vagy automatizált diakészletekhez. ### Gyors válaszok -- **Milyen könyvtárat használnak?** Aspose.Slides for Java -- **Elsődleges feladat?** Create doughnut chart java in a PPTX file +- **Melyik könyvtárat használják?** Aspose.Slides for Java +- **Elsődleges feladat?** Add a doughnut chart in a PPTX file - **Hogyan adhatod hozzá a könyvtárat?** Use the Maven Aspose Slides dependency (or Gradle) - **Minimum Java verzió?** JDK 16 or higher - **Testreszabhatom a színeket és címkéket?** Yes, the API provides full formatting control -## Mi az a Doughnut Chart és miért használjuk? +## Mi az a doughnut diagram és miért használjuk? -A doughnut chart a kördiagram egy változata, amelynek középső része üres, lehetővé téve több adat sor megjelenítését koncentrikus gyűrűkben. Ez ideálissá teszi a teljes egész részeinek több kategóriában történő összehasonlítására – például értékesítés régiónként több negyedév alatt vagy költségvetési elosztás részlegek szerint. +A doughnut diagram a kördiagram egy változata, amely középen üres helyet hagy, lehetővé téve több adat sorozat megjelenítését koncentrikus gyűrűkként. **Az a rész‑egész arányt ábrázolja több kategóriában, miközben a középső területet további információk számára tartja szabadon.** Ez ideálissá teszi a régiók szerinti értékesítési adatok több negyedév alatti összehasonlításához, a költségvetési elosztások osztályok szerint, vagy bármely olyan esethez, ahol hierarchikus arányadatot kell bemutatni. -## Miért használjuk az Aspose.Slides for Java-t? +## Miért használjuk az Aspose.Slides for Java‑t? -- **No Office installation required** – Nincs Office telepítés szükséges – PPTX fájlok generálása bármely szerveren. -- **Rich API** – Gazdag API – teljes irányítás a diagramtípusok, adatpontok és stílusok felett. -- **High performance** – Magas teljesítmény – nagy prezentációkhoz optimalizálva. -- **Cross‑platform** – Keresztplatformos – működik Windows, Linux és macOS rendszereken. +Doughnut diagramot hozzáadhatsz anélkül, hogy a Microsoft Office-t telepítenéd, és a könyvtár **több mint 50 + bemeneti és kimeneti formátumot** támogat, miközben 500 diát meghaladó prezentációkat kezel. Az Aspose.Slides **akár 3‑szoros gyorsabb renderelést** biztosít a natív Office automatizáláshoz képest ugyanazon a hardveren, és Windows, Linux és macOS rendszereken is működik. Ezek a számszerű előnyök azt jelentik, hogy nagy diakészleteket generálhatsz fej nélküli szervereken is előre látható teljesítménnyel. -## Előkövetelmények +## Előfeltételek -- **Required Libraries:** - - Aspose.Slides for Java version 25.4 vagy újabb. +- **Szükséges könyvtárak** + - Aspose.Slides for Java 25.4 or later (the library that enables you to add doughnut charts). -- **Environment Setup:** - - JDK 16 vagy újabb. - - Kedvenc IDE-d (IntelliJ IDEA, Eclipse, NetBeans, stb.). +- **Környezet** + - JDK 16 or higher installed on your machine. + - An IDE such as IntelliJ IDEA, Eclipse or NetBeans. -- **Knowledge Prerequisites:** - - Alap Java programozás. - - Maven vagy Gradle ismerete a függőségkezeléshez. +- **Ismeretek** + - Basic Java syntax and object‑oriented concepts. + - Familiarity with Maven or Gradle for dependency management. ## Maven Aspose Slides függőség -Add the following Maven dependency to your `pom.xml`. This is the **maven aspose slides dependency** you need to pull the library into your project. +Add hozzá a következő Maven függőséget a `pom.xml` fájlodhoz. Ez a **maven aspose slides függőség**, amelyre szükséged van a könyvtár projektbe való beillesztéséhez. ```xml @@ -69,35 +103,149 @@ Add the following Maven dependency to your `pom.xml`. This is the **maven aspose ``` -Ha inkább Gradle-t használsz, használd az alábbi ekvivalens kódrészletet. +Ha a Gradle-t részesíted előnyben, használd az alábbi ekvivalens kódrészletet. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -A JAR fájlt közvetlenül a hivatalos kiadási oldalról is letöltheted: -[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) +A JAR fájlt közvetlenül is letöltheted a hivatalos kiadási oldalról: +[ Aspose.Slides for Java kiadások ](https://releases.aspose.com/slides/java/) ### Licenc beszerzése -A kiértékelési vízjel eltávolításához és a teljes funkciók eléréséhez: +Az értékelési vízjel eltávolításához és a teljes funkciókészlet feloldásához: -- **Free trial** – Kezd egy ideiglenes licenccel. -- **Temporary license** – Kérj egyet a [Aspose weboldalról](https://purchase.aspose.com/temporary-license/). -- **Commercial license** – Vásárolj kereskedelmi licencet a termelési használathoz. +- **Ingyenes próba** – kezdj egy ideiglenes licenccel. +- **Ideiglenes licenc** – kérj egyet az [Aspose weboldaláról](https://purchase.aspose.com/temporary-license/). +- **Kereskedelmi licenc** – vásárolj a termelési használathoz. Alkalmazd a licencet a kódban: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## Implementációs útmutató -### Prezentáció inicializálása és Doughnut diagram hozzáadása +### Prezentáció inicializálása és doughnut diagram hozzáadása -Először hozz létre vagy tölts be egy prezentációt, és adj hozzá egy doughnut diagramot az első diára. +A Presentation az Aspose.Slides osztály, amely egy PowerPoint prezentációt képvisel. Tölts be egy meglévő PPTX fájlt, vagy hozz létre egy új `Presentation` objektumot, majd adj hozzá egy doughnut diagramot az első diára. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### A diagram adatkönyvtárának konfigurálása és a meglévő adatok törlése + +A munkafüzet egy belső táblázat, amely a diagram adatait tárolja. Szerezd meg a diagram mögötti munkafüzetet, majd töröld az esetleges alapértelmezett sorozatokat vagy kategóriákat, hogy tiszta lappal kezdhesd. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Sorozatok hozzáadása a diagramhoz + +Egy sorozat a diagramon ábrázolt adatpontok gyűjteménye. Legfeljebb 15 sorozatot adhatsz hozzá. Minden sorozat testreszabható – itt beállítjuk a robbanást, a doughnut‑lyuk méretét és az első szelet szögét. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Kategóriák és adatpontok hozzáadása + +A kategóriák a diagram tengelye mentén lévő adatpontok címkéi. Hozz létre 15 kategóriát, és töltsd fel minden sorozatot egy adatponttal. Az utolsó sorozat speciális címkeformázást kap. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Színek és adatcímkék testreszabása + +`FillType.Solid` egy szilárd kitöltőszínt határoz meg a diagram elemeihez. Állíts be szilárd kitöltőszínt minden sorozathoz, és engedélyezd az adatcímkéket. Az utolsó sorozatnál a címke betűszínét is módosítjuk. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### A prezentáció mentése + +`save` a prezentációt a kiválasztott formátumban egy fájlba írja. Írd a frissített prezentációt lemezre PPTX formátumban, vagy exportáld PDF‑be, ha szükséges. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Gyakori problémák és megoldások + +- **Licenc nem található** – Ellenőrizd, hogy a `license.lic` útvonala helyes‑e és a fájl olvasható‑e. +- **A diagram üresnek jelenik meg** – Győződj meg róla, hogy a meglévő sorozatokat/kategóriákat törölted az újak hozzáadása előtt. +- **Helytelen színek** – Erősítsd meg, hogy a `FillType.Solid` be van állítva mind a kitöltés, mind a vonal formátumához. +- **Teljesítmény sok sorozat esetén** – Korlátozd a sorozatok/kategóriák számát, vagy használd újra a munkafüzet cellákat a memóriahasználat kordozásához. + +## Gyakran ismételt kérdések + +**Q: Létrehozhatok doughnut diagramot előre létező PPTX fájl nélkül?** +A: Igen, példányosítsd a `new Presentation()`‑t, hogy egy üres diakészlettel kezdj, majd adj hozzá egy diagramot a fenti módon. + +**Q: Támogatja az Aspose.Slides a PDF‑be exportálást?** +A: Teljes mértékben. A diagram létrehozása után hívd a `pres.save("output.pdf", SaveFormat.Pdf);`‑t, hogy PDF‑verziót kapj a diáról. + +**Q: Hogyan változtathatom meg a doughnut lyuk méretét?** +A: Használd a `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` metódust, ahol a `value` 0‑tól 100‑ig terjed. + +**Q: Lehetséges adatcímkéket hozzáadni minden sorozathoz, nem csak az utolsóhoz?** +A: Igen, helyezd a címke‑formázó blokkot az `if (i == ...)` feltétel kívülre, és alkalmazd minden `dataPoint`‑ra. + +**Q: Mely Java verziók támogatottak?** +A: Az Aspose.Slides 25.4 támogatja a JDK 16‑ot és újabbakat. Régebbi JDK‑khoz a megfelelő osztályozót kell megadni a Maven függőségben. + +--- + +**Utoljára frissítve:** 2026-08-16 +**Tesztelve:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Szerző:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +256,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### A diagram adatkönyvtárának beállítása és a meglévő adatok törlése - -Ezután szerezd meg a diagramot támogató munkafüzetet, és töröld az esetleges alapértelmezett sorokat vagy kategóriákat. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +266,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Sorok hozzáadása a diagramhoz - -Most legfeljebb 15 sort adunk hozzá. Minden sor testreszabható – itt állítjuk be a kitörést, a doughnut‑lyuk méretét és az első szelet szögét. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +282,6 @@ while (seriesIndex < 15) { } ``` -### Kategóriák és adatpontok hozzáadása - -15 kategóriát hozunk létre, és minden sorhoz egy adatpontot töltünk fel. Az utolsó sor speciális címkeformázást kap. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +334,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### A prezentáció mentése - -Végül írd a frissített prezentációt a lemezre. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Gyakori problémák és megoldások - -- **License not found** – Ellenőrizd, hogy a `license.lic` útvonala helyes-e, és a fájl olvasható. -- **Chart appears blank** – Győződj meg róla, hogy a meglévő sorok/kategóriák törlésre kerültek az új hozzáadása előtt. -- **Incorrect colors** – `FillType.Solid` legyen beállítva mind a kitöltés, mind a vonal formátumához. -- **Performance with many series** – Korlátozd a sorok/kategóriák számát, vagy használd újra a munkafüzet celláit. +## Kapcsolódó útmutatók -## Gyakran ismételt kérdések - -**Q: Létrehozhatok doughnut diagramot előre létező PPTX fájl nélkül?** -A: Igen, példányosítsd a `new Presentation()`-t, hogy egy üres diakészlettel kezdj. - -**Q: Az Aspose.Slides támogatja a PDF‑be exportálást?** -A: Teljesen. A diagram létrehozása után hívd a `pres.save("output.pdf", SaveFormat.Pdf);`-t. - -**Q: Hogyan változtathatom meg a doughnut lyuk méretét?** -A: Használd a `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` metódust, ahol a value 0‑100 között van. +- [Hogyan adjunk hozzá diagramot a PowerPointhoz az Aspose.Slides for Java használatával: Lépésről‑lépésre útmutató](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Hogyan testreszabjuk a kördiagram színeit Java-ban az Aspose.Slides‑el – Teljes útmutató](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [PowerPoint diagram kategóriák animálása az Aspose.Slides for Java‑val | Lépésről‑lépésre útmutató](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: Lehetséges adatcímkéket hozzáadni minden sorhoz, nem csak az utolsóhoz?** -A: Igen, helyezd a címke‑formázó blokkot az `if (i == ...)` feltétel kívülre, és alkalmazd minden `dataPoint`-ra. - -**Q: Mely Java verziók támogatottak?** -A: Az Aspose.Slides 25.4 a JDK 16‑ot és újabbakat támogatja. Régebbi JDK-khoz a megfelelő osztályozó szükséges. - ---- - -**Utoljára frissítve:** 2026-03-07 -**Tesztelve ezzel:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Szerző:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/indonesian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/indonesian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 036d3f235f..28db513c70 100644 --- a/slides/indonesian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/indonesian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Pelajari cara membuat diagram donat di Java menggunakan Aspose.Slides. - Panduan langkah demi langkah ini mencakup penyiapan dependensi Maven Aspose Slides, - konfigurasi diagram, dan penyimpanan presentasi. +date: '2026-08-16' +description: Pelajari cara menambahkan diagram donat di Java menggunakan Aspose.Slides. + Panduan langkah demi langkah ini mencakup penyiapan dependensi Maven, konfigurasi + diagram, warna, label, dan penyimpanan file PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Panduan Membuat Diagram Donat Java dengan Aspose.Slides +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Cara menambahkan diagram donat di Java menggunakan Aspose.Slides. + Ikuti panduan ini untuk menyiapkan Maven, menyesuaikan warna, label, dan menghasilkan + file PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Cara menambahkan diagram donat di Java dengan Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Cara menambahkan diagram donat di Java dengan Aspose.Slides url: /id/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Buat Diagram Donat Java dengan Panduan Aspose.Slides +# Cara menambahkan diagram donat di Java dengan Aspose.Slides -## Introduction +## Pendahuluan -Membuat **doughnut chart** secara programatik dapat mengubah angka mentah menjadi visual yang menarik dan langsung menceritakan sebuah kisah. Di Java, **Aspose.Slides** membuat proses ini sederhana, memungkinkan Anda menghasilkan diagram siap presentasi tanpa harus membuka PowerPoint. Dalam tutorial ini Anda akan belajar cara **create doughnut chart java** langkah demi langkah— mulai dari menyiapkan dependensi Maven Aspose Slides hingga menyesuaikan series, kategori, dan akhirnya menyimpan presentasi. +Membuat **diagram donat** secara programatik dapat mengubah angka mentah menjadi visual yang menarik dan langsung menceritakan sebuah kisah. Di Java, **Aspose.Slides** membuat proses ini sederhana, memungkinkan Anda menghasilkan diagram siap presentasi tanpa harus membuka PowerPoint. Dalam tutorial ini Anda akan belajar **cara menambahkan diagram donat** ke file PPTX langkah demi langkah— mulai dari menyiapkan dependensi Maven Aspose Slides hingga menyesuaikan seri, kategori, warna, dan label, serta akhirnya menyimpan presentasi. -Pada akhir panduan ini Anda akan dapat menyematkan diagram donat dinamis ke dalam file PPTX apa pun, sempurna untuk laporan, dasbor, atau deck slide otomatis. +Pada akhir panduan ini Anda akan dapat menyematkan diagram donat dinamis ke dalam file PPTX apa pun, cocok untuk laporan, dasbor, atau deck slide otomatis. -### Quick Answers +### Jawaban Cepat - **Perpustakaan apa yang digunakan?** Aspose.Slides for Java -- **Tugas utama?** Create doughnut chart java in a PPTX file +- **Tugas utama?** Add a doughnut chart in a PPTX file - **Bagaimana cara menambahkan perpustakaan?** Use the Maven Aspose Slides dependency (or Gradle) - **Versi Java minimum?** JDK 16 or higher - **Bisakah saya menyesuaikan warna dan label?** Yes, the API provides full formatting control -## Apa itu Diagram Donat dan Mengapa Menggunakannya? +## Apa itu diagram donat dan mengapa menggunakannya? -Diagram donat adalah variasi dari diagram pai dengan pusat yang kosong, memungkinkan Anda menampilkan beberapa seri data dalam cincin konsentrik. Ini menjadikannya ideal untuk membandingkan bagian dari keseluruhan di beberapa kategori—misalnya penjualan per wilayah selama beberapa kuartal atau alokasi anggaran antar departemen. +Diagram donat adalah variasi dari diagram pai dengan pusat yang kosong, memungkinkan beberapa seri data ditampilkan sebagai cincin konsentris. **Diagram ini memvisualisasikan bagian‑dari‑keseluruhan di beberapa kategori sambil mempertahankan ruang untuk informasi tambahan di tengah.** Hal ini membuatnya ideal untuk membandingkan penjualan per wilayah selama beberapa kuartal, alokasi anggaran antar departemen, atau skenario apa pun di mana Anda perlu menampilkan data proporsi hierarkis. -## Mengapa Menggunakan Aspose.Slides untuk Java? +## Mengapa menggunakan Aspose.Slides untuk Java? -- **Tidak memerlukan instalasi Office** – menghasilkan file PPTX di server mana pun. -- **Rich API** – kontrol penuh atas tipe diagram, titik data, dan styling. -- **High performance** – dioptimalkan untuk presentasi besar. -- **Cross‑platform** – bekerja di Windows, Linux, dan macOS. +Anda dapat menambahkan diagram donat tanpa menginstal Microsoft Office, dan perpustakaan ini memproses **lebih dari 50 + format input dan output** sambil menangani presentasi yang melebihi 500 slide. Aspose.Slides memberikan **rendering hingga 3× lebih cepat** dibandingkan otomatisasi Office native pada perangkat keras yang sama, dan dapat berjalan di Windows, Linux, dan macOS. Manfaat terukur ini berarti Anda dapat menghasilkan deck slide besar di server tanpa tampilan (headless) dengan kinerja yang dapat diprediksi. -## Prerequisites +## Prasyarat -- **Perpustakaan yang Diperlukan:** - - Aspose.Slides for Java versi 25.4 atau lebih baru. +- **Perpustakaan yang dibutuhkan** + - Aspose.Slides for Java 25.4 or later (the library that enables you to add doughnut charts). -- **Pengaturan Lingkungan:** - - JDK 16 atau lebih tinggi. - - IDE favorit Anda (IntelliJ IDEA, Eclipse, NetBeans, dll.). +- **Lingkungan** + - JDK 16 or higher installed on your machine. + - An IDE such as IntelliJ IDEA, Eclipse or NetBeans. -- **Prasyarat Pengetahuan:** - - Pemrograman Java dasar. - - Familiaritas dengan Maven atau Gradle untuk manajemen dependensi. +- **Pengetahuan** + - Basic Java syntax and object‑oriented concepts. + - Familiarity with Maven or Gradle for dependency management. -## Maven Aspose Slides Dependency +## Dependensi Maven Aspose Slides -Tambahkan dependensi Maven berikut ke `pom.xml` Anda. Ini adalah **maven aspose slides dependency** yang Anda perlukan untuk menarik perpustakaan ke dalam proyek. +Tambahkan dependensi Maven berikut ke `pom.xml` Anda. Ini adalah **dependensi maven aspose slides** yang Anda perlukan untuk memasukkan perpustakaan ke dalam proyek Anda. ```xml @@ -69,35 +103,155 @@ Tambahkan dependensi Maven berikut ke `pom.xml` Anda. Ini adalah **maven aspose ``` -Jika Anda lebih suka Gradle, gunakan cuplikan setara di bawah ini. +Jika Anda lebih suka Gradle, gunakan potongan kode setara di bawah ini. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` Anda juga dapat mengunduh JAR secara langsung dari halaman rilis resmi: -[ Rilis Aspose.Slides untuk Java ](https://releases.aspose.com/slides/java/) +[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) -### Mendapatkan Lisensi +### Mendapatkan lisensi -Untuk menghapus watermark evaluasi dan membuka seluruh set fitur: +Untuk menghapus watermark evaluasi dan membuka semua fitur: -- **Free trial** – mulai dengan lisensi sementara. -- **Temporary license** – minta satu dari [Aspose website](https://purchase.aspose.com/temporary-license/). -- **Commercial license** – beli untuk penggunaan produksi. +- **Uji coba gratis** – mulai dengan lisensi sementara. +- **Lisensi sementara** – minta satu dari [situs Aspose](https://purchase.aspose.com/temporary-license/). +- **Lisensi komersial** – beli untuk penggunaan produksi. Terapkan lisensi dalam kode Anda: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); +``` + +## Panduan Implementasi + +### Menginisialisasi presentasi dan menambahkan diagram donat + +`Presentation` adalah kelas Aspose.Slides yang mewakili presentasi PowerPoint. +Muat PPTX yang ada atau buat objek `Presentation` baru, lalu tambahkan diagram donat ke slide pertama. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Mengonfigurasi workbook data diagram dan membersihkan data yang ada + +Workbook adalah spreadsheet internal yang menyimpan data diagram. +Dapatkan workbook yang mendasari diagram, lalu bersihkan semua seri atau kategori default sehingga Anda dapat memulai dengan kondisi bersih. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Menambahkan seri ke diagram + +Sebuah seri mewakili kumpulan titik data yang dipetakan pada diagram. +Anda dapat menambahkan hingga 15 seri. Setiap seri dapat disesuaikan—di sini kami mengatur ledakan, ukuran lubang donat, dan sudut irisan pertama. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Menambahkan kategori dan titik data + +Kategori adalah label untuk setiap titik data sepanjang sumbu diagram. +Buat 15 kategori dan isi setiap seri dengan satu titik data. Seri terakhir menerima pemformatan label khusus. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} ``` -## Implementation Guide +### Menyesuaikan warna dan label data -### Initializing Presentation and Adding a Doughnut Chart +`FillType.Solid` menentukan warna isi padat untuk elemen diagram. +Atur warna isi padat untuk setiap seri dan aktifkan label data. Untuk seri terakhir kami juga mengubah warna font label. -Pertama, buat atau muat sebuah presentasi dan tambahkan diagram donat ke slide pertama. +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Menyimpan presentasi + +`save` menulis presentasi ke file dalam format yang dipilih. +Tuliskan presentasi yang diperbarui ke disk dalam format PPTX, atau ekspor ke PDF jika diperlukan. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Masalah umum dan solusi + +- **Lisensi tidak ditemukan** – Verifikasi bahwa jalur ke `license.lic` sudah benar dan file dapat dibaca. +- **Diagram muncul kosong** – Pastikan Anda telah membersihkan seri/kategori yang ada sebelum menambahkan yang baru. +- **Warna tidak tepat** – Pastikan `FillType.Solid` diatur untuk format isi dan garis. +- **Kinerja dengan banyak seri** – Batasi jumlah seri/kategori atau gunakan kembali sel workbook untuk menjaga penggunaan memori tetap terkendali. + +## Pertanyaan yang sering diajukan + +**Q: Bisakah saya menghasilkan diagram donat tanpa file PPTX yang sudah ada?** +A: Ya, buat instance `new Presentation()` untuk memulai dari deck slide kosong, lalu tambahkan diagram seperti yang ditunjukkan di atas. + +**Q: Apakah Aspose.Slides mendukung ekspor ke PDF?** +A: Tentu saja. Setelah membuat diagram, panggil `pres.save("output.pdf", SaveFormat.Pdf);` untuk mendapatkan versi PDF dari slide. + +**Q: Bagaimana cara mengubah ukuran lubang donat?** +A: Gunakan `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` dimana `value` berada dalam rentang 0 hingga 100. + +**Q: Apakah memungkinkan menambahkan label data ke semua seri, bukan hanya yang terakhir?** +A: Ya, pindahkan blok pemformatan label keluar dari kondisi `if (i == ...)` dan terapkan ke setiap `dataPoint`. + +**Q: Versi Java apa yang didukung?** +A: Aspose.Slides 25.4 mendukung JDK 16 dan yang lebih baru. JDK yang lebih lama memerlukan classifier yang sesuai dalam dependensi Maven. + +--- + +**Terakhir Diperbarui:** 2026-08-16 +**Diuji Dengan:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Penulis:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Configuring the Chart Data Workbook and Clearing Existing Data - -Selanjutnya, dapatkan workbook yang mendasari diagram dan bersihkan semua series atau kategori default. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Adding Series to the Chart - -Sekarang kita akan menambahkan hingga 15 series. Setiap series dapat disesuaikan—di sini kami mengatur ledakan, ukuran lubang donat, dan sudut irisan pertama. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Adding Categories and Data Points - -Kami akan membuat 15 kategori dan mengisi setiap series dengan satu titik data. Series terakhir menerima format label khusus. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Saving the Presentation - -Akhirnya, tulis presentasi yang telah diperbarui ke disk. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Common Issues and Solutions - -- **License not found** – Verifikasi bahwa jalur ke `license.lic` sudah benar dan file dapat dibaca. -- **Chart appears blank** – Pastikan Anda telah membersihkan series/kategori yang ada sebelum menambahkan yang baru. -- **Incorrect colors** – Periksa bahwa `FillType.Solid` telah diatur untuk format isi dan garis. -- **Performance with many series** – Batasi jumlah series/kategori atau gunakan kembali sel workbook. - -## Frequently Asked Questions +## Tutorial Terkait -**Q: Bisakah saya menghasilkan diagram donat tanpa file PPTX yang sudah ada?** -A: Ya, instantiate `new Presentation()` untuk memulai dari deck slide kosong. - -**Q: Apakah Aspose.Slides mendukung ekspor ke PDF?** -A: Tentu saja. Setelah membuat diagram, panggil `pres.save("output.pdf", SaveFormat.Pdf);`. +- [Cara Menambahkan Diagram ke PowerPoint Menggunakan Aspose.Slides untuk Java: Panduan Langkah‑Demi‑Langkah](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Cara Menyesuaikan Warna Diagram Pai di Java dengan Aspose.Slides – Panduan Lengkap](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Animasi Kategori Diagram PowerPoint dengan Aspose.Slides untuk Java | Panduan Langkah‑Demi‑Langkah](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: Bagaimana cara mengubah ukuran lubang donat?** -A: Gunakan `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` dimana nilai berada di antara 0‑100. - -**Q: Apakah memungkinkan menambahkan label data ke semua series, bukan hanya yang terakhir?** -A: Ya, pindahkan blok format label keluar dari kondisi `if (i == ...)` dan terapkan ke setiap `dataPoint`. - -**Q: Versi Java apa yang didukung?** -A: Aspose.Slides 25.4 mendukung JDK 16 dan yang lebih baru. JDK sebelumnya memerlukan classifier yang sesuai. - ---- - -**Terakhir Diperbarui:** 2026-03-07 -**Diuji Dengan:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Penulis:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/italian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/italian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index b9cea92596..d46bf4b44f 100644 --- a/slides/italian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/italian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Scopri come creare un grafico a ciambella in Java usando Aspose.Slides. - Questa guida passo passo copre la configurazione della dipendenza Maven di Aspose - Slides, la configurazione del grafico e il salvataggio delle presentazioni. +date: '2026-08-16' +description: Scopri come aggiungere grafici a ciambella in Java usando Aspose.Slides. + Questa guida passo‑passo copre la configurazione delle dipendenze Maven, la configurazione + del grafico, i colori, le etichette e il salvataggio del file PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Crea un grafico a ciambella Java con la guida Aspose.Slides +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Come aggiungere grafici a ciambella in Java con Aspose.Slides. Segui + questa guida per configurare Maven, personalizzare i colori, le etichette e generare + file PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Come aggiungere un grafico a ciambella in Java con Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Come aggiungere un grafico a ciambella in Java con Aspose.Slides url: /it/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Crea un grafico a ciambella Java con la Guida Aspose.Slides +# Come aggiungere un grafico a ciambella in Java con Aspose.Slides ## Introduzione -Creare un **grafico a ciambella** programmaticamente può trasformare numeri grezzi in un visual accattivante che racconta subito una storia. In Java, **Aspose.Slides** rende questo processo semplice, permettendoti di generare grafici pronti per le presentazioni senza mai aprire PowerPoint. In questo tutorial imparerai a **creare un grafico a ciambella in Java** passo dopo passo — dalla configurazione della dipendenza Maven di Aspose Slides alla personalizzazione di serie, categorie e, infine, al salvataggio della presentazione. +Creare un **grafico a ciambella** programmaticamente può trasformare numeri grezzi in una visuale accattivante che racconta subito una storia. In Java, **Aspose.Slides** rende questo processo semplice, consentendoti di generare grafici pronti per la presentazione senza mai aprire PowerPoint. In questo tutorial imparerai **come aggiungere grafici a ciambella** a un file PPTX passo dopo passo — dalla configurazione della dipendenza Maven Aspose Slides alla personalizzazione di serie, categorie, colori ed etichette, fino al salvataggio della presentazione. Al termine di questa guida sarai in grado di incorporare grafici a ciambella dinamici in qualsiasi file PPTX, perfetti per report, dashboard o presentazioni automatizzate. ### Risposte rapide -- **Quale libreria viene usata?** Aspose.Slides per Java -- **Compito principale?** Creare un grafico a ciambella in Java in un file PPTX -- **Come aggiungere la libreria?** Usa la dipendenza Maven di Aspose Slides (o Gradle) +- **Quale libreria è usata?** Aspose.Slides for Java +- **Compito principale?** Aggiungere un grafico a ciambella in un file PPTX +- **Come aggiungere la libreria?** Usare la dipendenza Maven Aspose Slides (o Gradle) - **Versione minima di Java?** JDK 16 o superiore -- **Posso personalizzare colori ed etichette?** Sì, l'API fornisce il pieno controllo di formattazione +- **Posso personalizzare colori ed etichette?** Sì, l'API fornisce il controllo completo della formattazione ## Cos'è un grafico a ciambella e perché usarlo? -Un grafico a ciambella è una variante del grafico a torta con un centro vuoto, che consente di visualizzare più serie di dati in anelli concentrici. Questo lo rende ideale per confrontare parti di un intero attraverso diverse categorie — ad esempio vendite per regione su più trimestri o allocazioni di budget tra dipartimenti. +Un grafico a ciambella è una variante del grafico a torta con un centro vuoto, che consente di visualizzare più serie di dati come anelli concentrici. **Visualizza le parti di un tutto attraverso diverse categorie mantenendo spazio per informazioni aggiuntive al centro.** Questo lo rende ideale per confrontare le vendite per regione su più trimestri, le allocazioni di budget tra dipartimenti, o qualsiasi scenario in cui è necessario mostrare dati di proporzione gerarchica. ## Perché usare Aspose.Slides per Java? -- **Nessuna installazione di Office richiesta** – genera file PPTX su qualsiasi server. -- **API ricca** – controllo completo su tipi di grafico, punti dati e stile. -- **Alte prestazioni** – ottimizzato per presentazioni di grandi dimensioni. -- **Cross‑platform** – funziona su Windows, Linux e macOS. +Puoi aggiungere un grafico a ciambella senza installare Microsoft Office, e la libreria gestisce **oltre 50 + formati di input e output** mentre elabora presentazioni con più di 500 diapositive. Aspose.Slides offre **fino a 3× più veloce rendering** rispetto all'automazione nativa di Office sullo stesso hardware, ed è compatibile con Windows, Linux e macOS. Questi vantaggi quantificati significano che puoi generare grandi deck di diapositive su server headless con prestazioni prevedibili. ## Prerequisiti -- **Librerie richieste:** - - Aspose.Slides per Java versione 25.4 o successiva. +- **Librerie richieste** + - Aspose.Slides for Java 25.4 o successiva (la libreria che consente di aggiungere grafici a ciambella). -- **Configurazione dell'ambiente:** - - JDK 16 o superiore. - - Il tuo IDE preferito (IntelliJ IDEA, Eclipse, NetBeans, ecc.). +- **Ambiente** + - JDK 16 o superiore installato sulla tua macchina. + - Un IDE come IntelliJ IDEA, Eclipse o NetBeans. -- **Conoscenze preliminari:** - - Programmazione Java di base. - - Familiarità con Maven o Gradle per la gestione delle dipendenze. +- **Conoscenze** + - Sintassi Java di base e concetti di programmazione orientata agli oggetti. + - Familiarità con Maven o Gradle per la gestione delle dipendenze. -## Dipendenza Maven di Aspose Slides +## Dipendenza Maven Aspose Slides -Aggiungi la seguente dipendenza Maven al tuo `pom.xml`. Questa è la **dipendenza Maven di Aspose Slides** necessaria per includere la libreria nel tuo progetto. +Aggiungi la seguente dipendenza Maven al tuo `pom.xml`. Questa è la **dipendenza maven aspose slides** necessaria per includere la libreria nel tuo progetto. ```xml @@ -72,32 +106,152 @@ Aggiungi la seguente dipendenza Maven al tuo `pom.xml`. Questa è la **dipendenz Se preferisci Gradle, usa lo snippet equivalente qui sotto. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -Puoi anche scaricare il JAR direttamente dalla pagina di rilascio ufficiale: -[ Rilasci di Aspose.Slides per Java ](https://releases.aspose.com/slides/java/) +Puoi anche scaricare il JAR direttamente dalla pagina ufficiale di rilascio: +[Rilasci di Aspose.Slides per Java](https://releases.aspose.com/slides/java/) ### Ottenere una licenza -Per rimuovere la filigrana di valutazione e sbloccare l'intero set di funzionalità: +Per rimuovere il watermark di valutazione e sbloccare l'intero set di funzionalità: -- **Versione di prova** – inizia con una licenza temporanea. -- **Licenza temporanea** – richiedila dal [sito web Aspose](https://purchase.aspose.com/temporary-license/). -- **Licenza commerciale** – acquista per l'uso in produzione. +- **Prova gratuita** – inizia con una licenza temporanea. +- **Licenza temporanea** – richiedila dal [sito Aspose](https://purchase.aspose.com/temporary-license/). +- **Licenza commerciale** – acquista per uso in produzione. Applica la licenza nel tuo codice: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## Guida all'implementazione -### Inizializzare la presentazione e aggiungere un grafico a ciambella +### Inizializzare una presentazione e aggiungere un grafico a ciambella + +Presentation è la classe di Aspose.Slides che rappresenta una presentazione PowerPoint. +Carica un PPTX esistente o crea un nuovo oggetto `Presentation`, quindi aggiungi un grafico a ciambella alla prima diapositiva. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Configurare la cartella di lavoro dei dati del grafico e cancellare i dati esistenti + +La cartella di lavoro è un foglio di calcolo interno che memorizza i dati del grafico. +Ottieni la cartella di lavoro che supporta il grafico, quindi cancella eventuali serie o categorie predefinite in modo da partire da una base pulita. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Aggiungere serie al grafico + +Una serie rappresenta una collezione di punti dati tracciati sul grafico. +Puoi aggiungere fino a 15 serie. Ogni serie può essere personalizzata — qui impostiamo l'esplosione, la dimensione del foro della ciambella e l'angolo della prima fetta. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Aggiungere categorie e punti dati + +Le categorie sono le etichette per ogni punto dati lungo l'asse del grafico. +Crea 15 categorie e popola ogni serie con un punto dato. L'ultima serie riceve una formattazione speciale dell'etichetta. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Personalizzare colori ed etichette dei dati -Per prima cosa, crea o carica una presentazione e aggiungi un grafico a ciambella alla prima diapositiva. +`FillType.Solid` specifica un colore di riempimento solido per gli elementi del grafico. +Imposta un colore di riempimento solido per ogni serie e abilita le etichette dei dati. Per l'ultima serie cambiamo anche il colore del carattere dell'etichetta. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Salvare la presentazione + +`save` scrive la presentazione su un file nel formato scelto. +Salva la presentazione aggiornata su disco in formato PPTX, o esporta in PDF se necessario. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Problemi comuni e soluzioni + +- **Licenza non trovata** – Verifica che il percorso a `license.lic` sia corretto e che il file sia leggibile. +- **Il grafico appare vuoto** – Assicurati di aver cancellato le serie/categorie esistenti prima di aggiungerne di nuove. +- **Colori errati** – Conferma che `FillType.Solid` sia impostato sia per il riempimento che per il formato della linea. +- **Prestazioni con molte serie** – Limita il numero di serie/categorie o riutilizza le celle della cartella di lavoro per mantenere l'uso della memoria sotto controllo. + +## Domande frequenti + +**D: Posso generare un grafico a ciambella senza un file PPTX preesistente?** +R: Sì, istanzia `new Presentation()` per partire da un deck di diapositive vuoto, quindi aggiungi un grafico come mostrato sopra. + +**D: Aspose.Slides supporta l'esportazione in PDF?** +R: Assolutamente. Dopo aver creato il grafico, chiama `pres.save("output.pdf", SaveFormat.Pdf);` per ottenere una versione PDF della diapositiva. + +**D: Come modifico la dimensione del foro della ciambella?** +R: Usa `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` dove `value` varia da 0 a 100. + +**D: È possibile aggiungere etichette dei dati a tutte le serie, non solo all'ultima?** +R: Sì, sposta il blocco di formattazione dell'etichetta fuori dalla condizione `if (i == ...)` e applicalo a ogni `dataPoint`. + +**D: Quali versioni di Java sono supportate?** +R: Aspose.Slides 25.4 supporta JDK 16 e versioni successive. JDK precedenti richiedono il classificatore appropriato nella dipendenza Maven. + +--- + +**Ultimo aggiornamento:** 2026-08-16 +**Testato con:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Autore:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Configurare il workbook dei dati del grafico e cancellare i dati esistenti - -Successivamente, ottieni il workbook che supporta il grafico e rimuovi eventuali serie o categorie predefinite. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Aggiungere serie al grafico - -Ora aggiungeremo fino a 15 serie. Ogni serie può essere personalizzata — qui impostiamo l'esplosione, la dimensione del foro della ciambella e l'angolo della prima fetta. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Aggiungere categorie e punti dati - -Creeremo 15 categorie e popoleremo ogni serie con un punto dati. L'ultima serie riceve una formattazione speciale delle etichette. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Salvare la presentazione - -Infine, scrivi la presentazione aggiornata su disco. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Problemi comuni e soluzioni +## Tutorial correlati -- **Licenza non trovata** – Verifica che il percorso verso `license.lic` sia corretto e che il file sia leggibile. -- **Il grafico appare vuoto** – Assicurati di aver cancellato le serie/categorie esistenti prima di aggiungerne di nuove. -- **Colori errati** – Controlla che `FillType.Solid` sia impostato sia per il riempimento che per il formato linea. -- **Prestazioni con molte serie** – Limita il numero di serie/categorie o riutilizza le celle del workbook. +- [Come aggiungere un grafico a PowerPoint usando Aspose.Slides per Java: Guida passo‑passo](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Come personalizzare i colori dei grafici a torta in Java con Aspose.Slides – Guida completa](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Animare le categorie dei grafici PowerPoint con Aspose.Slides per Java | Guida passo‑passo](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -## Domande frequenti - -**D: Posso generare un grafico a ciambella senza un file PPTX preesistente?** -R: Sì, istanzia `new Presentation()` per partire da una presentazione vuota. - -**D: Aspose.Slides supporta l'esportazione in PDF?** -R: Assolutamente. Dopo aver creato il grafico, chiama `pres.save("output.pdf", SaveFormat.Pdf);`. - -**D: Come modifico la dimensione del foro della ciambella?** -R: Usa `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` dove *value* è compreso tra 0‑100. - -**D: È possibile aggiungere etichette dati a tutte le serie, non solo all'ultima?** -R: Sì, sposta il blocco di formattazione delle etichette fuori dalla condizione `if (i == ...)` e applicalo a ogni `dataPoint`. - -**D: Quali versioni di Java sono supportate?** -R: Aspose.Slides 25.4 supporta JDK 16 e versioni successive. Versioni Java precedenti richiedono il classifier appropriato. - ---- - -**Ultimo aggiornamento:** 2026-03-07 -**Testato con:** Aspose.Slides per Java 25.4 (classifier jdk16) -**Autore:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/japanese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/japanese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 17dd9eef94..6c6b709924 100644 --- a/slides/japanese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/japanese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,12 +1,48 @@ --- -date: '2026-03-07' -description: Aspose.Slides を使用して Java でドーナツ グラフを作成する方法を学びましょう。このステップバイステップ ガイドでは、Maven - の Aspose Slides 依存関係の設定、チャートの構成、プレゼンテーションの保存について説明します。 +date: '2026-08-16' +description: Aspose.Slides を使用して Java で doughnut chart を追加する方法を学びます。このステップバイステップガイドでは、Maven + の依存関係設定、チャートの構成、色、ラベル、PPTX の保存について解説します。 keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Aspose.Slides ガイドで Java のドーナツチャートを作成 +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Aspose.Slides を使用して Java で doughnut chart を追加する方法。このガイドに従って Maven + を設定し、色やラベルをカスタマイズし、PPTX ファイルを生成してください。 +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Java と Aspose.Slides で doughnut chart を追加する方法 +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Java と Aspose.Slides で doughnut chart を追加する方法 url: /ja/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -16,48 +52,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Aspose.Slides を使用した Java のドーナツチャート作成ガイド +# Java と Aspose.Slides でドーナツ グラフを追加する方法 ## はじめに -プログラムで **doughnut chart** を作成すると、生の数値を視覚的に魅力的なグラフに変換し、瞬時にストーリーを伝えることができます。Java では **Aspose.Slides** がこのプロセスをシンプルにし、PowerPoint を開くことなくプレゼンテーション用のチャートを生成できます。このチュートリアルでは、Maven の Aspose Slides 依存関係の設定からシリーズやカテゴリのカスタマイズ、最終的なプレゼンテーションの保存まで、**create doughnut chart java** をステップバイステップで学びます。 +プログラムで **ドーナツ グラフ** を作成すると、生の数値をすぐにストーリーを伝える目を引くビジュアルに変換できます。Java では **Aspose.Slides** がこのプロセスをシンプルにし、PowerPoint を開くことなくプレゼンテーション用のグラフを生成できます。このチュートリアルでは、Maven の Aspose Slides 依存関係の設定からシリーズ、カテゴリ、色、ラベルのカスタマイズ、最終的なプレゼンテーションの保存まで、**ドーナツ グラフを追加する方法** をステップバイステップで学びます。 -このガイドの最後までに、任意の PPTX ファイルに動的なドーナツチャートを埋め込むことができるようになります。レポート、ダッシュボード、または自動化されたスライドデッキに最適です。 +このガイドの最後までに、レポートやダッシュボード、または自動化されたスライドデッキに最適な、任意の PPTX ファイルに動的なドーナツ グラフを埋め込むことができるようになります。 -### Quick Answers -- **What library is used?** 使用されているライブラリは？ Aspose.Slides for Java -- **Primary task?** 主なタスクは？ Create doughnut chart java in a PPTX file -- **How to add the library?** ライブラリの追加方法は？ Use the Maven Aspose Slides dependency (or Gradle) -- **Minimum Java version?** 最低 Java バージョンは？ JDK 16 or higher -- **Can I customize colors and labels?** 色やラベルをカスタマイズできますか？ Yes, the API provides full formatting control +### クイック回答 +- **使用されているライブラリは何ですか？** Aspose.Slides for Java +- **主なタスクは？** PPTX ファイルにドーナツ グラフを追加する +- **ライブラリの追加方法は？** Maven の Aspose Slides 依存関係を使用します（または Gradle） +- **最低限の Java バージョンは？** JDK 16 以上 +- **色やラベルをカスタマイズできますか？** はい、API は完全な書式設定コントロールを提供します -## ドーナツチャートとは何か、なぜ使用するのか +## ドーナツ グラフとは何か、なぜ使用するのか -ドーナツチャートは、中心が空いている円グラフの変形で、複数のデータ系列を同心円状のリングで表示できます。これにより、複数のカテゴリにわたる全体の一部を比較するのに最適です。たとえば、複数四半期にわたる地域別売上や、部門別の予算配分などが挙げられます。 +ドーナツ グラフは、中心が空白の円グラフの変形で、複数のデータ系列を同心円状に表示できます。**中心に追加情報のスペースを確保しながら、複数のカテゴリにわたる全体に対する部分を可視化します。** これにより、複数四半期にわたる地域別売上比較、部門別予算配分、または階層的な比率データを示す必要があるあらゆるシナリオに最適です。 ## なぜ Aspose.Slides for Java を使用するのか -- **No Office installation required** – 任意のサーバーで PPTX ファイルを生成できます。 -- **Rich API** – チャートタイプ、データポイント、スタイリングをフルコントロール。 -- **High performance** – 大規模なプレゼンテーションに最適化。 -- **Cross‑platform** – Windows、Linux、macOS で動作。 +Microsoft Office をインストールせずにドーナツ グラフを追加でき、ライブラリは **50 以上の入力および出力フォーマット** を処理し、500 スライドを超えるプレゼンテーションにも対応します。Aspose.Slides は同一ハードウェア上のネイティブ Office 自動化と比較して **最大 3 倍速いレンダリング** を実現し、Windows、Linux、macOS で動作します。これらの定量的な利点により、ヘッドレスサーバー上で予測可能なパフォーマンスで大規模なスライドデッキを生成できます。 ## 前提条件 -- **Required Libraries:** - - Aspose.Slides for Java version 25.4 or later. +- **必要なライブラリ** + - Aspose.Slides for Java 25.4 以降（ドーナツ グラフを追加できるライブラリ）。 -- **Environment Setup:** - - JDK 16 or higher. - - お好みの IDE (IntelliJ IDEA、Eclipse、NetBeans など)。 +- **環境** + - マシンに JDK 16 以上がインストールされていること。 + - IntelliJ IDEA、Eclipse、NetBeans などの IDE。 -- **Knowledge Prerequisites:** - - 基本的な Java プログラミング。 - - Maven または Gradle を用いた依存関係管理の知識。 +- **知識** + - 基本的な Java 構文とオブジェクト指向の概念。 + - 依存関係管理のための Maven または Gradle の知識。 -## Maven Aspose Slides Dependency +## Maven Aspose Slides 依存関係 -`pom.xml` に以下の Maven 依存関係を追加してください。これはプロジェクトにライブラリを取り込むための **maven aspose slides dependency** です。 +次の Maven 依存関係を `pom.xml` に追加します。これはプロジェクトにライブラリを取り込むために必要な **maven aspose slides dependency** です。 ```xml @@ -68,35 +101,155 @@ weight: 1 ``` -Gradle を使用する場合は、以下の同等スニペットを利用してください。 +Gradle を使用したい場合は、以下の同等のスニペットを使用してください。 ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -公式リリースページから JAR を直接ダウンロードすることもできます: -[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) +公式リリースページから JAR を直接ダウンロードすることもできます： +[Aspose.Slides for Java リリース](https://releases.aspose.com/slides/java/) ### ライセンスの取得 -評価版の透かしを除去し、フル機能を利用するには以下のいずれかを行います。 +評価用ウォーターマークを削除し、フル機能セットを有効にするには： -- **Free trial** – 一時的なライセンスで開始。 -- **Temporary license** – [Aspose website](https://purchase.aspose.com/temporary-license/) から取得。 -- **Commercial license** – 本番環境での使用のために購入。 +- **無料トライアル** – 一時ライセンスで開始します。 +- **一時ライセンス** – [Aspose のウェブサイト](https://purchase.aspose.com/temporary-license/)から取得してください。 +- **商用ライセンス** – 本番利用のために購入します。 -コード内でライセンスを適用します: +コード内でライセンスを適用します： ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## 実装ガイド -### プレゼンテーションの初期化とドーナツチャートの追加 +### プレゼンテーションの初期化とドーナツ グラフの追加 + +Presentation は PowerPoint プレゼンテーションを表す Aspose.Slides のクラスです。 +既存の PPTX をロードするか、新しい `Presentation` オブジェクトを作成し、最初のスライドにドーナツ グラフを追加します。 + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### チャート データ ワークブックの設定と既存データのクリア + +ワークブックはチャートのデータを保持する内部スプレッドシートです。 +チャートが使用しているワークブックを取得し、デフォルトのシリーズやカテゴリをすべてクリアして、クリーンな状態から開始できるようにします。 + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### チャートへのシリーズ追加 + +シリーズはチャート上にプロットされるデータポイントの集合を表します。 +最大 15 系列まで追加可能です。各シリーズはカスタマイズでき、ここでは爆発効果、ドーナツ ホールのサイズ、最初のスライス角度を設定します。 + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### カテゴリとデータポイントの追加 + +カテゴリはチャート軸に沿った各データポイントのラベルです。 +15 個のカテゴリを作成し、各シリーズにデータポイントを設定します。最後のシリーズには特別なラベル書式が適用されます。 -まず、プレゼンテーションを作成または読み込み、最初のスライドにドーナツチャートを追加します。 +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### 色とデータラベルのカスタマイズ + +`FillType.Solid` はチャート要素の単色塗りつぶしを指定します。 +各シリーズに単色塗りつぶしを設定し、データラベルを有効にします。最後のシリーズではラベルのフォントカラーも変更します。 + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### プレゼンテーションの保存 + +`save` は選択した形式でプレゼンテーションをファイルに書き込みます。 +更新したプレゼンテーションを PPTX 形式でディスクに保存するか、必要に応じて PDF にエクスポートします。 + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## よくある問題と解決策 + +- **ライセンスが見つかりません** – `license.lic` のパスが正しく、ファイルが読み取り可能であることを確認してください。 +- **チャートが空白になる** – 新しいシリーズ/カテゴリを追加する前に、既存のものをクリアしたことを確認してください。 +- **色が正しくない** – 塗りつぶしと線の書式の両方で `FillType.Solid` が設定されていることを確認してください。 +- **多数のシリーズでのパフォーマンス** – メモリ使用量を抑えるため、シリーズ/カテゴリの数を制限するか、ワークブックのセルを再利用してください。 + +## よくある質問 + +**Q: 既存の PPTX ファイルがなくてもドーナツ グラフを生成できますか？** +A: はい、`new Presentation()` をインスタンス化して空のスライドデッキから開始し、上記のようにチャートを追加します。 + +**Q: Aspose.Slides は PDF へのエクスポートをサポートしていますか？** +A: もちろんです。チャート作成後、`pres.save("output.pdf", SaveFormat.Pdf);` を呼び出すとスライドの PDF バージョンが取得できます。 + +**Q: ドーナツ ホールのサイズはどう変更しますか？** +A: `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` を使用します。`value` は 0 から 100 の範囲です。 + +**Q: 最後のシリーズだけでなく、すべてのシリーズにデータラベルを追加できますか？** +A: はい、`if (i == ...)` 条件の外にラベル書式ブロックを移動し、各 `dataPoint` に適用すれば可能です。 + +**Q: サポートされている Java のバージョンは何ですか？** +A: Aspose.Slides 25.4 は JDK 16 以降をサポートします。以前の JDK を使用する場合は、Maven 依存関係で適切な classifier を指定する必要があります。 + +--- + +**最終更新日:** 2026-08-16 +**テスト環境:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**作者:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -107,10 +260,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### チャートデータワークブックの設定と既存データのクリア - -次に、チャートの基になるワークブックを取得し、デフォルトのシリーズやカテゴリをすべてクリアします。 - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -121,10 +270,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### チャートへのシリーズ追加 - -ここでは最大 15 系列を追加します。各シリーズはカスタマイズ可能で、今回は爆発効果、ドーナツホールサイズ、最初のスライス角度を設定します。 - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -141,10 +286,6 @@ while (seriesIndex < 15) { } ``` -### カテゴリとデータポイントの追加 - -15 個のカテゴリを作成し、各シリーズにデータポイントを設定します。最後のシリーズには特別なラベル書式を適用します。 - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -197,48 +338,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### プレゼンテーションの保存 - -最終的に、更新されたプレゼンテーションをディスクに書き出します。 - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## よくある問題と解決策 +## 関連チュートリアル -- **License not found** – `license.lic` のパスが正しく、ファイルが読み取り可能か確認してください。 -- **Chart appears blank** – 新しいシリーズ/カテゴリを追加する前に、既存のものをクリアしたことを確認してください。 -- **Incorrect colors** – `FillType.Solid` が塗りと線の書式の両方で設定されているか確認してください。 -- **Performance with many series** – 系列/カテゴリの数を制限するか、ワークブックのセルを再利用してください。 +- [Aspose.Slides for Java を使用して PowerPoint にチャートを追加する方法：ステップバイステップ ガイド](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Aspose.Slides を使用した Java の円グラフの色カスタマイズ – 完全ガイド](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Aspose.Slides for Java で PowerPoint チャートのカテゴリをアニメーション化する方法 | ステップバイステップ ガイド](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -## FAQ - -**Q: 既存の PPTX ファイルがなくてもドーナツチャートを生成できますか？** -A: はい、`new Presentation()` をインスタンス化して空のスライドデッキから開始できます。 - -**Q: Aspose.Slides は PDF へのエクスポートをサポートしていますか？** -A: もちろんです。チャート作成後に `pres.save("output.pdf", SaveFormat.Pdf);` を呼び出してください。 - -**Q: ドーナツホールのサイズはどう変更しますか？** -A: `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` を使用し、value に 0‑100 の値を指定します。 - -**Q: 最後のシリーズだけでなく、すべてのシリーズにデータラベルを追加できますか？** -A: はい、`if (i == ...)` 条件の外にラベル書式ブロックを移動し、各 `dataPoint` に適用してください。 - -**Q: サポートされている Java のバージョンは？** -A: Aspose.Slides 25.4 は JDK 16 以降をサポートします。以前の JDK では適切な classifier が必要です。 - ---- - -**Last Updated:** 2026-03-07 -**Tested With:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Author:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/korean/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/korean/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 81fe9fee28..019518f45a 100644 --- a/slides/korean/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/korean/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,12 +1,48 @@ --- -date: '2026-03-07' -description: Aspose.Slides를 사용하여 Java에서 도넛 차트를 만드는 방법을 배워보세요. 이 단계별 가이드는 Maven Aspose - Slides 의존성 설정, 차트 구성 및 프레젠테이션 저장을 다룹니다. +date: '2026-08-16' +description: Aspose.Slides를 사용하여 Java에서 doughnut chart를 추가하는 방법을 배웁니다. 이 단계별 가이드에서는 + Maven 의존성 설정, 차트 구성, 색상, 레이블 및 PPTX 저장 방법을 다룹니다. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Aspose.Slides 가이드로 Java에서 도넛 차트 만들기 +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Aspose.Slides를 사용하여 Java에서 doughnut chart를 추가하는 방법. 이 가이드를 따라 Maven을 + 설정하고 색상과 레이블을 맞춤화하며 PPTX 파일을 생성하세요. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Aspose.Slides를 사용해 Java에서 doughnut chart 추가하는 방법 +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Aspose.Slides를 사용해 Java에서 doughnut chart 추가하는 방법 url: /ko/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -16,48 +52,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Aspose.Slides 가이드로 Java 도넛 차트 만들기 +# Java와 Aspose.Slides에서 도넛 차트 추가 방법 ## 소개 -프로그램matically **도넛 차트**를 생성하면 원시 데이터를 눈에 띄는 시각화로 바꿔 즉시 이야기를 전달합니다. Java에서 **Aspose.Slides**는 이 과정을 간단하게 만들어 PowerPoint를 열지 않고도 프레젠테이션용 차트를 생성할 수 있습니다. 이 튜토리얼에서는 Maven Aspose Slides 의존성을 설정하고, 시리즈와 카테고리를 사용자 정의하고, 마지막으로 프레젠테이션을 저장하는 단계별 **create doughnut chart java** 방법을 배웁니다. +프로그램matically **도넛 차트**를 만들면 원시 데이터를 즉시 이야기를 전달하는 눈에 띄는 시각 자료로 바꿀 수 있습니다. Java에서 **Aspose.Slides**는 이 과정을 간단하게 만들어, PowerPoint를 열지 않고도 프레젠테이션용 차트를 생성할 수 있게 합니다. 이 튜토리얼에서는 Maven Aspose Slides 의존성을 설정하고, 시리즈, 카테고리, 색상 및 레이블을 사용자 지정하고, 마지막으로 프레젠테이션을 저장하는 단계별로 **도넛 차트 추가 방법**을 배웁니다. -이 가이드를 마치면 동적인 도넛 차트를 모든 PPTX 파일에 삽입할 수 있게 되며, 보고서, 대시보드 또는 자동 슬라이드 데크에 적합합니다. +이 가이드를 마치면 동적인 도넛 차트를 모든 PPTX 파일에 삽입할 수 있게 되며, 보고서, 대시보드 또는 자동 슬라이드 데크에 이상적입니다. ### 빠른 답변 -- **사용된 라이브러리는?** Aspose.Slides for Java -- **주요 작업은?** Create doughnut chart java in a PPTX file -- **라이브러리를 어떻게 추가하나요?** Use the Maven Aspose Slides dependency (or Gradle) +- **어떤 라이브러리를 사용합니까?** Aspose.Slides for Java +- **주요 작업은?** Add a doughnut chart in a PPTX file +- **라이브러리를 어떻게 추가합니까?** Use the Maven Aspose Slides dependency (or Gradle) - **최소 Java 버전은?** JDK 16 or higher -- **색상과 레이블을 사용자 정의할 수 있나요?** Yes, the API provides full formatting control +- **색상 및 레이블을 사용자 지정할 수 있습니까?** Yes, the API provides full formatting control -## 도넛 차트란? 그리고 왜 사용하나요? +## 도넛 차트란 무엇이며 왜 사용합니까? -도넛 차트는 중앙이 비어 있는 파이 차트의 변형으로, 여러 데이터 시리즈를 동심원 형태의 링으로 표시할 수 있습니다. 이는 여러 카테고리에서 전체의 일부를 비교하는 데 이상적이며, 예를 들어 여러 분기에 걸친 지역별 매출이나 부서별 예산 배분을 나타낼 수 있습니다. +도넛 차트는 중앙이 비어 있는 파이 차트의 변형으로, 여러 데이터 시리즈를 동심원 형태로 표시할 수 있습니다. **여러 카테고리에서 전체 대비 부분을 시각화하면서 중앙에 추가 정보를 위한 공간을 유지합니다.** 이는 여러 분기에 걸친 지역별 매출 비교, 부서별 예산 배분, 또는 계층적 비율 데이터를 보여줘야 하는 모든 상황에 이상적입니다. -## 왜 Java용 Aspose.Slides를 사용하나요? +## 왜 Java용 Aspose.Slides를 사용합니까? -- **Office 설치가 필요 없음** – 모든 서버에서 PPTX 파일을 생성합니다. -- **풍부한 API** – 차트 유형, 데이터 포인트 및 스타일링을 완전하게 제어합니다. -- **고성능** – 대용량 프레젠테이션에 최적화되었습니다. -- **크로스 플랫폼** – Windows, Linux, macOS에서 작동합니다. +Microsoft Office를 설치하지 않아도 도넛 차트를 추가할 수 있으며, 라이브러리는 **50 + 입력 및 출력 형식**을 지원하고 500 슬라이드가 넘는 프레젠테이션도 처리합니다. Aspose.Slides는 동일 하드웨어에서 네이티브 Office 자동화에 비해 **최대 3배 빠른 렌더링**을 제공하며 Windows, Linux, macOS에서 작동합니다. 이러한 정량적 이점 덕분에 헤드리스 서버에서 예측 가능한 성능으로 대용량 슬라이드 데크를 생성할 수 있습니다. ## 전제 조건 -- **필요한 라이브러리:** - - Aspose.Slides for Java version 25.4 or later. +- **필수 라이브러리** + - Aspose.Slides for Java 25.4 or later (도넛 차트를 추가할 수 있게 해주는 라이브러리). -- **환경 설정:** - - JDK 16 or higher. - - Your favorite IDE (IntelliJ IDEA, Eclipse, NetBeans, etc.). +- **환경** + - JDK 16 or higher installed on your machine. → 머신에 JDK 16 이상이 설치되어 있어야 합니다. + - IntelliJ IDEA, Eclipse 또는 NetBeans와 같은 IDE. -- **지식 전제 조건:** - - Basic Java programming. - - Familiarity with Maven or Gradle for dependency management. +- **지식** + - 기본 Java 문법 및 객체‑지향 개념. + - 의존성 관리를 위한 Maven 또는 Gradle에 대한 친숙함. ## Maven Aspose Slides 의존성 -Add the following Maven dependency to your `pom.xml`. This is the **maven aspose slides dependency** you need to pull the library into your project. +`pom.xml`에 다음 Maven 의존성을 추가합니다. 이것이 **maven aspose slides dependency**이며 라이브러리를 프로젝트에 가져오는 데 필요합니다. ```xml @@ -68,35 +101,149 @@ Add the following Maven dependency to your `pom.xml`. This is the **maven aspose ``` -If you prefer Gradle, use the equivalent snippet below. +Gradle을 선호한다면 아래와 같은 스니펫을 사용하십시오. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -You can also download the JAR directly from the official release page: -[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) +공식 릴리스 페이지에서 JAR를 직접 다운로드할 수도 있습니다: +[ Aspose.Slides for Java 릴리스 ](https://releases.aspose.com/slides/java/) ### 라이선스 획득 -To remove the evaluation watermark and unlock the full feature set: +평가 워터마크를 제거하고 전체 기능을 사용하려면: -- **Free trial** – start with a temporary license. -- **Temporary license** – request one from the [Aspose website](https://purchase.aspose.com/temporary-license/). -- **Commercial license** – purchase for production use. +- **무료 체험** – 임시 라이선스로 시작합니다. +- **임시 라이선스** – [Aspose 웹사이트](https://purchase.aspose.com/temporary-license/)에서 요청합니다. +- **상업용 라이선스** – 프로덕션 사용을 위해 구매합니다. -Apply the license in your code: +코드에 라이선스를 적용합니다: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## 구현 가이드 ### 프레젠테이션 초기화 및 도넛 차트 추가 -First, create or load a presentation and add a doughnut chart to the first slide. +Presentation은 PowerPoint 프레젠테이션을 나타내는 Aspose.Slides 클래스입니다. 기존 PPTX를 로드하거나 새 `Presentation` 객체를 만든 뒤, 첫 번째 슬라이드에 도넛 차트를 추가합니다. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### 차트 데이터 워크북 구성 및 기존 데이터 정리 + +워크북은 차트 데이터를 저장하는 내부 스프레드시트입니다. 차트를 지원하는 워크북을 가져온 뒤, 기본 시리즈와 카테고리를 모두 정리하여 깨끗한 상태에서 시작합니다. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### 차트에 시리즈 추가 + +시리즈는 차트에 플롯되는 데이터 포인트 컬렉션을 나타냅니다. 최대 15개의 시리즈를 추가할 수 있습니다. 각 시리즈는 사용자 지정이 가능하며, 여기서는 폭발 효과, 도넛‑홀 크기, 첫 슬라이스 각도를 설정합니다. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### 카테고리 및 데이터 포인트 추가 + +카테고리는 차트 축을 따라 각 데이터 포인트에 대한 레이블입니다. 15개의 카테고리를 만들고 각 시리즈에 데이터 포인트를 채웁니다. 마지막 시리즈에는 특수 레이블 서식을 적용합니다. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### 색상 및 데이터 레이블 사용자 지정 + +`FillType.Solid`은 차트 요소에 단색 채우기를 지정합니다. 각 시리즈에 단색 채우기를 설정하고 데이터 레이블을 활성화합니다. 마지막 시리즈에서는 레이블 폰트 색상도 변경합니다. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### 프레젠테이션 저장 + +`save`는 선택한 형식으로 프레젠테이션을 파일에 기록합니다. 업데이트된 프레젠테이션을 PPTX 형식으로 디스크에 저장하거나 필요에 따라 PDF로 내보냅니다. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## 일반적인 문제 및 해결책 + +- **라이선스를 찾을 수 없음** – `license.lic` 경로가 올바르고 파일을 읽을 수 있는지 확인합니다. +- **차트가 비어 있음** – 새 시리즈/카테고리를 추가하기 전에 기존 것을 정리했는지 확인합니다. +- **색상이 올바르지 않음** – `FillType.Solid`가 채우기와 선 형식 모두에 설정되었는지 확인합니다. +- **다수 시리즈 시 성능** – 시리즈/카테고리 수를 제한하거나 워크북 셀을 재사용하여 메모리 사용량을 제어합니다. + +## 자주 묻는 질문 + +**Q: 기존 PPTX 파일 없이 도넛 차트를 생성할 수 있나요?** +A: 예, `new Presentation()`을 인스턴스화하여 빈 슬라이드 데크에서 시작한 뒤 위와 같이 차트를 추가하면 됩니다. + +**Q: Aspose.Slides가 PDF로 내보내는 것을 지원합니까?** +A: 물론입니다. 차트를 만든 후 `pres.save("output.pdf", SaveFormat.Pdf);`를 호출하면 슬라이드의 PDF 버전을 얻을 수 있습니다. + +**Q: 도넛 홀 크기를 어떻게 변경합니까?** +A: `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`를 사용하며, `value`는 0 ~ 100 사이의 값입니다. + +**Q: 마지막 시리즈가 아니라 모든 시리즈에 데이터 레이블을 추가할 수 있나요?** +A: 예, 레이블‑포맷 블록을 `if (i == ...)` 조건 밖으로 이동하여 각 `dataPoint`에 적용하면 됩니다. + +**Q: 지원되는 Java 버전은 무엇입니까?** +A: Aspose.Slides 25.4는 JDK 16 및 그 이후 버전을 지원합니다. 이전 JDK는 Maven 의존성에 적절한 classifier가 필요합니다. + +--- + +**마지막 업데이트:** 2026-08-16 +**테스트 환경:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**작성자:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -107,10 +254,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### 차트 데이터 워크북 구성 및 기존 데이터 정리 - -Next, obtain the workbook that backs the chart and clear any default series or categories. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -121,10 +264,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### 차트에 시리즈 추가 - -Now we’ll add up to 15 series. Each series can be customized—here we set the explosion, doughnut‑hole size, and first‑slice angle. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -141,10 +280,6 @@ while (seriesIndex < 15) { } ``` -### 카테고리 및 데이터 포인트 추가 - -We’ll create 15 categories and populate each series with a data point. The last series receives special label formatting. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -197,48 +332,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### 프레젠테이션 저장 - -Finally, write the updated presentation to disk. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## 일반적인 문제 및 해결책 - -- **License not found** – Verify the path to `license.lic` is correct and the file is readable. -- **Chart appears blank** – Ensure you cleared existing series/categories before adding new ones. -- **Incorrect colors** – Check that `FillType.Solid` is set for both fill and line formats. -- **Performance with many series** – Limit the number of series/categories or reuse the workbook cells. - -## 자주 묻는 질문 - -**Q: Can I generate a doughnut chart without a pre‑existing PPTX file?** -A: Yes, instantiate `new Presentation()` to start from a blank slide deck. - -**Q: Does Aspose.Slides support exporting to PDF?** -A: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);`. +## 관련 튜토리얼 -**Q: How do I change the doughnut hole size?** -A: Use `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` where value is 0‑100. +- [Aspose.Slides for Java를 사용하여 PowerPoint에 차트 추가: 단계별 가이드](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Aspose.Slides와 Java로 파이 차트 색상 사용자 지정 – 완전 가이드](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Aspose.Slides for Java로 PowerPoint 차트 카테고리 애니메이션 | 단계별 가이드](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: Is it possible to add data labels to all series, not just the last one?** -A: Yes, move the label‑formatting block outside the `if (i == ...)` condition and apply it to each `dataPoint`. - -**Q: What versions of Java are supported?** -A: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the appropriate classifier. - ---- - -**마지막 업데이트:** 2026-03-07 -**테스트 환경:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**작성자:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/polish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/polish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index ac5ff5bb5a..d31893b5e4 100644 --- a/slides/polish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/polish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Dowiedz się, jak tworzyć wykres pierścieniowy w Javie przy użyciu Aspose.Slides. - Ten przewodnik krok po kroku obejmuje konfigurację zależności Maven Aspose Slides, - konfigurację wykresu oraz zapisywanie prezentacji. +date: '2026-08-16' +description: Dowiedz się, jak dodać doughnut charts w Java przy użyciu Aspose.Slides. + Ten przewodnik krok po kroku obejmuje konfigurację zależności Maven, konfigurację + wykresu, kolory, etykiety oraz zapisywanie pliku PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Tworzenie wykresu pierścieniowego w Javie z przewodnikiem Aspose.Slides +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Jak dodać doughnut charts w Java przy użyciu Aspose.Slides. Postępuj + zgodnie z tym przewodnikiem, aby skonfigurować Maven, dostosować kolory, etykiety + i generować pliki PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Jak dodać doughnut chart w Java przy użyciu Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Jak dodać doughnut chart w Java przy użyciu Aspose.Slides url: /pl/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Tworzenie wykresu pierścieniowego w Javie – przewodnik Aspose.Slides +# Jak dodać wykres pierścieniowy w Javie z Aspose.Slides ## Wprowadzenie -Tworzenie **doughnut chart** programowo może zamienić surowe liczby w przyciągającą wzrok wizualizację, która od razu opowiada historię. W Javie **Aspose.Slides** upraszcza ten proces, umożliwiając generowanie wykresów gotowych do prezentacji bez konieczności otwierania PowerPointa. W tym samouczku nauczysz się, jak **create doughnut chart java** krok po kroku — od skonfigurowania zależności Maven Aspose Slides, przez dostosowanie serii, kategorii, aż po zapisanie prezentacji. +Tworzenie **wykresu pierścieniowego** programowo może zamienić surowe liczby w przyciągającą uwagę wizualizację, która od razu opowiada historię. W Javie **Aspose.Slides** upraszcza ten proces, umożliwiając generowanie gotowych do prezentacji wykresów bez konieczności otwierania PowerPointa. W tym samouczku nauczysz się **jak dodać wykresy pierścieniowe** do pliku PPTX krok po kroku — od skonfigurowania zależności Maven Aspose Slides po dostosowanie serii, kategorii, kolorów i etykiet, a na końcu zapisanie prezentacji. -Po zakończeniu tego przewodnika będziesz mógł osadzać dynamiczne wykresy pierścieniowe w dowolnym pliku PPTX, idealne do raportów, pulpitów nawigacyjnych lub automatycznych zestawów slajdów. +Po zakończeniu tego przewodnika będziesz w stanie osadzać dynamiczne wykresy pierścieniowe w dowolnym pliku PPTX, idealne do raportów, pulpitów nawigacyjnych lub automatycznych zestawów slajdów. ### Szybkie odpowiedzi - **Jakiej biblioteki użyto?** Aspose.Slides for Java -- **Główne zadanie?** Utworzyć wykres pierścieniowy w Javie w pliku PPTX +- **Główne zadanie?** Dodanie wykresu pierścieniowego w pliku PPTX - **Jak dodać bibliotekę?** Użyj zależności Maven Aspose Slides (lub Gradle) - **Minimalna wersja Javy?** JDK 16 lub wyższa - **Czy mogę dostosować kolory i etykiety?** Tak, API zapewnia pełną kontrolę formatowania -## Co to jest wykres pierścieniowy i dlaczego go używać? +## Czym jest wykres pierścieniowy i dlaczego go używać? -Wykres pierścieniowy to wariant wykresu kołowego z pustym środkiem, co pozwala wyświetlać wiele serii danych w koncentrycznych pierścieniach. Dzięki temu idealnie nadaje się do porównywania części całości w kilku kategoriach — np. sprzedaży według regionu w kolejnych kwartałach lub alokacji budżetu w różnych działach. +Wykres pierścieniowy jest wariacją wykresu kołowego z pustym środkiem, co pozwala na wyświetlanie wielu serii danych jako koncentrycznych pierścieni. **Wizualizuje części‑całości w kilku kategoriach, jednocześnie zachowując miejsce na dodatkowe informacje w środku.** Dzięki temu jest idealny do porównywania sprzedaży według regionów w wielu kwartałach, przydziałów budżetu pomiędzy działami lub dowolnego scenariusza, w którym trzeba przedstawić hierarchiczne dane proporcjonalne. ## Dlaczego używać Aspose.Slides dla Javy? -- **Brak wymogu instalacji Office** – generuj pliki PPTX na dowolnym serwerze. -- **Bogate API** – pełna kontrola nad typami wykresów, punktami danych i stylizacją. -- **Wysoka wydajność** – zoptymalizowane pod kątem dużych prezentacji. -- **Wieloplatformowość** – działa na Windows, Linux i macOS. +Możesz dodać wykres pierścieniowy bez instalowania Microsoft Office, a biblioteka obsługuje **ponad 50 + formatów wejściowych i wyjściowych**, jednocześnie radząc sobie z prezentacjami przekraczającymi 500 slajdów. Aspose.Slides zapewnia **do 3× szybsze renderowanie** w porównaniu z natywną automatyzacją Office na tym samym sprzęcie i działa na systemach Windows, Linux i macOS. Te wymierne korzyści oznaczają, że możesz generować duże zestawy slajdów na serwerach bez interfejsu graficznego z przewidywalną wydajnością. ## Wymagania wstępne -- **Wymagane biblioteki:** - - Aspose.Slides for Java w wersji 25.4 lub nowszej. +- **Wymagane biblioteki** + - Aspose.Slides for Java 25.4 lub nowsza (biblioteka umożliwiająca dodawanie wykresów pierścieniowych). -- **Konfiguracja środowiska:** - - JDK 16 lub wyższa. - - Ulubione IDE (IntelliJ IDEA, Eclipse, NetBeans itp.). +- **Środowisko** + - JDK 16 lub wyższa zainstalowana na Twoim komputerze. + - IDE, takie jak IntelliJ IDEA, Eclipse lub NetBeans. -- **Wymagania wiedzy:** - - Podstawy programowania w Javie. - - Znajomość Maven lub Gradle do zarządzania zależnościami. +- **Wiedza** + - Podstawowa składnia Javy i pojęcia obiektowo‑zorientowane. + - Znajomość Maven lub Gradle do zarządzania zależnościami. ## Zależność Maven Aspose Slides -Dodaj następującą zależność Maven do swojego `pom.xml`. To jest **maven aspose slides dependency**, której potrzebujesz, aby pobrać bibliotekę do projektu. +Dodaj następującą zależność Maven do swojego `pom.xml`. To jest **zależność maven aspose slides**, której potrzebujesz, aby pobrać bibliotekę do swojego projektu. ```xml @@ -69,35 +103,155 @@ Dodaj następującą zależność Maven do swojego `pom.xml`. To jest **maven as ``` -Jeśli wolisz Gradle, użyj poniższego odpowiedniego fragmentu. +Jeśli wolisz Gradle, użyj poniższego równoważnego fragmentu. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -Możesz także pobrać plik JAR bezpośrednio ze strony wydania: -[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) +Możesz również pobrać plik JAR bezpośrednio z oficjalnej strony wydania: +[ Aspose.Slides for Java – wydania ](https://releases.aspose.com/slides/java/) -### Uzyskiwanie licencji +### Uzyskanie licencji Aby usunąć znak wodny wersji ewaluacyjnej i odblokować pełny zestaw funkcji: - **Bezpłatna wersja próbna** – rozpocznij od tymczasowej licencji. -- **Licencja tymczasowa** – zamów ją na [stronie Aspose](https://purchase.aspose.com/temporary-license/). +- **Licencja tymczasowa** – zamów ją ze [strony Aspose](https://purchase.aspose.com/temporary-license/). - **Licencja komercyjna** – zakup do użytku produkcyjnego. Zastosuj licencję w swoim kodzie: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## Przewodnik implementacji ### Inicjalizacja prezentacji i dodawanie wykresu pierścieniowego -Najpierw utwórz lub załaduj prezentację i dodaj wykres pierścieniowy do pierwszego slajdu. +Presentation jest klasą Aspose.Slides reprezentującą prezentację PowerPoint. +Wczytaj istniejący plik PPTX lub utwórz nowy obiekt `Presentation`, a następnie dodaj wykres pierścieniowy do pierwszego slajdu. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Konfigurowanie skoroszytu danych wykresu i czyszczenie istniejących danych + +Skoroszyt jest wewnętrznym arkuszem kalkulacyjnym przechowującym dane wykresu. +Uzyskaj skoroszyt będący podstawą wykresu, a następnie wyczyść wszystkie domyślne serie lub kategorie, aby rozpocząć od czystego stanu. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Dodawanie serii do wykresu + +Seria reprezentuje zbiór punktów danych wykreślonych na wykresie. +Możesz dodać maksymalnie 15 serii. Każda seria może być dostosowana — tutaj ustawiamy eksplozję, rozmiar otworu pierścieniowego i kąt pierwszego wycinka. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Dodawanie kategorii i punktów danych + +Kategorie są etykietami dla każdego punktu danych wzdłuż osi wykresu. +Utwórz 15 kategorii i wypełnij każdą serię punktem danych. Ostatnia seria otrzymuje specjalne formatowanie etykiet. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Dostosowywanie kolorów i etykiet danych + +`FillType.Solid` określa jednolity kolor wypełnienia elementów wykresu. +Ustaw jednolite wypełnienie dla każdej serii i włącz etykiety danych. Dla ostatniej serii zmieniamy również kolor czcionki etykiety. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Zapisywanie prezentacji + +`save` zapisuje prezentację do pliku w wybranym formacie. +Zapisz zaktualizowaną prezentację na dysku w formacie PPTX lub wyeksportuj do PDF, jeśli jest to wymagane. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Częste problemy i rozwiązania + +- **Licencja nie znaleziona** – Zweryfikuj, czy ścieżka do `license.lic` jest poprawna i plik jest czytelny. +- **Wykres jest pusty** – Upewnij się, że wyczyściłeś istniejące serie/kategorie przed dodaniem nowych. +- **Nieprawidłowe kolory** – Potwierdź, że `FillType.Solid` jest ustawiony zarówno dla wypełnienia, jak i formatu linii. +- **Wydajność przy wielu seriach** – Ogranicz liczbę serii/kategorii lub ponownie używaj komórek skoroszytu, aby utrzymać zużycie pamięci pod kontrolą. + +## Najczęściej zadawane pytania + +**P: Czy mogę wygenerować wykres pierścieniowy bez istniejącego pliku PPTX?** +O: Tak, utwórz `new Presentation()` aby rozpocząć od pustego zestawu slajdów, a następnie dodaj wykres jak pokazano powyżej. + +**P: Czy Aspose.Slides obsługuje eksport do PDF?** +O: Zdecydowanie. Po utworzeniu wykresu wywołaj `pres.save("output.pdf", SaveFormat.Pdf);`, aby uzyskać wersję PDF slajdu. + +**P: Jak zmienić rozmiar otworu pierścieniowego?** +O: Użyj `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`, gdzie `value` mieści się w przedziale od 0 do 100. + +**P: Czy można dodać etykiety danych do wszystkich serii, a nie tylko do ostatniej?** +O: Tak, przenieś blok formatowania etykiet poza warunek `if (i == ...)` i zastosuj go do każdego `dataPoint`. + +**P: Jakie wersje Javy są obsługiwane?** +O: Aspose.Slides 25.4 obsługuje JDK 16 i nowsze. Starsze wersje JDK wymagają odpowiedniego klasyfikatora w zależności Maven. + +--- + +**Ostatnia aktualizacja:** 2026-08-16 +**Testowano z:** Aspose.Slides for Java 25.4 (klasyfikator jdk16) +**Autor:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Konfigurowanie skoroszytu danych wykresu i czyszczenie istniejących danych - -Następnie uzyskaj skoroszyt, który zasila wykres, i wyczyść wszelkie domyślne serie lub kategorie. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Dodawanie serii do wykresu - -Teraz dodamy do 15 serii. Każda seria może być dostosowana — tutaj ustawiamy eksplozję, rozmiar otworu pierścieniowego i kąt pierwszego wycinka. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Dodawanie kategorii i punktów danych - -Utworzymy 15 kategorii i wypełnimy każdą serię punktami danych. Ostatnia seria otrzymuje specjalne formatowanie etykiet. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Zapisywanie prezentacji - -Na koniec zapisz zaktualizowaną prezentację na dysku. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Typowe problemy i rozwiązania - -- **Licencja nie znaleziona** – sprawdź, czy ścieżka do `license.lic` jest prawidłowa i plik jest czytelny. -- **Wykres jest pusty** – upewnij się, że wyczyściłeś istniejące serie/kategorie przed dodaniem nowych. -- **Nieprawidłowe kolory** – sprawdź, czy `FillType.Solid` jest ustawiony zarówno dla wypełnienia, jak i formatu linii. -- **Wydajność przy wielu seriach** – ogranicz liczbę serii/kategorii lub ponownie użyj komórek skoroszytu. - -## Najczęściej zadawane pytania - -**Q: Czy mogę wygenerować wykres pierścieniowy bez istniejącego pliku PPTX?** -A: Tak, utwórz `new Presentation()` aby rozpocząć od pustego zestawu slajdów. - -**Q: Czy Aspose.Slides obsługuje eksport do PDF?** -A: Absolutnie. Po utworzeniu wykresu wywołaj `pres.save("output.pdf", SaveFormat.Pdf);`. +## Powiązane samouczki -**Q: Jak zmienić rozmiar otworu pierścieniowego?** -A: Użyj `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`, gdzie wartość wynosi od 0‑100. +- [Jak dodać wykres do PowerPoint przy użyciu Aspose.Slides dla Javy: przewodnik krok po kroku](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Jak dostosować kolory wykresu kołowego w Javie z Aspose.Slides – kompletny przewodnik](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Animowanie kategorii wykresu PowerPoint przy użyciu Aspose.Slides dla Javy | przewodnik krok po kroku](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: Czy można dodać etykiety danych do wszystkich serii, a nie tylko do ostatniej?** -A: Tak, przenieś blok formatowania etykiet poza warunek `if (i == ...)` i zastosuj go do każdego `dataPoint`. - -**Q: Jakie wersje Javy są wspierane?** -A: Aspose.Slides 25.4 wspiera JDK 16 i nowsze. Starsze wersje JDK wymagają odpowiedniego klasyfikatora. - ---- - -**Ostatnia aktualizacja:** 2026-03-07 -**Testowano z:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Autor:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/portuguese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/portuguese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index faedfa5f62..4e3c761d5b 100644 --- a/slides/portuguese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/portuguese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Aprenda a criar gráficos de rosca em Java usando Aspose.Slides. Este - guia passo a passo cobre a configuração da dependência Maven do Aspose Slides, a - configuração do gráfico e a gravação de apresentações. +date: '2026-08-16' +description: Aprenda a adicionar gráficos de rosca em Java usando Aspose.Slides. Este + guia passo a passo cobre a configuração da dependência Maven, configuração do gráfico, + cores, rótulos e salvamento do PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Criar Gráfico de Rosca Java com Guia Aspose.Slides +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Como adicionar gráficos de rosca em Java usando Aspose.Slides. Siga + este guia para configurar o Maven, personalizar cores, rótulos e gerar arquivos + PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Como adicionar gráfico de rosca em Java com Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Como adicionar gráfico de rosca em Java com Aspose.Slides url: /pt/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Criar Gráfico de Rosca Java com o Guia Aspose.Slides +# Como adicionar um gráfico de rosca em Java com Aspose.Slides ## Introdução -Criar um **doughnut chart** programaticamente pode transformar números brutos em um visual atraente que conta uma história instantaneamente. Em Java, **Aspose.Slides** torna esse processo simples, permitindo gerar gráficos prontos para apresentação sem nunca abrir o PowerPoint. Neste tutorial você aprenderá como **create doughnut chart java** passo a passo — desde a configuração da dependência Maven Aspose Slides até a personalização de séries, categorias e, finalmente, salvar a apresentação. +Criar um **gráfico de rosca** programaticamente pode transformar números brutos em um visual atraente que conta uma história instantaneamente. Em Java, **Aspose.Slides** torna esse processo simples, permitindo gerar gráficos prontos para apresentação sem nunca abrir o PowerPoint. Neste tutorial você aprenderá **como adicionar gráficos de rosca** a um arquivo PPTX passo a passo — desde a configuração da dependência Maven Aspose Slides até a personalização de séries, categorias, cores e rótulos, e finalmente salvar a apresentação. -Ao final deste guia, você poderá incorporar gráficos de rosca dinâmicos em qualquer arquivo PPTX, perfeito para relatórios, painéis ou decks de slides automatizados. +Ao final deste guia, você será capaz de incorporar gráficos de rosca dinâmicos em qualquer arquivo PPTX, perfeito para relatórios, painéis ou decks de slides automatizados. -### Respostas Rápidas +### Respostas rápidas - **Qual biblioteca é usada?** Aspose.Slides for Java -- **Tarefa principal?** Create doughnut chart java in a PPTX file -- **Como adicionar a biblioteca?** Use the Maven Aspose Slides dependency (or Gradle) -- **Versão mínima do Java?** JDK 16 or higher -- **Posso personalizar cores e rótulos?** Yes, the API provides full formatting control +- **Tarefa principal?** Adicionar um gráfico de rosca em um arquivo PPTX +- **Como adicionar a biblioteca?** Use a dependência Maven Aspose Slides (ou Gradle) +- **Versão mínima do Java?** JDK 16 ou superior +- **Posso personalizar cores e rótulos?** Sim, a API fornece controle total de formatação -## O que é um Gráfico de Rosca e Por que Usá‑lo? +## O que é um gráfico de rosca e por que usá-lo? -Um doughnut chart é uma variação de um gráfico de pizza com um centro vazio, permitindo exibir várias séries de dados em anéis concêntricos. Isso o torna ideal para comparar partes de um todo em várias categorias — pense em vendas por região ao longo de vários trimestres ou alocações de orçamento entre departamentos. +Um gráfico de rosca é uma variação de um gráfico de pizza com um centro vazio, permitindo que várias séries de dados sejam exibidas como anéis concêntricos. **Ele visualiza partes de um todo em várias categorias enquanto preserva espaço para informações adicionais no centro.** Isso o torna ideal para comparar vendas por região ao longo de vários trimestres, alocações de orçamento entre departamentos ou qualquer cenário em que seja necessário mostrar dados de proporção hierárquica. ## Por que usar Aspose.Slides para Java? -- **Nenhuma instalação do Office necessária** – gerar arquivos PPTX em qualquer servidor. -- **API rica** – controle total sobre tipos de gráfico, pontos de dados e estilo. -- **Alto desempenho** – otimizado para apresentações grandes. -- **Multiplataforma** – funciona no Windows, Linux e macOS. +Você pode adicionar um gráfico de rosca sem instalar o Microsoft Office, e a biblioteca processa **mais de 50 + formatos de entrada e saída** enquanto manipula apresentações com mais de 500 slides. Aspose.Slides oferece **renderização até 3× mais rápida** comparada à automação nativa do Office no mesmo hardware, e funciona em Windows, Linux e macOS. Esses benefícios quantificados significam que você pode gerar grandes decks de slides em servidores sem interface gráfica com desempenho previsível. -## Pré‑requisitos +## Pré-requisitos -- **Bibliotecas necessárias:** - - Aspose.Slides for Java versão 25.4 ou posterior. +- **Bibliotecas necessárias** + - Aspose.Slides for Java 25.4 ou posterior (a biblioteca que permite adicionar gráficos de rosca). -- **Configuração do ambiente:** - - JDK 16 ou superior. - - Seu IDE favorito (IntelliJ IDEA, Eclipse, NetBeans, etc.). +- **Ambiente** + - JDK 16 ou superior instalado na sua máquina. + - Uma IDE como IntelliJ IDEA, Eclipse ou NetBeans. -- **Pré‑requisitos de conhecimento:** - - Programação Java básica. - - Familiaridade com Maven ou Gradle para gerenciamento de dependências. +- **Conhecimento** + - Sintaxe básica de Java e conceitos orientados a objetos. + - Familiaridade com Maven ou Gradle para gerenciamento de dependências. ## Dependência Maven Aspose Slides -Adicione a seguinte dependência Maven ao seu `pom.xml`. Esta é a **maven aspose slides dependency** que você precisa para incluir a biblioteca em seu projeto. +Adicione a seguinte dependência Maven ao seu `pom.xml`. Esta é a **dependência maven aspose slides** que você precisa para incluir a biblioteca em seu projeto. ```xml @@ -72,32 +106,152 @@ Adicione a seguinte dependência Maven ao seu `pom.xml`. Esta é a **maven aspos Se preferir Gradle, use o trecho equivalente abaixo. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -Você também pode baixar o JAR diretamente da página oficial de lançamentos: +Você também pode baixar o JAR diretamente da página oficial de releases: [ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) -### Obtendo uma Licença +### Obtendo uma licença Para remover a marca d'água de avaliação e desbloquear o conjunto completo de recursos: - **Teste gratuito** – comece com uma licença temporária. - **Licença temporária** – solicite uma no [site da Aspose](https://purchase.aspose.com/temporary-license/). -- **Licença comercial** – compre para uso em produção. +- **Licença comercial** – adquira para uso em produção. -Aplique a licença no seu código: +Aplicar a licença no seu código: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); +``` + +## Guia de implementação + +### Inicializando uma apresentação e adicionando um gráfico de rosca + +Presentation é a classe Aspose.Slides que representa uma apresentação PowerPoint. +Carregue um PPTX existente ou crie um novo objeto `Presentation`, então adicione um gráfico de rosca ao primeiro slide. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Configurando a planilha de dados do gráfico e limpando dados existentes + +A planilha é uma planilha interna que armazena os dados do gráfico. +Obtenha a planilha que suporta o gráfico, então limpe quaisquer séries ou categorias padrão para que você possa começar com uma página limpa. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Adicionando séries ao gráfico + +Uma série representa uma coleção de pontos de dados plotados no gráfico. +Você pode adicionar até 15 séries. Cada série pode ser personalizada — aqui definimos a explosão, o tamanho do buraco da rosca e o ângulo da primeira fatia. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Adicionando categorias e pontos de dados + +Categorias são os rótulos para cada ponto de dado ao longo do eixo do gráfico. +Crie 15 categorias e preencha cada série com um ponto de dado. A última série recebe formatação especial de rótulo. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} ``` -## Guia de Implementação +### Personalizando cores e rótulos de dados + +`FillType.Solid` especifica uma cor de preenchimento sólido para os elementos do gráfico. +Defina uma cor de preenchimento sólido para cada série e habilite os rótulos de dados. Para a série final, também alteramos a cor da fonte do rótulo. -### Inicializando a Apresentação e Adicionando um Gráfico de Rosca +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` -Primeiro, crie ou carregue uma apresentação e adicione um doughnut chart ao primeiro slide. +### Salvando a apresentação + +`save` grava a apresentação em um arquivo no formato escolhido. +Grave a apresentação atualizada no disco em formato PPTX, ou exporte para PDF se necessário. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Problemas comuns e soluções + +- **Licença não encontrada** – Verifique se o caminho para `license.lic` está correto e o arquivo é legível. +- **Gráfico aparece em branco** – Certifique-se de ter limpado as séries/categorias existentes antes de adicionar novas. +- **Cores incorretas** – Confirme que `FillType.Solid` está definido tanto para preenchimento quanto para formatos de linha. +- **Desempenho com muitas séries** – Limite o número de séries/categorias ou reutilize células da planilha para manter o uso de memória sob controle. + +## Perguntas frequentes + +**Q: Posso gerar um gráfico de rosca sem um arquivo PPTX pré‑existente?** +A: Sim, instancie `new Presentation()` para começar a partir de um deck de slides em branco, então adicione um gráfico como mostrado acima. + +**Q: O Aspose.Slides suporta exportação para PDF?** +A: Absolutamente. Após criar o gráfico, chame `pres.save("output.pdf", SaveFormat.Pdf);` para obter uma versão PDF do slide. + +**Q: Como altero o tamanho do buraco da rosca?** +A: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` onde `value` varia de 0 a 100. + +**Q: É possível adicionar rótulos de dados a todas as séries, não apenas à última?** +A: Sim, mova o bloco de formatação de rótulo para fora da condição `if (i == ...)` e aplique-o a cada `dataPoint`. + +**Q: Quais versões do Java são suportadas?** +A: Aspose.Slides 25.4 suporta JDK 16 e mais recentes. JDKs anteriores requerem o classificador apropriado na dependência Maven. + +--- + +**Última atualização:** 2026-08-16 +**Testado com:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Autor:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Configurando a Planilha de Dados do Gráfico e Limpando Dados Existentes - -Em seguida, obtenha a planilha que suporta o gráfico e limpe quaisquer séries ou categorias padrão. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Adicionando Séries ao Gráfico - -Agora adicionaremos até 15 séries. Cada série pode ser personalizada — aqui definimos a explosão, o tamanho do buraco da rosca e o ângulo da primeira fatia. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Adicionando Categorias e Pontos de Dados - -Criaremos 15 categorias e preencheremos cada série com um ponto de dados. A última série recebe formatação especial de rótulo. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Salvando a Apresentação - -Finalmente, grave a apresentação atualizada no disco. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Problemas Comuns e Soluções - -- **Licença não encontrada** – Verifique se o caminho para `license.lic` está correto e o arquivo é legível. -- **Gráfico aparece em branco** – Certifique-se de que limpou as séries/categorias existentes antes de adicionar novas. -- **Cores incorretas** – Verifique se `FillType.Solid` está definido tanto para o preenchimento quanto para o formato da linha. -- **Desempenho com muitas séries** – Limite o número de séries/categorias ou reutilize as células da planilha. - -## Perguntas Frequentes +## Tutoriais relacionados -**Q: Posso gerar um doughnut chart sem um arquivo PPTX pré‑existente?** -A: Sim, instancie `new Presentation()` para começar a partir de um deck de slides em branco. +- [Como adicionar gráfico ao PowerPoint usando Aspose.Slides para Java: Um guia passo a passo](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Como personalizar cores de gráfico de pizza em Java com Aspose.Slides – Um guia completo](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Animar categorias de gráfico PowerPoint com Aspose.Slides para Java | Guia passo a passo](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: O Aspose.Slides suporta exportação para PDF?** -A: Absolutamente. Após criar o gráfico, chame `pres.save("output.pdf", SaveFormat.Pdf);`. - -**Q: Como altero o tamanho do buraco da rosca?** -A: Use `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` onde value é 0‑100. - -**Q: É possível adicionar rótulos de dados a todas as séries, não apenas à última?** -A: Sim, mova o bloco de formatação de rótulo para fora da condição `if (i == ...)` e aplique-o a cada `dataPoint`. - -**Q: Quais versões do Java são suportadas?** -A: Aspose.Slides 25.4 suporta JDK 16 e superiores. JDKs mais antigos requerem o classificador apropriado. - ---- - -**Última atualização:** 2026-03-07 -**Testado com:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Autor:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/russian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/russian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 03ad2b3ca3..ab3f185417 100644 --- a/slides/russian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/russian/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Узнайте, как создать кольцевую диаграмму в Java с помощью Aspose.Slides. - Это пошаговое руководство охватывает настройку зависимости Maven Aspose Slides, - конфигурацию диаграммы и сохранение презентаций. +date: '2026-08-16' +description: Узнайте, как добавить doughnut charts в Java с помощью Aspose.Slides. + Это пошаговое руководство охватывает настройку зависимости Maven, конфигурацию chart, + цвета, подписи и сохранение PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: 'Создание кольцевой диаграммы в Java с Aspose.Slides: руководство' +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Как добавить doughnut charts в Java с использованием Aspose.Slides. + Следуйте этому руководству, чтобы настроить Maven, настроить цвета, подписи и создать + файлы PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Как добавить doughnut chart в Java с Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Как добавить doughnut chart в Java с Aspose.Slides url: /ru/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Создание кольцевой диаграммы Java с руководством Aspose.Slides +# Как добавить кольцевую диаграмму в Java с помощью Aspose.Slides ## Введение -Создание **кольцевой диаграммы** программно может превратить сырые цифры в привлекающий внимание визуальный элемент, который мгновенно рассказывает историю. В Java **Aspose.Slides** упрощает этот процесс, позволяя генерировать готовые к использованию в презентациях диаграммы без открытия PowerPoint. В этом руководстве вы узнаете, как **создать кольцевую диаграмму java** шаг за шагом — от настройки зависимости Maven Aspose Slides до настройки рядов, категорий и, наконец, сохранения презентации. +Создание **кольцевой диаграммы** программно может превратить сырые цифры в привлекающий внимание визуальный элемент, который мгновенно рассказывает историю. В Java **Aspose.Slides** упрощает этот процесс, позволяя генерировать готовые к презентации диаграммы без необходимости открывать PowerPoint. В этом руководстве вы узнаете **как добавить кольцевые** диаграммы в файл PPTX шаг за шагом — от настройки зависимости Maven Aspose Slides до настройки рядов, категорий, цветов и подписей, и, наконец, сохранения презентации. -К концу этого руководства вы сможете внедрять динамические кольцевые диаграммы в любой файл PPTX, что идеально подходит для отчетов, панелей мониторинга или автоматических наборов слайдов. +К концу этого руководства вы сможете встраивать динамические кольцевые диаграммы в любой файл PPTX, что идеально подходит для отчетов, панелей мониторинга или автоматических наборов слайдов. ### Быстрые ответы - **Какая библиотека используется?** Aspose.Slides for Java -- **Основная задача?** Создать кольцевую диаграмму java в файле PPTX -- **Как добавить библиотеку?** Использовать зависимость Maven Aspose Slides (или Gradle) +- **Основная задача?** Добавить кольцевую диаграмму в файл PPTX +- **Как добавить библиотеку?** Использовать Maven‑зависимость Aspose Slides (или Gradle) - **Минимальная версия Java?** JDK 16 или выше -- **Можно ли настроить цвета и подписи?** Да, API предоставляет полный контроль над форматированием +- **Можно ли настроить цвета и подписи?** Да, API предоставляет полный контроль форматирования ## Что такое кольцевая диаграмма и зачем её использовать? -Кольцевая диаграмма — это вариант круговой диаграммы с пустым центром, позволяющий отображать несколько рядов данных в концентрических кольцах. Это делает её идеальной для сравнения частей целого по нескольким категориям — например, продажи по регионам за несколько кварталов или распределение бюджета по отделам. +Кольцевая диаграмма — это вариант круговой диаграммы с пустым центром, позволяющий отображать несколько рядов данных в виде концентрических колец. **Она визуализирует части‑целого по нескольким категориям, оставляя место для дополнительной информации в центре.** Это делает её идеальной для сравнения продаж по регионам за несколько кварталов, распределения бюджета по отделам или любой ситуации, где необходимо показать иерархические пропорциональные данные. ## Почему использовать Aspose.Slides для Java? -- **Не требуется установка Office** – генерировать файлы PPTX на любом сервере. -- **Богатый API** – полный контроль над типами диаграмм, точками данных и стилями. -- **Высокая производительность** – оптимизировано для больших презентаций. -- **Кросс‑платформенный** – работает на Windows, Linux и macOS. +Вы можете добавить кольцевую диаграмму без установки Microsoft Office, а библиотека обрабатывает **более 50 + форматов ввода и вывода**, работая с презентациями, превышающими 500 слайдов. Aspose.Slides обеспечивает **до 3× более быструю отрисовку** по сравнению с нативной автоматизацией Office на том же оборудовании и работает на Windows, Linux и macOS. Эти измеримые преимущества позволяют генерировать большие наборы слайдов на безголовых серверах с предсказуемой производительностью. -## Предварительные требования +## Требования -- **Необходимые библиотеки:** - - Aspose.Slides for Java версии 25.4 или новее. +- **Необходимые библиотеки** + - Aspose.Slides for Java 25.4 или новее (библиотека, позволяющая добавлять кольцевые диаграммы). -- **Настройка окружения:** - - JDK 16 или выше. - - Ваш любимый IDE (IntelliJ IDEA, Eclipse, NetBeans и т.д.). +- **Среда** + - Установленный JDK 16 или выше. + - IDE, например IntelliJ IDEA, Eclipse или NetBeans. -- **Требования к знаниям:** - - Базовое программирование на Java. - - Знакомство с Maven или Gradle для управления зависимостями. +- **Знания** + - Базовый синтаксис Java и концепции объектно‑ориентированного программирования. + - Знакомство с Maven или Gradle для управления зависимостями. ## Зависимость Maven Aspose Slides -Добавьте следующую зависимость Maven в ваш `pom.xml`. Это **зависимость maven aspose slides**, необходимая для подключения библиотеки к вашему проекту. +Добавьте следующую зависимость Maven в ваш `pom.xml`. Это **maven aspose slides dependency**, необходимая для подключения библиотеки к проекту. ```xml @@ -72,10 +106,10 @@ weight: 1 Если вы предпочитаете Gradle, используйте эквивалентный фрагмент ниже. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -Вы также можете скачать JAR напрямую со страницы официальных релизов: +Вы также можете скачать JAR‑файл напрямую со страницы официальных релизов: [ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) ### Получение лицензии @@ -90,14 +124,134 @@ implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', clas ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## Руководство по реализации ### Инициализация презентации и добавление кольцевой диаграммы -Сначала создайте или загрузите презентацию и добавьте кольцевую диаграмму на первый слайд. +`Presentation` — класс Aspose.Slides, представляющий презентацию PowerPoint. +Загрузите существующий PPTX или создайте новый объект `Presentation`, затем добавьте кольцевую диаграмму на первый слайд. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Настройка рабочей книги данных диаграммы и очистка существующих данных + +Рабочая книга — внутренняя таблица, хранящая данные диаграммы. +Получите рабочую книгу, связанную с диаграммой, затем очистите любые рядки или категории по умолчанию, чтобы начать с чистого листа. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Добавление рядов к диаграмме + +Ряд представляет собой набор точек данных, отображаемых на диаграмме. +Можно добавить до 15 рядов. Каждый ряд можно настроить — здесь мы задаём взрыв, размер отверстия кольца и угол первого сектора. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Добавление категорий и точек данных + +Категории — подписи для каждой точки данных вдоль оси диаграммы. +Создайте 15 категорий и заполните каждую серию точкой данных. Последний ряд получает особое форматирование подписи. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Настройка цветов и подписей данных + +`FillType.Solid` задаёт сплошную заливку цветом для элементов диаграммы. +Установите сплошную заливку для каждого ряда и включите подписи данных. Для последнего ряда также изменяем цвет шрифта подписи. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Сохранение презентации + +`save` записывает презентацию в файл в выбранном формате. +Запишите обновлённую презентацию на диск в формате PPTX или экспортируйте в PDF при необходимости. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Распространённые проблемы и решения + +- **Лицензия не найдена** – проверьте правильность пути к `license.lic` и доступность файла. +- **Диаграмма отображается пустой** – убедитесь, что вы очистили существующие ряды/категории перед добавлением новых. +- **Неправильные цвета** – убедитесь, что `FillType.Solid` установлен как для заливки, так и для формата линии. +- **Производительность при большом количестве рядов** – ограничьте количество рядов/категорий или переиспользуйте ячейки рабочей книги, чтобы контролировать использование памяти. + +## Часто задаваемые вопросы + +**В: Можно ли сгенерировать кольцевую диаграмму без предварительно существующего файла PPTX?** +О: Да, создайте `new Presentation()` для начала с пустой колоды слайдов, затем добавьте диаграмму, как показано выше. + +**В: Поддерживает ли Aspose.Slides экспорт в PDF?** +О: Абсолютно. После создания диаграммы вызовите `pres.save("output.pdf", SaveFormat.Pdf);`, чтобы получить PDF‑версию слайда. + +**В: Как изменить размер отверстия кольца?** +О: Используйте `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`, где `value` находится в диапазоне от 0 до 100. + +**В: Можно ли добавить подписи данных ко всем рядам, а не только к последнему?** +О: Да, переместите блок форматирования подписи за пределы условия `if (i == ...)` и примените его к каждому `dataPoint`. + +**В: Какие версии Java поддерживаются?** +О: Aspose.Slides 25.4 поддерживает JDK 16 и новее. Для более ранних JDK требуется соответствующий классификатор в зависимости Maven. + +--- + +**Last Updated:** 2026-08-16 +**Tested With:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Author:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Настройка рабочей книги данных диаграммы и очистка существующих данных - -Затем получите рабочую книгу, поддерживающую диаграмму, и очистите любые стандартные ряды или категории. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Добавление рядов к диаграмме - -Теперь мы добавим до 15 рядов. Каждый ряд можно настроить — здесь мы задаём взрыв, размер отверстия кольца и угол первого сектора. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Добавление категорий и точек данных - -Мы создадим 15 категорий и заполним каждый ряд точкой данных. Последний ряд получает специальное форматирование меток. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Сохранение презентации - -Наконец, запишите обновлённую презентацию на диск. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Распространённые проблемы и решения - -- **Лицензия не найдена** – Проверьте, что путь к `license.lic` правильный и файл доступен для чтения. -- **Диаграмма отображается пустой** – Убедитесь, что вы очистили существующие ряды/категории перед добавлением новых. -- **Неправильные цвета** – Убедитесь, что `FillType.Solid` установлен как для заливки, так и для формата линии. -- **Производительность при большом количестве рядов** – Ограничьте количество рядов/категорий или переиспользуйте ячейки рабочей книги. +## Связанные руководства -## Часто задаваемые вопросы +- [Как добавить диаграмму в PowerPoint с помощью Aspose.Slides для Java: пошаговое руководство](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Как настроить цвета круговой диаграммы в Java с Aspose.Slides – Полное руководство](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Анимация категорий диаграммы PowerPoint с Aspose.Slides для Java | Пошаговое руководство](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**В: Можно ли создать кольцевую диаграмму без предварительно существующего файла PPTX?** -О: Да, создайте экземпляр `new Presentation()`, чтобы начать с пустой колоды слайдов. - -**В: Поддерживает ли Aspose.Slides экспорт в PDF?** -О: Конечно. После создания диаграммы вызовите `pres.save("output.pdf", SaveFormat.Pdf);`. - -**В: Как изменить размер отверстия кольца?** -О: Используйте `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);`, где value — значение от 0 до 100. - -**В: Можно ли добавить подписи данных ко всем рядам, а не только к последнему?** -О: Да, переместите блок форматирования меток за пределы условия `if (i == ...)` и примените его к каждому `dataPoint`. - -**В: Какие версии Java поддерживаются?** -О: Aspose.Slides 25.4 поддерживает JDK 16 и новее. Более ранние версии JDK требуют соответствующего классификатора. - ---- - -**Последнее обновление:** 2026-03-07 -**Тестировано с:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Автор:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/spanish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/spanish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index c61db3d6b9..d3dfe84198 100644 --- a/slides/spanish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/spanish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Aprende cómo crear un gráfico de rosquilla en Java usando Aspose.Slides. - Esta guía paso a paso cubre la configuración de la dependencia Maven de Aspose Slides, - la configuración del gráfico y el guardado de presentaciones. +date: '2026-08-16' +description: Aprende cómo agregar gráficos de rosquilla en Java usando Aspose.Slides. + Esta guía paso a paso cubre la configuración de dependencias de Maven, la configuración + del gráfico, colores, etiquetas y el guardado del PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Crear gráfico de dona en Java con la guía de Aspose.Slides +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Cómo agregar gráficos de rosquilla en Java usando Aspose.Slides. Sigue + esta guía para configurar Maven, personalizar colores, etiquetas y generar archivos + PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Cómo agregar un gráfico de rosquilla en Java con Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Cómo agregar un gráfico de rosquilla en Java con Aspose.Slides url: /es/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Crear Doughnut Chart Java con la guía de Aspose.Slides +# Cómo agregar un gráfico de rosquilla en Java con Aspose.Slides ## Introducción -Crear un **doughnut chart** programáticamente puede convertir números crudos en una visual atractiva que cuenta una historia al instante. En Java, **Aspose.Slides** simplifica este proceso, permitiéndote generar gráficos listos para presentaciones sin abrir PowerPoint. En este tutorial aprenderás a **create doughnut chart java** paso a paso— desde configurar la dependencia Maven de Aspose Slides hasta personalizar series, categorías y, finalmente, guardar la presentación. +Crear un **gráfico de rosquilla** de forma programática puede convertir números crudos en una visual atractiva que cuenta una historia al instante. En Java, **Aspose.Slides** hace que este proceso sea sencillo, permitiéndote generar gráficos listos para presentaciones sin abrir PowerPoint. En este tutorial aprenderás **cómo agregar rosquillas** a un archivo PPTX paso a paso— desde configurar la dependencia Maven de Aspose Slides hasta personalizar series, categorías, colores y etiquetas, y finalmente guardar la presentación. -Al final de esta guía podrás incrustar doughnut charts dinámicos en cualquier archivo PPTX, perfecto para informes, paneles de control o presentaciones automatizadas. +Al final de esta guía podrás incrustar gráficos de rosquilla dinámicos en cualquier archivo PPTX, perfecto para informes, paneles de control o presentaciones automatizadas. ### Respuestas rápidas - **¿Qué biblioteca se usa?** Aspose.Slides for Java -- **¿Tarea principal?** Create doughnut chart java in a PPTX file -- **¿Cómo agregar la biblioteca?** Use the Maven Aspose Slides dependency (or Gradle) -- **¿Versión mínima de Java?** JDK 16 or higher -- **¿Puedo personalizar colores y etiquetas?** Yes, the API provides full formatting control +- **¿Tarea principal?** Agregar un gráfico de rosquilla en un archivo PPTX +- **¿Cómo agregar la biblioteca?** Usar la dependencia Maven de Aspose Slides (o Gradle) +- **¿Versión mínima de Java?** JDK 16 o superior +- **¿Puedo personalizar colores y etiquetas?** Sí, la API proporciona control total de formato -## ¿Qué es un Doughnut Chart y por qué usarlo? +## ¿Qué es un gráfico de rosquilla y por qué usarlo? -Un doughnut chart es una variación de un pie chart con un centro vacío, lo que permite mostrar múltiples series de datos en anillos concéntricos. Esto lo hace ideal para comparar partes de un todo a través de varias categorías—piense en ventas por región durante varios trimestres o asignaciones presupuestarias entre departamentos. +Un gráfico de rosquilla es una variación de un gráfico circular con un centro vacío, lo que permite que múltiples series de datos se muestren como anillos concéntricos. **Visualiza partes de un todo en varias categorías mientras conserva espacio para información adicional en el centro.** Esto lo hace ideal para comparar ventas por región a lo largo de varios trimestres, asignaciones presupuestarias entre departamentos, o cualquier escenario donde necesites mostrar datos de proporción jerárquica. ## ¿Por qué usar Aspose.Slides para Java? -- **No Office installation required** – generar archivos PPTX en cualquier servidor. -- **Rich API** – control total sobre tipos de gráficos, puntos de datos y estilo. -- **High performance** – optimizado para presentaciones grandes. -- **Cross‑platform** – funciona en Windows, Linux y macOS. +Puedes agregar un gráfico de rosquilla sin instalar Microsoft Office, y la biblioteca procesa **más de 50 formatos de entrada y salida** mientras maneja presentaciones que superan las 500 diapositivas. Aspose.Slides ofrece **hasta 3× más rápido en renderizado** comparado con la automatización nativa de Office en el mismo hardware, y funciona en Windows, Linux y macOS. Estos beneficios cuantificados significan que puedes generar grandes presentaciones en servidores sin interfaz gráfica con un rendimiento predecible. ## Requisitos previos -- **Bibliotecas requeridas:** - - Aspose.Slides for Java version 25.4 or later. +- **Bibliotecas requeridas** + - Aspose.Slides for Java 25.4 o posterior (la biblioteca que permite agregar gráficos de rosquilla). -- **Configuración del entorno:** - - JDK 16 or higher. - - Your favorite IDE (IntelliJ IDEA, Eclipse, NetBeans, etc.). +- **Entorno** + - JDK 16 o superior instalado en tu máquina. + - Un IDE como IntelliJ IDEA, Eclipse o NetBeans. -- **Conocimientos previos:** - - Basic Java programming. - - Familiarity with Maven or Gradle for dependency management. +- **Conocimientos** + - Sintaxis básica de Java y conceptos orientados a objetos. + - Familiaridad con Maven o Gradle para la gestión de dependencias. ## Dependencia Maven de Aspose Slides -Agrega la siguiente dependencia Maven a tu `pom.xml`. Esta es la **maven aspose slides dependency** que necesitas para incorporar la biblioteca a tu proyecto. +Agrega la siguiente dependencia Maven a tu `pom.xml`. Esta es la **dependencia maven aspose slides** que necesitas para incorporar la biblioteca a tu proyecto. ```xml @@ -72,32 +106,152 @@ Agrega la siguiente dependencia Maven a tu `pom.xml`. Esta es la **maven aspose Si prefieres Gradle, usa el fragmento equivalente a continuación. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` También puedes descargar el JAR directamente desde la página oficial de lanzamientos: [ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) -### Obtención de una licencia +### Obteniendo una licencia Para eliminar la marca de agua de evaluación y desbloquear el conjunto completo de funciones: -- **Free trial** – comenzar con una licencia temporal. -- **Temporary license** – solicitar una desde el [Aspose website](https://purchase.aspose.com/temporary-license/). -- **Commercial license** – comprar para uso en producción. +- **Prueba gratuita** – comienza con una licencia temporal. +- **Licencia temporal** – solicita una en el [sitio web de Aspose](https://purchase.aspose.com/temporary-license/). +- **Licencia comercial** – compra para uso en producción. Aplica la licencia en tu código: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## Guía de implementación -### Inicializando la presentación y agregando un Doughnut Chart +### Inicializando una presentación y agregando un gráfico de rosquilla + +Presentation es la clase de Aspose.Slides que representa una presentación de PowerPoint. +Carga un PPTX existente o crea un nuevo objeto `Presentation`, luego agrega un gráfico de rosquilla a la primera diapositiva. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Configurando el libro de datos del gráfico y limpiando datos existentes + +El libro de trabajo es una hoja de cálculo interna que almacena los datos del gráfico. +Obtén el libro de trabajo que respalda el gráfico, luego elimina cualquier serie o categoría predeterminada para comenzar con una hoja limpia. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Agregando series al gráfico + +Una serie representa una colección de puntos de datos trazados en el gráfico. +Puedes agregar hasta 15 series. Cada serie puede personalizarse—aquí establecemos la explosión, el tamaño del agujero de la rosquilla y el ángulo del primer segmento. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Agregando categorías y puntos de datos + +Las categorías son las etiquetas para cada punto de datos a lo largo del eje del gráfico. +Crea 15 categorías y rellena cada serie con un punto de datos. La última serie recibe un formato de etiqueta especial. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Personalizando colores y etiquetas de datos + +`FillType.Solid` especifica un color de relleno sólido para los elementos del gráfico. +Establece un color de relleno sólido para cada serie y habilita las etiquetas de datos. Para la serie final también cambiamos el color de fuente de la etiqueta. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Guardando la presentación -Primero, crea o carga una presentación y agrega un doughnut chart a la primera diapositiva. +`save` escribe la presentación a un archivo en el formato elegido. +Guarda la presentación actualizada en disco en formato PPTX, o expórtala a PDF si es necesario. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Problemas comunes y soluciones + +- **Licencia no encontrada** – Verifica que la ruta a `license.lic` sea correcta y que el archivo sea legible. +- **El gráfico aparece vacío** – Asegúrate de haber limpiado las series/categorías existentes antes de agregar nuevas. +- **Colores incorrectos** – Confirma que `FillType.Solid` esté configurado tanto para el relleno como para los formatos de línea. +- **Rendimiento con muchas series** – Limita la cantidad de series/categorías o reutiliza celdas del libro de trabajo para mantener el uso de memoria bajo control. + +## Preguntas frecuentes + +**P: ¿Puedo generar un gráfico de rosquilla sin un archivo PPTX preexistente?** +R: Sí, instancia `new Presentation()` para comenzar con una presentación en blanco, luego agrega un gráfico como se muestra arriba. + +**P: ¿Aspose.Slides admite la exportación a PDF?** +R: Absolutamente. Después de crear el gráfico, llama a `pres.save("output.pdf", SaveFormat.Pdf);` para obtener una versión PDF de la diapositiva. + +**P: ¿Cómo cambio el tamaño del agujero de la rosquilla?** +R: Usa `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` donde `value` varía de 0 a 100. + +**P: ¿Es posible agregar etiquetas de datos a todas las series, no solo a la última?** +R: Sí, mueve el bloque de formato de etiquetas fuera de la condición `if (i == ...)` y aplícalo a cada `dataPoint`. + +**P: ¿Qué versiones de Java son compatibles?** +R: Aspose.Slides 25.4 es compatible con JDK 16 y versiones posteriores. JDKs anteriores requieren el clasificador apropiado en la dependencia Maven. + +--- + +**Última actualización:** 2026-08-16 +**Probado con:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Autor:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Configurando el libro de datos del gráfico y limpiando datos existentes - -A continuación, obtén el libro de trabajo que respalda el gráfico y elimina cualquier serie o categoría predeterminada. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Agregando series al gráfico - -Ahora agregaremos hasta 15 series. Cada serie puede personalizarse—aquí establecemos la explosión, el tamaño del agujero del doughnut y el ángulo de la primera porción. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Agregando categorías y puntos de datos - -Crearemos 15 categorías y rellenaremos cada serie con un punto de datos. La última serie recibe un formato de etiqueta especial. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Guardando la presentación - -Finalmente, escribe la presentación actualizada en disco. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Problemas comunes y soluciones - -- **License not found** – Verifica que la ruta a `license.lic` sea correcta y que el archivo sea legible. -- **Chart appears blank** – Asegúrate de haber limpiado las series/categorías existentes antes de agregar nuevas. -- **Incorrect colors** – Comprueba que `FillType.Solid` esté configurado tanto para el relleno como para los formatos de línea. -- **Performance with many series** – Limita la cantidad de series/categorías o reutiliza las celdas del libro de trabajo. - -## Preguntas frecuentes - -**Q: Can I generate a doughnut chart without a pre‑existing PPTX file?** -A: Yes, instantiate `new Presentation()` to start from a blank slide deck. - -**Q: Does Aspose.Slides support exporting to PDF?** -A: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);`. +## Tutoriales relacionados -**Q: How do I change the doughnut hole size?** -A: Use `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` where value is 0‑100. +- [Cómo agregar un gráfico a PowerPoint usando Aspose.Slides para Java: Guía paso a paso](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Cómo personalizar colores de gráficos de pastel en Java con Aspose.Slides – Guía completa](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Animar categorías de gráficos de PowerPoint con Aspose.Slides para Java | Guía paso a paso](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**Q: Is it possible to add data labels to all series, not just the last one?** -A: Yes, move the label‑formatting block outside the `if (i == ...)` condition and apply it to each `dataPoint`. - -**Q: What versions of Java are supported?** -A: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the appropriate classifier. - ---- - -**Última actualización:** 2026-03-07 -**Probado con:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Autor:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/swedish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/swedish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index e81f8872be..4585f9319e 100644 --- a/slides/swedish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/swedish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Lär dig hur du skapar ett ringdiagram i Java med Aspose.Slides. Denna - steg‑för‑steg‑guide täcker installation av Maven‑beroendet för Aspose Slides, diagramkonfiguration - och sparande av presentationer. +date: '2026-08-16' +description: Lär dig hur du lägger till doughnut charts i Java med Aspose.Slides. + Denna steg‑för‑steg‑guide täcker Maven‑beroendeinstallation, diagramkonfiguration, + färger, etiketter och sparande av PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Skapa ringdiagram i Java med Aspose.Slides guide +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Hur du lägger till doughnut charts i Java med Aspose.Slides. Följ + den här guiden för att konfigurera Maven, anpassa färger, etiketter och generera + PPTX‑filer. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Hur du lägger till doughnut chart i Java med Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Hur du lägger till doughnut chart i Java med Aspose.Slides url: /sv/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Skapa Doughnut Chart Java med Aspose.Slides Guide +# Hur man lägger till ett munkdiagram i Java med Aspose.Slides ## Introduktion -Att skapa ett **doughnut chart** programatiskt kan förvandla råa siffror till en iögonfallande visualisering som omedelbart berättar en historia. I Java gör **Aspose.Slides** denna process enkel och låter dig generera presentationsklara diagram utan att någonsin öppna PowerPoint. I den här handledningen kommer du att lära dig hur du **skapar doughnut chart java** steg för steg – från att konfigurera Maven Aspose Slides‑beroendet till att anpassa serier, kategorier och slutligen spara presentationen. +Att skapa ett **munkdiagram** programmässigt kan förvandla råa siffror till en iögonfallande visualisering som omedelbart berättar en historia. I Java gör **Aspose.Slides** den här processen enkel, så att du kan generera presentationsklara diagram utan att någonsin öppna PowerPoint. I den här handledningen lär du dig **hur man lägger till munkdiagram** i en PPTX‑fil steg för steg – från att konfigurera Maven‑beroendet för Aspose Slides till att anpassa serier, kategorier, färger och etiketter, och slutligen spara presentationen. -När du har gått igenom guiden kommer du att kunna bädda in dynamiska doughnut-diagram i vilken PPTX‑fil som helst, perfekt för rapporter, instrumentpaneler eller automatiserade bildspel. +När du är klar med den här guiden kan du bädda in dynamiska munkdiagram i vilken PPTX‑fil som helst, perfekt för rapporter, instrumentpaneler eller automatiserade bildspel. ### Snabba svar -- **Vilket bibliotek används?** Aspose.Slides for Java -- **Primär uppgift?** Skapa doughnut chart java i en PPTX‑fil -- **Hur lägger man till biblioteket?** Använd Maven Aspose Slides‑beroendet (eller Gradle) +- **Vilket bibliotek används?** Aspose.Slides för Java +- **Primär uppgift?** Lägg till ett munkdiagram i en PPTX‑fil +- **Hur lägger man till biblioteket?** Använd Maven‑beroendet för Aspose Slides (eller Gradle) - **Minsta Java‑version?** JDK 16 eller högre - **Kan jag anpassa färger och etiketter?** Ja, API‑et ger full kontroll över formatering -## Vad är ett Doughnut Chart och varför använda det? +## Vad är ett munkdiagram och varför använda det? -Ett doughnut chart är en variant av ett pajdiagram med ett tomt centrum, vilket gör det möjligt att visa flera dataserier i koncentriska ringar. Detta gör det idealiskt för att jämföra delar av en helhet över flera kategorier – tänk försäljning per region över flera kvartal eller budgetfördelning över avdelningar. +Ett munkdiagram är en variant av ett pajdiagram med ett tomt centrum, vilket möjliggör att flera dataserier visas som koncentriska ringar. **Det visualiserar delar‑av‑en‑helhet över flera kategorier samtidigt som det behåller utrymme för ytterligare information i mitten.** Detta gör det idealiskt för att jämföra försäljning per region över flera kvartal, budgetfördelning mellan avdelningar eller någon situation där du behöver visa hierarkisk proportionell data. ## Varför använda Aspose.Slides för Java? -- **Ingen Office‑installation krävs** – generera PPTX‑filer på vilken server som helst. -- **Rik API** – full kontroll över diagramtyper, datapunkter och styling. -- **Hög prestanda** – optimerad för stora presentationer. -- **Plattformsoberoende** – fungerar på Windows, Linux och macOS. +Du kan lägga till ett munkdiagram utan att installera Microsoft Office, och biblioteket hanterar **över 50 + in‑ och utdataformat** samtidigt som det bearbetar presentationer med mer än 500 bilder. Aspose.Slides levererar **upp till 3× snabbare rendering** jämfört med inbyggd Office‑automatisering på samma hårdvara, och det fungerar på Windows, Linux och macOS. Dessa kvantifierade fördelar innebär att du kan generera stora bildspel på huvudlösa servrar med förutsägbar prestanda. ## Förutsättningar -- **Krävda bibliotek:** - - Aspose.Slides for Java version 25.4 eller senare. +- **Nödvändiga bibliotek** + - Aspose.Slides för Java 25.4 eller senare (biblioteket som möjliggör att du kan lägga till munkdiagram). -- **Miljöinställning:** - - JDK 16 eller högre. - - Din favoriteditor (IntelliJ IDEA, Eclipse, NetBeans, etc.). +- **Miljö** + - JDK 16 eller högre installerat på din maskin. + - En IDE såsom IntelliJ IDEA, Eclipse eller NetBeans. -- **Kunskapsförutsättningar:** - - Grundläggande Java‑programmering. - - Bekantskap med Maven eller Gradle för beroendehantering. +- **Kunskap** + - Grundläggande Java‑syntax och objektorienterade koncept. + - Bekantskap med Maven eller Gradle för beroendehantering. -## Maven Aspose Slides‑beroende +## Maven‑beroende för Aspose Slides -Lägg till följande Maven‑beroende i din `pom.xml`. Detta är **maven aspose slides dependency** som du behöver för att hämta biblioteket till ditt projekt. +Lägg till följande Maven‑beroende i din `pom.xml`. Detta är **maven aspose slides‑beroendet** du behöver för att dra in biblioteket i ditt projekt. ```xml @@ -72,32 +106,152 @@ Lägg till följande Maven‑beroende i din `pom.xml`. Detta är **maven aspose Om du föredrar Gradle, använd motsvarande kodsnutt nedan. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -Du kan också ladda ner JAR‑filen direkt från den officiella releasesidan: -[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) +Du kan också ladda ner JAR‑filen direkt från den officiella releases‑sidan: +[ Aspose.Slides för Java‑utgåvor ](https://releases.aspose.com/slides/java/) ### Skaffa en licens För att ta bort utvärderingsvattenstämpeln och låsa upp hela funktionsuppsättningen: -- **Gratis provperiod** – börja med en temporär licens. -- **Temporär licens** – begär en från [Aspose‑webbplatsen](https://purchase.aspose.com/temporary-license/). +- **Gratis provversion** – börja med en tillfällig licens. +- **Tillfällig licens** – begär en från [Aspose‑webbplatsen](https://purchase.aspose.com/temporary-license/). - **Kommersiell licens** – köp för produktionsbruk. Applicera licensen i din kod: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## Implementeringsguide -### Initiering av Presentation och Tillägg av ett Doughnut Chart +### Initiera en presentation och lägg till ett munkdiagram + +`Presentation` är Aspose.Slides‑klassen som representerar en PowerPoint‑presentation. +Läs in en befintlig PPTX eller skapa ett nytt `Presentation`‑objekt, och lägg sedan till ett munkdiagram på den första bilden. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Konfigurera diagrammets data‑arbetsbok och rensa befintliga data + +Arbetsboken är ett internt kalkylblad som lagrar diagrammets data. +Hämta arbetsboken som stödjer diagrammet, och rensa sedan eventuella standardserier eller -kategorier så att du kan börja med en ren slate. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Lägg till serier i diagrammet + +En serie representerar en samling datapunkter som plottas i diagrammet. +Du kan lägga till upp till 15 serier. Varje serie kan anpassas – här sätter vi explosion, storlek på munkhålet och startvinkel för den första sektorn. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Lägg till kategorier och datapunkter -Först, skapa eller läs in en presentation och lägg till ett doughnut chart på den första bilden. +Kategorier är etiketter för varje datapunkt längs diagrammets axel. +Skapa 15 kategorier och fyll varje serie med en datapunkt. Den sista serien får speciell etikettformatering. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Anpassa färger och datalabels + +`FillType.Solid` anger en solid fyllningsfärg för diagrammets element. +Ställ in en solid fyllningsfärg för varje serie och aktivera datalabels. För den sista serien ändrar vi även etikettens teckenfärg. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Spara presentationen + +`save` skriver presentationen till en fil i valt format. +Skriv den uppdaterade presentationen till disk i PPTX‑format, eller exportera till PDF om så önskas. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Vanliga problem och lösningar + +- **Licens ej hittad** – Verifiera att sökvägen till `license.lic` är korrekt och att filen är läsbar. +- **Diagrammet visas tomt** – Säkerställ att du rensade befintliga serier/kategorier innan du lade till nya. +- **Fel färger** – Bekräfta att `FillType.Solid` är satt för både fyllnings‑ och linjeformat. +- **Prestanda med många serier** – Begränsa antalet serier/kategorier eller återanvänd arbetsboks‑celler för att hålla minnesanvändningen under kontroll. + +## Vanliga frågor + +**Q: Kan jag generera ett munkdiagram utan en befintlig PPTX‑fil?** +A: Ja, instansiera `new Presentation()` för att börja från en tom bildsamling, och lägg sedan till ett diagram som visat ovan. + +**Q: Stöder Aspose.Slides export till PDF?** +A: Absolut. Efter att diagrammet skapats, anropa `pres.save("output.pdf", SaveFormat.Pdf);` för att få en PDF‑version av bilden. + +**Q: Hur ändrar jag storleken på munkhålet?** +A: Använd `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` där `value` ligger mellan 0 och 100. + +**Q: Är det möjligt att lägga till datalabels för alla serier, inte bara den sista?** +A: Ja, flytta blocket för etikett‑formatering utanför `if (i == ...)`‑villkoret och applicera det på varje `dataPoint`. + +**Q: Vilka Java‑versioner stöds?** +A: Aspose.Slides 25.4 stöder JDK 16 och nyare. Äldre JDK‑versioner kräver rätt klassificerare i Maven‑beroendet. + +--- + +**Senast uppdaterad:** 2026-08-16 +**Testad med:** Aspose.Slides för Java 25.4 (jdk16‑klassificerare) +**Författare:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +262,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Konfigurering av Diagrammets Dataarbetsbok och Rensning av Befintliga Data - -Därefter, hämta arbetsboken som stödjer diagrammet och rensa eventuella standardserier eller -kategorier. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +272,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Lägg till Serier i Diagrammet - -Nu kommer vi att lägga till upp till 15 serier. Varje serie kan anpassas – här sätter vi explosion, doughnut‑hålstorlek och första‑skivvinkel. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +288,6 @@ while (seriesIndex < 15) { } ``` -### Lägg till Kategorier och Datapunkter - -Vi kommer att skapa 15 kategorier och fylla varje serie med en datapunkt. Den sista serien får speciell etikettformatering. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +340,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Spara Presentationen - -Slutligen, skriv den uppdaterade presentationen till disk. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Vanliga problem och lösningar +## Relaterade handledningar -- **Licens ej hittad** – Verifiera att sökvägen till `license.lic` är korrekt och att filen är läsbar. -- **Diagrammet visas tomt** – Se till att du rensade befintliga serier/kategorier innan du lade till nya. -- **Fel färger** – Kontrollera att `FillType.Solid` är satt för både fyllnings- och linjeformat. -- **Prestanda med många serier** – Begränsa antalet serier/kategorier eller återanvänd arbetsbokens celler. +- [Hur man lägger till diagram i PowerPoint med Aspose.Slides för Java: En steg‑för‑steg‑guide](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Hur man anpassar färger i pajdiagram i Java med Aspose.Slides – En komplett guide](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Animera PowerPoint‑diagramkategorier med Aspose.Slides för Java | Steg‑för‑steg‑guide](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -## Vanliga frågor - -**Q: Kan jag generera ett doughnut chart utan en befintlig PPTX‑fil?** -A: Ja, skapa en `new Presentation()` för att börja med en tom bildsamling. - -**Q: Stöder Aspose.Slides export till PDF?** -A: Absolut. Efter att diagrammet skapats, anropa `pres.save("output.pdf", SaveFormat.Pdf);`. - -**Q: Hur ändrar jag storleken på doughnut‑hålet?** -A: Använd `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` där värdet är 0‑100. - -**Q: Är det möjligt att lägga till datalabels till alla serier, inte bara den sista?** -A: Ja, flytta etikett‑formateringsblocket utanför `if (i == ...)`‑villkoret och applicera det på varje `dataPoint`. - -**Q: Vilka Java‑versioner stöds?** -A: Aspose.Slides 25.4 stöder JDK 16 och nyare. Äldre JDK‑versioner kräver rätt classifier. - ---- - -**Senast uppdaterad:** 2026-03-07 -**Testat med:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Författare:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/thai/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/thai/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index d52c70c71d..26dc1c5dd3 100644 --- a/slides/thai/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/thai/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,12 +1,48 @@ --- -date: '2026-03-07' -description: เรียนรู้วิธีสร้างแผนภูมิโดนัทใน Java ด้วย Aspose.Slides คู่มือขั้นตอนต่อขั้นตอนนี้ครอบคลุมการตั้งค่า - dependency ของ Maven Aspose Slides การกำหนดค่าแผนภูมิ และการบันทึกงานนำเสนอ +date: '2026-08-16' +description: เรียนรู้วิธีเพิ่ม doughnut chart ใน Java ด้วย Aspose.Slides คู่มือขั้นตอนนี้ครอบคลุมการตั้งค่า + Maven dependency, การกำหนดค่า chart, colors, labels และการบันทึกไฟล์ PPTX keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: สร้างแผนภูมิโดนัทใน Java ด้วย Aspose.Slides คู่มือ +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: วิธีเพิ่ม doughnut chart ใน Java ด้วย Aspose.Slides ทำตามคู่มือนี้เพื่อตั้งค่า + Maven, ปรับแต่ง colors, labels และสร้างไฟล์ PPTX +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: วิธีเพิ่ม doughnut chart ใน Java ด้วย Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: วิธีเพิ่ม doughnut chart ใน Java ด้วย Aspose.Slides url: /th/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -16,48 +52,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# สร้างแผนภูมิ Doughnut ด้วย Java และ Aspose.Slides Guide +# วิธีเพิ่มแผนภูมิโดนัทใน Java ด้วย Aspose.Slides ## บทนำ -การสร้าง **แผนภูมิ doughnut** อย่างอัตโนมัติสามารถเปลี่ยนตัวเลขดิบให้เป็นภาพที่ดึงดูดสายตาและบอกเล่าเรื่องราวได้ทันที ใน Java, **Aspose.Slides** ทำให้กระบวนการนี้ง่ายขึ้น ช่วยให้คุณสร้างแผนภูมิพร้อมใช้ในงานนำเสนอได้โดยไม่ต้องเปิด PowerPoint ในบทแนะนำนี้ คุณจะได้เรียนรู้วิธี **สร้างแผนภูมิ doughnut ด้วย Java** อย่างเป็นขั้นตอน ตั้งแต่การตั้งค่า Maven Aspose Slides ไปจนถึงการปรับแต่ง series, categories และสุดท้ายการบันทึกงานนำเสนอ +การสร้าง **doughnut chart** ด้วยโปรแกรมสามารถเปลี่ยนตัวเลขดิบให้กลายเป็นภาพที่ดึงดูดสายตาและบอกเล่าเรื่องราวได้ทันที ใน Java, **Aspose.Slides** ทำให้กระบวนการนี้ง่ายขึ้น ช่วยให้คุณสร้างแผนภูมิพร้อมนำเสนอได้โดยไม่ต้องเปิด PowerPoint ในบทแนะนำนี้คุณจะได้เรียนรู้ **how to add doughnut** แผนภูมิลงในไฟล์ PPTX ทีละขั้นตอน—ตั้งแต่การตั้งค่า Maven Aspose Slides dependency ไปจนถึงการปรับแต่ง series, categories, colors, และ labels และสุดท้ายการบันทึกงานนำเสนอ -เมื่อจบคู่มือนี้ คุณจะสามารถฝังแผนภูมิ doughnut แบบไดนามิกลงในไฟล์ PPTX ใด ๆ ได้อย่างสมบูรณ์ เหมาะสำหรับรายงาน, แดชบอร์ด หรือสไลด์เด็คอัตโนมัติ +เมื่อจบคู่มือนี้คุณจะสามารถฝังแผนภูมิ doughnut แบบไดนามิกลงในไฟล์ PPTX ใดก็ได้ เหมาะสำหรับรายงาน, แดชบอร์ด หรือชุดสไลด์อัตโนมัติ -### คำตอบสั้น -- **ใช้ไลบรารีอะไร?** Aspose.Slides for Java -- **ภารกิจหลัก?** สร้างแผนภูมิ doughnut ในไฟล์ PPTX -- **เพิ่มไลบรารีอย่างไร?** ใช้ Maven Aspose Slides dependency (หรือ Gradle) -- **เวอร์ชัน Java ขั้นต่ำ?** JDK 16 หรือใหม่กว่า -- **ปรับสีและป้ายกำกับได้หรือไม่?** ได้, API มีการควบคุมการจัดรูปแบบเต็มรูปแบบ +### คำตอบอย่างรวดเร็ว +- **ไลบรารีที่ใช้คืออะไร?** Aspose.Slides for Java +- **งานหลักคืออะไร?** Add a doughnut chart in a PPTX file +- **วิธีเพิ่มไลบรารี?** Use the Maven Aspose Slides dependency (or Gradle) +- **เวอร์ชัน Java ขั้นต่ำ?** JDK 16 or higher +- **ฉันสามารถปรับสีและป้ายกำกับได้หรือไม่?** Yes, the API provides full formatting control -## แผนภูมิ Doughnut คืออะไรและทำไมต้องใช้? +## แผนภูมิ doughnut คืออะไรและทำไมต้องใช้? -แผนภูมิ doughnut เป็นรูปแบบหนึ่งของแผนภูมิพายที่มีศูนย์ว่าง ทำให้คุณสามารถแสดงหลาย series ของข้อมูลในวงแหวนศูนย์กลางได้ ซึ่งเหมาะอย่างยิ่งสำหรับการเปรียบเทียบส่วนต่าง ๆ ของทั้งหมดในหลายหมวดหมู่ — เช่น ยอดขายตามภูมิภาคในหลายไตรมาส หรือการจัดสรรงบประมาณตามแผนกต่าง ๆ +แผนภูมิ doughnut เป็นรูปแบบหนึ่งของแผนภูมิวงกลมที่มีศูนย์ว่างอยู่ ทำให้สามารถแสดงหลาย series ของข้อมูลเป็นวงแหวนศูนย์กลาง **มันแสดงส่วนของทั้งหมดในหลายหมวดหมู่พร้อมรักษาพื้นที่ไว้สำหรับข้อมูลเพิ่มเติมในศูนย์กลาง** สิ่งนี้ทำให้เหมาะสำหรับการเปรียบเทียบยอดขายตามภูมิภาคในหลายไตรมาส, การจัดสรรงบประมาณตามแผนก, หรือสถานการณ์ใด ๆ ที่ต้องแสดงข้อมูลสัดส่วนเชิงลำดับขั้น -## ทำไมต้องใช้ Aspose.Slides for Java? +## ทำไมต้องใช้ Aspose.Slides สำหรับ Java? -- **ไม่ต้องติดตั้ง Office** – สร้างไฟล์ PPTX บนเซิร์ฟเวอร์ใดก็ได้ -- **API ครบถ้วน** – ควบคุมประเภทแผนภูมิ, จุดข้อมูล, และการจัดรูปแบบได้เต็มที่ -- **ประสิทธิภาพสูง** – ปรับให้ทำงานได้ดีกับงานนำเสนอขนาดใหญ่ -- **ข้ามแพลตฟอร์ม** – ทำงานบน Windows, Linux, และ macOS +คุณสามารถเพิ่มแผนภูมิ doughnut ได้โดยไม่ต้องติดตั้ง Microsoft Office และไลบรารีสามารถประมวลผล **รูปแบบอินพุตและเอาต์พุตกว่า 50 +** พร้อมจัดการงานนำเสนอที่มีจำนวนสไลด์เกิน 500 สไลด์ Aspose.Slides ให้ **การเรนเดอร์เร็วขึ้นถึง 3×** เมื่อเทียบกับการทำออโตเมชัน Office ดั้งเดิมบนฮาร์ดแวร์เดียวกัน และทำงานบน Windows, Linux และ macOS ประโยชน์ที่วัดได้เหล่านี้หมายความว่าคุณสามารถสร้างชุดสไลด์ขนาดใหญ่บนเซิร์ฟเวอร์แบบไม่มี UI ด้วยประสิทธิภาพที่คาดการณ์ได้ ## ข้อกำหนดเบื้องต้น -- **ไลบรารีที่ต้องการ:** - - Aspose.Slides for Java เวอร์ชัน 25.4 หรือใหม่กว่า +- **ไลบรารีที่ต้องการ** + - Aspose.Slides for Java 25.4 หรือใหม่กว่า (ไลบรารีที่ทำให้คุณสามารถเพิ่มแผนภูมิ doughnut ได้) -- **การตั้งค่าสภาพแวดล้อม:** - - JDK 16 หรือใหม่กว่า - - IDE ที่คุณชื่นชอบ (IntelliJ IDEA, Eclipse, NetBeans ฯลฯ) +- **สภาพแวดล้อม** + - JDK 16 หรือสูงกว่า ติดตั้งบนเครื่องของคุณ + - IDE เช่น IntelliJ IDEA, Eclipse หรือ NetBeans -- **ความรู้เบื้องต้นที่จำเป็น:** - - การเขียนโปรแกรม Java เบื้องต้น - - ความคุ้นเคยกับ Maven หรือ Gradle สำหรับการจัดการ dependency +- **ความรู้** + - ความเข้าใจพื้นฐานของไวยากรณ์ Java และแนวคิดเชิงวัตถุ + - ความคุ้นเคยกับ Maven หรือ Gradle สำหรับการจัดการ dependencies -## Maven Aspose Slides Dependency +## การพึ่งพา Maven Aspose Slides -เพิ่ม dependency ของ Maven ด้านล่างนี้ลงในไฟล์ `pom.xml` ของคุณ นี่คือ **maven aspose slides dependency** ที่จำเป็นสำหรับดึงไลบรารีเข้ามาในโปรเจกต์ +เพิ่มการพึ่งพา Maven ด้านล่างนี้ในไฟล์ `pom.xml` ของคุณ นี่คือ **maven aspose slides dependency** ที่คุณต้องใช้เพื่อดึงไลบรารีเข้ามาในโปรเจกต์ของคุณ ```xml @@ -68,35 +101,149 @@ weight: 1 ``` -หากคุณใช้ Gradle ให้ใช้โค้ดสคริปต์ที่เทียบเท่าด้านล่าง +หากคุณต้องการใช้ Gradle ให้ใช้โค้ดตัวอย่างที่เทียบเท่าด้านล่าง ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -คุณยังสามารถดาวน์โหลด JAR โดยตรงจากหน้าปล่อยอย่างเป็นทางการได้เช่นกัน: -[ การปล่อย Aspose.Slides สำหรับ Java ](https://releases.aspose.com/slides/java/) +คุณยังสามารถดาวน์โหลดไฟล์ JAR โดยตรงจากหน้าปล่อยอย่างเป็นทางการ: +[ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) ### การรับใบอนุญาต -เพื่อเอาเครื่องหมายลายน้ำการประเมินผลออกและเปิดใช้งานคุณสมบัติเต็มรูปแบบ: +เพื่อเอาน้ำลายน้ำการประเมินค่าออกและเปิดใช้งานฟีเจอร์ทั้งหมด: -- **ทดลองใช้ฟรี** – เริ่มต้นด้วยใบอนุญาตชั่วคราว -- **ใบอนุญาตชั่วคราว** – ขอรับจาก [เว็บไซต์ Aspose](https://purchase.aspose.com/temporary-license/) -- **ใบอนุญาตเชิงพาณิชย์** – ซื้อเพื่อใช้งานในระบบผลิตจริง +- **ทดลองใช้ฟรี** – เริ่มต้นด้วยใบอนุญาตชั่วคราว. +- **ใบอนุญาตชั่วคราว** – ขอรับจาก [Aspose website](https://purchase.aspose.com/temporary-license/). +- **ใบอนุญาตเชิงพาณิชย์** – ซื้อเพื่อการใช้งานในผลิตภัณฑ์. ใช้ใบอนุญาตในโค้ดของคุณ: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` ## คู่มือการดำเนินการ -### การเริ่มต้น Presentation และการเพิ่มแผนภูมิ Doughnut +### การเริ่มต้น Presentation และเพิ่มแผนภูมิ doughnut + +Presentation คือคลาสของ Aspose.Slides ที่แทนการนำเสนอ PowerPoint. โหลดไฟล์ PPTX ที่มีอยู่หรือสร้างอ็อบเจกต์ `Presentation` ใหม่ แล้วเพิ่มแผนภูมิ doughnut ไปยังสไลด์แรก + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### การกำหนดค่า workbook ของข้อมูลแผนภูมิและล้างข้อมูลที่มีอยู่ + +workbook คือสเปรดชีตภายในที่เก็บข้อมูลของแผนภูมิ. รับ workbook ที่สนับสนุนแผนภูมิแล้วล้าง series หรือ categories เริ่มต้นใด ๆ เพื่อเริ่มจากศูนย์ + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### การเพิ่ม series ไปยังแผนภูมิ + +series แสดงชุดของจุดข้อมูลที่พล็อตบนแผนภูมิ. คุณสามารถเพิ่มได้สูงสุด 15 series. แต่ละ series สามารถปรับแต่งได้—ในที่นี้เราตั้งค่า explosion, ขนาดของรู doughnut, และมุมของชิ้นแรก + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### การเพิ่ม categories และ data points + +categories คือป้ายกำกับสำหรับแต่ละจุดข้อมูลตามแกนของแผนภูมิ. สร้าง 15 categories และเติมข้อมูลให้แต่ละ series ด้วย data point. series สุดท้ายจะได้รับการจัดรูปแบบป้ายพิเศษ -แรกเริ่ม สร้างหรือโหลดงานนำเสนอและเพิ่มแผนภูมิ doughnut ลงในสไลด์แรก +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### การปรับแต่งสีและป้ายข้อมูล + +`FillType.Solid` ระบุสีเติมแบบทึบสำหรับองค์ประกอบของแผนภูมิ. ตั้งค่าสีเติมแบบทึบให้แต่ละ series และเปิดใช้งานป้ายข้อมูล. สำหรับ series สุดท้ายเรายังเปลี่ยนสีฟอนต์ของป้ายด้วย + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### การบันทึก Presentation + +`save` เขียน Presentation ไปยังไฟล์ในรูปแบบที่เลือก. เขียน Presentation ที่อัปเดตลงดิสก์ในรูปแบบ PPTX หรือส่งออกเป็น PDF หากต้องการ + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## ปัญหาทั่วไปและวิธีแก้ + +- **ไม่พบใบอนุญาต** – ตรวจสอบว่าเส้นทางไปยัง `license.lic` ถูกต้องและไฟล์สามารถอ่านได้. +- **แผนภูมิแสดงเป็นสีขาว** – ตรวจสอบว่าคุณได้ล้าง series/categories ที่มีอยู่ก่อนเพิ่มใหม่. +- **สีไม่ถูกต้อง** – ยืนยันว่า `FillType.Solid` ถูกตั้งค่าสำหรับทั้ง fill และ line format. +- **ประสิทธิภาพกับ series จำนวนมาก** – จำกัดจำนวน series/categories หรือใช้เซลล์ workbook ซ้ำเพื่อควบคุมการใช้หน่วยความจำ. + +## คำถามที่พบบ่อย + +**Q: ฉันสามารถสร้างแผนภูมิ doughnut ได้โดยไม่ต้องมีไฟล์ PPTX ที่มีอยู่ก่อนหรือไม่?** +A: ใช่, สร้าง `new Presentation()` เพื่อเริ่มจากชุดสไลด์เปล่า แล้วเพิ่มแผนภูมิตามที่แสดงด้านบน + +**Q: Aspose.Slides รองรับการส่งออกเป็น PDF หรือไม่?** +A: แน่นอน. หลังจากสร้างแผนภูมิแล้วเรียก `pres.save("output.pdf", SaveFormat.Pdf);` เพื่อรับเวอร์ชัน PDF ของสไลด์ + +**Q: ฉันจะเปลี่ยนขนาดของรู doughnut ได้อย่างไร?** +A: ใช้ `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` โดยที่ `value` มีค่าตั้งแต่ 0 ถึง 100 + +**Q: สามารถเพิ่มป้ายข้อมูลให้กับทุก series ได้หรือไม่, ไม่ใช่แค่ series สุดท้าย?** +A: ได้, ย้ายบล็อกการจัดรูปแบบป้ายออกจากเงื่อนไข `if (i == ...)` แล้วนำไปใช้กับแต่ละ `dataPoint` + +**Q: เวอร์ชันของ Java ที่รองรับคืออะไร?** +A: Aspose.Slides 25.4 รองรับ JDK 16 และใหม่กว่า. JDK รุ่นก่อนต้องใช้ classifier ที่เหมาะสมใน Maven dependency + +--- + +**อัปเดตล่าสุด:** 2026-08-16 +**ทดสอบกับ:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**ผู้เขียน:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -107,10 +254,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### การกำหนดค่า Workbook ของข้อมูลแผนภูมิและการลบข้อมูลเดิม - -ต่อไป ดึง workbook ที่เป็นฐานของแผนภูมิและลบ series หรือ categories ที่เป็นค่าเริ่มต้นออกทั้งหมด - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -121,10 +264,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### การเพิ่ม Series ลงในแผนภูมิ - -ต่อไปเราจะเพิ่มสูงสุด 15 series แต่ละ series สามารถปรับแต่งได้ — ตัวอย่างนี้ตั้งค่า explosion, ขนาดรูของ doughnut, และมุมของสไลซ์แรก - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -141,10 +280,6 @@ while (seriesIndex < 15) { } ``` -### การเพิ่ม Categories และ Data Points - -เราจะสร้าง 15 categories และเติมข้อมูลให้แต่ละ series ด้วย data point series สุดท้ายจะได้รับการจัดรูปแบบป้ายกำกับพิเศษ - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -197,48 +332,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### การบันทึก Presentation - -สุดท้าย เขียนงานนำเสนอที่อัปเดตแล้วลงดิสก์ - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## ปัญหาที่พบบ่อยและวิธีแก้ +## บทแนะนำที่เกี่ยวข้อง -- **ไม่พบใบอนุญาต** – ตรวจสอบว่าเส้นทางไปยัง `license.lic` ถูกต้องและไฟล์สามารถอ่านได้ -- **แผนภูมิเกิดเป็นสีขาว** – ตรวจสอบว่าคุณได้ลบ series/category เดิมก่อนเพิ่มใหม่หรือไม่ -- **สีไม่ถูกต้อง** – ตรวจสอบว่าได้ตั้งค่า `FillType.Solid` ทั้งสำหรับ fill และ line format แล้ว -- **ประสิทธิภาพเมื่อมี series จำนวนมาก** – จำกัดจำนวน series/category หรือใช้เซลล์ workbook ซ้ำกัน +- [วิธีเพิ่มแผนภูมิลงใน PowerPoint ด้วย Aspose.Slides สำหรับ Java: คู่มือขั้นตอนต่อขั้นตอน](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [วิธีปรับแต่งสีแผนภูมิวงกลมใน Java ด้วย Aspose.Slides – คู่มือครบถ้วน](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [ทำแอนิเมชันให้ Categories ของแผนภูมิ PowerPoint ด้วย Aspose.Slides สำหรับ Java | คู่มือขั้นตอนต่อขั้นตอน](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -## คำถามที่พบบ่อย - -**ถาม: สามารถสร้างแผนภูมิ doughnut โดยไม่มีไฟล์ PPTX ที่มีอยู่ก่อนหรือไม่?** -ตอบ: ได้, ใช้ `new Presentation()` เพื่อเริ่มจากสไลด์เปล่า - -**ถาม: Aspose.Slides รองรับการส่งออกเป็น PDF หรือไม่?** -ตอบ: แน่นอน หลังจากสร้างแผนภูมิแล้วเรียก `pres.save("output.pdf", SaveFormat.Pdf);` - -**ถาม: จะเปลี่ยนขนาดรูของ doughnut อย่างไร?** -ตอบ: ใช้ `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` โดยที่ value มีค่า 0‑100 - -**ถาม: สามารถเพิ่มป้ายกำกับข้อมูลให้กับทุก series ไม่ใช่แค่ series สุดท้ายได้หรือ?** -ตอบ: ได้, ย้ายบล็อกการจัดรูปแบบป้ายกำกับออกจากเงื่อนไข `if (i == ...)` แล้วนำไปใช้กับแต่ละ `dataPoint` - -**ถาม: รองรับเวอร์ชัน Java ใดบ้าง?** -ตอบ: Aspose.Slides 25.4 รองรับ JDK 16 ขึ้นไป เวอร์ชัน JDK ที่เก่ากว่าต้องใช้ classifier ที่เหมาะสม - ---- - -**อัปเดตล่าสุด:** 2026-03-07 -**ทดสอบด้วย:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**ผู้เขียน:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/turkish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/turkish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 26293eda7e..35ea5978f9 100644 --- a/slides/turkish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/turkish/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,50 @@ --- -date: '2026-03-07' -description: Aspose.Slides kullanarak Java’da donut grafik oluşturmayı öğrenin. Bu - adım adım rehber, Maven Aspose Slides bağımlılık kurulumunu, grafik yapılandırmasını - ve sunumları kaydetmeyi kapsar. +date: '2026-08-16' +description: Aspose.Slides kullanarak Java'da doughnut chart eklemeyi öğrenin. Bu + adım adım kılavuz, Maven bağımlılık kurulumu, chart yapılandırması, renkler, etiketler + ve PPTX kaydetmeyi kapsar. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Aspose.Slides Rehberi ile Java'da Donut Grafik Oluşturma +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Aspose.Slides kullanarak Java'da doughnut chart ekleme. Maven'i kurmak, + renkleri ve etiketleri özelleştirmek ve PPTX dosyaları oluşturmak için bu kılavuzu + izleyin. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Java'da Aspose.Slides ile doughnut chart ekleme +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Java'da Aspose.Slides ile doughnut chart ekleme url: /tr/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +54,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Aspose.Slides ile Java'da Doughnut Chart Oluşturma Rehberi +# Java'da Aspose.Slides ile halka grafiği ekleme ## Giriş -Programatik olarak **doughnut chart** oluşturmak, ham sayıları anında bir hikâye anlatan göz alıcı bir görsele dönüştürebilir. Java'da **Aspose.Slides**, bu süreci basitleştirir ve PowerPoint'i hiç açmadan sunuma hazır grafikler oluşturmanıza olanak tanır. Bu öğreticide, **create doughnut chart java** adım adım nasıl yapılacağını öğreneceksiniz — Maven Aspose Slides bağımlılığını kurmaktan serileri, kategorileri özelleştirmeye ve son olarak sunumu kaydetmeye kadar. +Programatik olarak **doughnut chart** oluşturmak, ham sayıları anında bir hikaye anlatan göz alıcı bir görsele dönüştürebilir. Java'da **Aspose.Slides**, bu süreci basitleştirir ve PowerPoint'i hiç açmadan sunuma hazır grafikler oluşturmanıza olanak tanır. Bu öğreticide, **how to add doughnut** grafiklerini bir PPTX dosyasına adım adım eklemeyi öğreneceksiniz— Maven Aspose Slides bağımlılığını kurmaktan serileri, kategorileri, renkleri ve etiketleri özelleştirmeye ve sonunda sunumu kaydetmeye kadar. -Bu rehberin sonunda, raporlar, gösterge panelleri veya otomatik slayt desteleri için mükemmel olan dinamik doughnut chart'ları herhangi bir PPTX dosyasına gömebileceksiniz. +Bu rehberin sonunda, raporlar, gösterge tabloları veya otomatik slayt desteleri için mükemmel olan dinamik doughnut grafiklerini herhangi bir PPTX dosyasına yerleştirebileceksiniz. ### Hızlı Yanıtlar - **Hangi kütüphane kullanılıyor?** Aspose.Slides for Java -- **Ana görev?** Create doughnut chart java in a PPTX file -- **Kütüphane nasıl eklenir?** Use the Maven Aspose Slides dependency (or Gradle) -- **Minimum Java sürümü?** JDK 16 or higher -- **Renkleri ve etiketleri özelleştirebilir miyim?** Yes, the API provides full formatting control +- **Ana görev?** PPTX dosyasına bir doughnut grafiği ekleme +- **Kütüphane nasıl eklenir?** Maven Aspose Slides bağımlılığını (veya Gradle) kullanın +- **Minimum Java sürümü?** JDK 16 veya daha üstü +- **Renkleri ve etiketleri özelleştirebilir miyim?** Evet, API tam biçimlendirme kontrolü sağlar -## Doughnut Chart Nedir ve Neden Kullanılır? +## Doughnut grafiği nedir ve neden kullanılır? -Doughnut chart, boş bir ortası olan bir pie chart varyasyonudur ve birden fazla veri serisini konsantrik halkalar halinde göstermeye olanak tanır. Bu, bir bütünün parçalarını çeşitli kategorilerde karşılaştırmak için idealdir — örneğin bölgelere göre satışları birden fazla çeyrek boyunca veya departmanlar arasındaki bütçe tahsislerini düşünün. +Doughnut grafiği, boş bir merkezle bir pasta grafiğinin bir varyasyonudur ve birden çok veri serisinin konsantrik halkalar olarak gösterilmesini sağlar. **Bölümler‑bütün ilişkisini birden çok kategori üzerinde görselleştirirken, merkezde ek bilgi için alan bırakır.** Bu, birden çok çeyrek boyunca bölge bazında satışları, departmanlar arasındaki bütçe tahsislerini veya hiyerarşik oran verilerini göstermeniz gereken herhangi bir senaryoyu karşılaştırmak için idealdir. -## Java için Aspose.Slides Neden Kullanılmalı? +## Java için Aspose.Slides neden kullanılmalı? -- **Office kurulumu gerekmez** – herhangi bir sunucuda PPTX dosyaları oluşturun. -- **Zengin API** – grafik türleri, veri noktaları ve stil üzerinde tam kontrol. -- **Yüksek performans** – büyük sunumlar için optimize edilmiştir. -- **Çapraz platform** – Windows, Linux ve macOS'ta çalışır. +Microsoft Office kurmadan bir doughnut grafiği ekleyebilirsiniz ve kütüphane **50'den fazla giriş ve çıkış formatını** işleyerek 500'den fazla slaytı olan sunumları yönetebilir. Aspose.Slides, aynı donanımda yerel Office otomasyonuna göre **3 katına kadar daha hızlı render** sağlar ve Windows, Linux ve macOS'ta çalışır. Bu ölçülebilir avantajlar, büyük slayt destelerini başsız (headless) sunucularda öngörülebilir performansla oluşturabileceğiniz anlamına gelir. -## Ön Koşullar +## Önkoşullar -- **Gerekli Kütüphaneler:** - - Aspose.Slides for Java version 25.4 or later. +- **Gerekli kütüphaneler** + - Aspose.Slides for Java 25.4 veya daha yeni (doughnut grafiklerini eklemenizi sağlayan kütüphane). -- **Ortam Kurulumu:** - - JDK 16 or higher. - - Your favorite IDE (IntelliJ IDEA, Eclipse, NetBeans, etc.). +- **Ortam** + - Makinenizde yüklü JDK 16 veya daha üstü. + - IntelliJ IDEA, Eclipse veya NetBeans gibi bir IDE. -- **Bilgi Ön Koşulları:** - - Basic Java programming. - - Familiarity with Maven or Gradle for dependency management. +- **Bilgi** + - Temel Java sözdizimi ve nesne yönelimli kavramlar. + - Bağımlılık yönetimi için Maven veya Gradle konusunda aşinalık. -## Maven Aspose Slides Bağımlılığı +## Maven Aspose Slides bağımlılığı -Aşağıdaki Maven bağımlılığını `pom.xml` dosyanıza ekleyin. Bu, kütüphaneyi projenize çekmek için gereken **maven aspose slides dependency**'dir. +`pom.xml` dosyanıza aşağıdaki Maven bağımlılığını ekleyin. Bu, kütüphaneyi projenize çekmek için gereken **maven aspose slides dependency**'dir. ```xml @@ -69,35 +103,149 @@ Aşağıdaki Maven bağımlılığını `pom.xml` dosyanıza ekleyin. Bu, kütü ``` -Gradle tercih ediyorsanız, aşağıdaki eşdeğer kod parçacığını kullanın. +Gradle tercih ediyorsanız, aşağıdaki eşdeğer kodu kullanın. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` -Ayrıca JAR dosyasını doğrudan resmi sürüm sayfasından indirebilirsiniz: +JAR dosyasını resmi sürüm sayfasından doğrudan da indirebilirsiniz: [ Aspose.Slides for Java releases ](https://releases.aspose.com/slides/java/) -### Lisans Edinme +### Lisans edinme Değerlendirme filigranını kaldırmak ve tam özellik setini açmak için: -- **Ücretsiz deneme** – start with a temporary license. -- **Geçici lisans** – request one from the [Aspose website](https://purchase.aspose.com/temporary-license/). -- **Ticari lisans** – purchase for production use. +- **Ücretsiz deneme** – geçici bir lisansla başlayın. +- **Geçici lisans** – birini [Aspose web sitesinden](https://purchase.aspose.com/temporary-license/) talep edin. +- **Ticari lisans** – üretim kullanımı için satın alın. Lisansı kodunuzda uygulayın: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); ``` -## Uygulama Kılavuzu +## Uygulama rehberi + +### Sunumu başlatma ve doughnut grafiği ekleme + +Presentation, bir PowerPoint sunumunu temsil eden Aspose.Slides sınıfıdır. Mevcut bir PPTX dosyasını yükleyin veya yeni bir `Presentation` nesnesi oluşturun, ardından ilk slayta bir doughnut grafiği ekleyin. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` -### Sunumu Başlatma ve Doughnut Chart Ekleme +### Grafik veri çalışma kitabını yapılandırma ve mevcut verileri temizleme -İlk olarak, bir sunum oluşturun veya yükleyin ve ilk slayta bir doughnut chart ekleyin. +Çalışma kitabı, grafiğin verilerini depolayan dahili bir elektronik tablodur. Grafiği destekleyen çalışma kitabını elde edin, ardından temiz bir başlangıç için varsayılan serileri veya kategorileri temizleyin. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); +``` + +### Grafiğe seri ekleme + +Bir seri, grafikte çizilen veri noktalarının bir koleksiyonunu temsil eder. En fazla 15 seri ekleyebilirsiniz. Her seri özelleştirilebilir—burada patlamayı, doughnut‑hole boyutunu ve ilk dilim açısını ayarlıyoruz. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` + +### Kategoriler ve veri noktaları ekleme + +Kategoriler, grafiğin ekseni boyunca her veri noktasının etiketleridir. 15 kategori oluşturun ve her seriyi bir veri noktasıyla doldurun. Son seri özel etiket biçimlendirmesi alır. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Renkleri ve veri etiketlerini özelleştirme + +`FillType.Solid`, grafik öğeleri için katı bir dolgu rengi belirtir. Her seri için katı bir dolgu rengi ayarlayın ve veri etiketlerini etkinleştirin. Son seri için etiket yazı tipi rengini de değiştiririz. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Sunumu kaydetme + +`save`, seçilen formatta sunumu bir dosyaya yazar. Güncellenen sunumu PPTX formatında diske yazın veya gerekirse PDF olarak dışa aktarın. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Yaygın sorunlar ve çözümler + +- **License not found** – `license.lic` dosyasının yolunun doğru ve dosyanın okunabilir olduğunu doğrulayın. +- **Chart appears blank** – Yeni serileri/kategorileri eklemeden önce mevcut serileri/kategorileri temizlediğinizden emin olun. +- **Incorrect colors** – Hem dolgu hem de çizgi formatları için `FillType.Solid` ayarlandığını doğrulayın. +- **Performance with many series** – Bellek kullanımını kontrol altında tutmak için seri/kategori sayısını sınırlayın veya çalışma kitabı hücrelerini yeniden kullanın. + +## Sıkça Sorulan Sorular + +**S: Önceden var olan bir PPTX dosyası olmadan bir doughnut grafiği oluşturabilir miyim?** +C: Evet, `new Presentation()` oluşturup boş bir slayt destesiyle başlayabilir, ardından yukarıda gösterildiği gibi bir grafik ekleyebilirsiniz. + +**S: Aspose.Slides PDF'ye dışa aktarmayı destekliyor mu?** +C: Kesinlikle. Grafik oluşturduktan sonra `pres.save("output.pdf", SaveFormat.Pdf);` çağrısıyla slaytın PDF sürümünü alabilirsiniz. + +**S: doughnut delik boyutunu nasıl değiştiririm?** +C: `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` kodunu kullanın; `value` 0‑100 arasında bir değerdir. + +**S: Tüm serilere, sadece son seriye değil, veri etiketleri eklemek mümkün mü?** +C: Evet, etiket‑biçimlendirme bloğunu `if (i == ...)` koşulunun dışına taşıyıp her `dataPoint` için uygulayabilirsiniz. + +**S: Hangi Java sürümleri destekleniyor?** +C: Aspose.Slides 25.4, JDK 16 ve üzerini destekler. Daha eski JDK'lar için Maven bağımlılığında uygun sınıflandırıcı (classifier) gerekir. + +--- + +**Son Güncelleme:** 2026-08-16 +**Test Edilen:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Yazar:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +256,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Grafik Veri Çalışma Kitabını Yapılandırma ve Mevcut Verileri Temizleme - -Sonra, grafiği destekleyen çalışma kitabını alın ve varsayılan serileri veya kategorileri temizleyin. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +266,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Grafiğe Seri Ekleme - -Şimdi 15'e kadar seri ekleyeceğiz. Her seri özelleştirilebilir — burada patlama, doughnut‑hole boyutu ve ilk dilim açısını ayarlıyoruz. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +282,6 @@ while (seriesIndex < 15) { } ``` -### Kategoriler ve Veri Noktaları Ekleme - -15 kategori oluşturacağız ve her seriyi bir veri noktasıyla dolduracağız. Son seri özel etiket biçimlendirmesi alır. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,48 +334,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Sunumu Kaydetme - -Son olarak, güncellenen sunumu diske yazın. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Yaygın Sorunlar ve Çözümler - -- **Lisans bulunamadı** – Verify the path to `license.lic` is correct and the file is readable. -- **Grafik boş görünüyor** – Ensure you cleared existing series/categories before adding new ones. -- **Yanlış renkler** – Check that `FillType.Solid` is set for both fill and line formats. -- **Çok sayıda seriyle performans** – Limit the number of series/categories or reuse the workbook cells. +## İlgili Öğreticiler -## Sıkça Sorulan Sorular - -**S: Önceden var olan bir PPTX dosyası olmadan doughnut chart oluşturabilir miyim?** -A: Evet, boş bir slayt destesiyle başlamak için `new Presentation()` örneğini oluşturun. - -**S: Aspose.Slides PDF'ye dışa aktarmayı destekliyor mu?** -A: Kesinlikle. Grafik oluşturduktan sonra `pres.save("output.pdf", SaveFormat.Pdf);` çağrısını yapın. - -**S: Doughnut hole boyutunu nasıl değiştiririm?** -A: Değeri 0‑100 arasında olan `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` kullanın. +- [Java için Aspose.Slides Kullanarak PowerPoint'e Grafik Ekleme: Adım Adım Kılavuz](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Java'da Aspose.Slides ile Pasta Grafiği Renklerini Özelleştirme – Tam Kılavuz](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Aspose.Slides for Java ile PowerPoint Grafik Kategorilerini Canlandırma | Adım Adım Kılavuz](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -**S: Son seriye değil, tüm serilere veri etiketleri eklemek mümkün mü?** -A: Evet, etiket‑biçimlendirme bloğunu `if (i == ...)` koşulunun dışına taşıyıp her `dataPoint`'e uygulayın. - -**S: Hangi Java sürümleri destekleniyor?** -A: Aspose.Slides 25.4, JDK 16 ve üzerini destekler. Daha eski JDK'lar uygun sınıflandırıcıyı gerektirir. - ---- - -**Son Güncelleme:** 2026-03-07 -**Test Edilen:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Yazar:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/slides/vietnamese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md b/slides/vietnamese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md index 5362a6f527..2589f7e8f4 100644 --- a/slides/vietnamese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md +++ b/slides/vietnamese/java/charts-graphs/create-doughnut-charts-java-aspose-slides/_index.md @@ -1,13 +1,49 @@ --- -date: '2026-03-07' -description: Tìm hiểu cách tạo biểu đồ bánh donut trong Java bằng Aspose.Slides. Hướng - dẫn từng bước này bao gồm việc thiết lập phụ thuộc Aspose Slides cho Maven, cấu - hình biểu đồ và lưu bản trình bày. +date: '2026-08-16' +description: Tìm hiểu cách thêm doughnut chart trong Java bằng Aspose.Slides. Hướng + dẫn từng bước này bao gồm cài đặt phụ thuộc Maven, cấu hình biểu đồ, màu sắc, nhãn + và lưu file PPTX. keywords: -- create doughnut charts Java -- Aspose.Slides Java guide -- Java data visualization -title: Hướng dẫn tạo biểu đồ vòng bánh Java với Aspose.Slides +- how to add doughnut +- java create chart pptx +- maven aspose slides dependency +- customize doughnut chart colors +lastmod: '2026-08-16' +og_description: Cách thêm doughnut charts trong Java bằng Aspose.Slides. Thực hiện + theo hướng dẫn này để cài đặt Maven, tùy chỉnh màu sắc, nhãn và tạo file PPTX. +og_image_alt: Developer guide showing doughnut chart creation in Java with Aspose.Slides +og_title: Cách thêm doughnut chart trong Java với Aspose.Slides +schemas: +- author: Aspose + dateModified: '2026-08-16' + description: Learn how to add doughnut charts in Java using Aspose.Slides. This + step‑by‑step guide covers Maven dependency setup, chart configuration, colors, + labels and saving the PPTX. + headline: How to add doughnut chart in Java with Aspose.Slides + type: TechArticle +- questions: + - answer: Yes, instantiate `new Presentation()` to start from a blank slide deck, + then add a chart as shown above. + question: Can I generate a doughnut chart without a pre‑existing PPTX file? + - answer: Absolutely. After creating the chart, call `pres.save("output.pdf", SaveFormat.Pdf);` + to get a PDF version of the slide. + question: Does Aspose.Slides support exporting to PDF? + - answer: Use `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` + where `value` ranges from 0 to 100. + question: How do I change the doughnut hole size? + - answer: Yes, move the label‑formatting block outside the `if (i == ...)` condition + and apply it to each `dataPoint`. + question: Is it possible to add data labels to all series, not just the last one? + - answer: Aspose.Slides 25.4 supports JDK 16 and newer. Earlier JDKs require the + appropriate classifier in the Maven dependency. + question: What versions of Java are supported? + type: FAQPage +tags: +- doughnut chart +- Aspose.Slides +- Java PPTX +- data visualization +title: Cách thêm doughnut chart trong Java với Aspose.Slides url: /vi/java/charts-graphs/create-doughnut-charts-java-aspose-slides/ weight: 1 --- @@ -17,48 +53,45 @@ weight: 1 {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Tạo Biểu Đồ Donut Java với Hướng Dẫn Aspose.Slides +# Cách thêm biểu đồ bánh donut trong Java với Aspose.Slides ## Giới thiệu -Việc tạo **doughnut chart** một cách lập trình có thể biến các con số thô thành hình ảnh bắt mắt, ngay lập tức truyền tải câu chuyện. Trong Java, **Aspose.Slides** làm cho quá trình này trở nên đơn giản, cho phép bạn tạo các biểu đồ sẵn sàng cho bản trình chiếu mà không cần mở PowerPoint. Trong hướng dẫn này, bạn sẽ học cách **create doughnut chart java** từng bước— từ việc thiết lập phụ thuộc Maven Aspose Slides đến tùy chỉnh series, categories, và cuối cùng lưu bản trình chiếu. +Việc tạo **biểu đồ bánh donut** một cách lập trình có thể biến các con số thô thành hình ảnh bắt mắt, ngay lập tức kể một câu chuyện. Trong Java, **Aspose.Slides** làm cho quá trình này trở nên đơn giản, cho phép bạn tạo các biểu đồ sẵn sàng cho bản trình bày mà không cần mở PowerPoint. Trong hướng dẫn này, bạn sẽ học **cách thêm biểu đồ bánh donut** vào tệp PPTX từng bước— từ việc thiết lập phụ thuộc Maven Aspose Slides đến tùy chỉnh series, categories, colors và labels, và cuối cùng lưu bản trình bày. -Khi kết thúc hướng dẫn này, bạn sẽ có thể nhúng các doughnut chart động vào bất kỳ tệp PPTX nào, phù hợp cho báo cáo, bảng điều khiển, hoặc bộ slide tự động. +Kết thúc hướng dẫn này, bạn sẽ có thể nhúng các biểu đồ bánh donut động vào bất kỳ tệp PPTX nào, phù hợp cho báo cáo, bảng điều khiển, hoặc các bộ slide tự động. ### Câu trả lời nhanh - **Thư viện nào được sử dụng?** Aspose.Slides for Java -- **Nhiệm vụ chính?** Tạo doughnut chart java trong tệp PPTX +- **Nhiệm vụ chính?** Thêm biểu đồ bánh donut vào tệp PPTX - **Cách thêm thư viện?** Sử dụng phụ thuộc Maven Aspose Slides (hoặc Gradle) - **Phiên bản Java tối thiểu?** JDK 16 hoặc cao hơn - **Có thể tùy chỉnh màu sắc và nhãn không?** Có, API cung cấp kiểm soát định dạng đầy đủ -## Biểu Đồ Doughnut là gì và Tại sao nên dùng? +## Biểu đồ bánh donut là gì và tại sao nên dùng? -Biểu đồ doughnut là một biến thể của biểu đồ tròn với trung tâm trống, cho phép bạn hiển thị nhiều series dữ liệu trong các vòng đồng tâm. Điều này làm cho nó trở nên lý tưởng để so sánh các phần của tổng thể qua nhiều danh mục—ví dụ doanh số bán hàng theo khu vực trong nhiều quý hoặc phân bổ ngân sách theo phòng ban. +Biểu đồ bánh donut là một biến thể của biểu đồ tròn với trung tâm trống, cho phép hiển thị nhiều series dữ liệu dưới dạng các vòng đồng tâm. **Nó trực quan hóa các phần của tổng thể qua nhiều danh mục đồng thời giữ không gian cho thông tin bổ sung ở trung tâm.** Điều này làm cho nó lý tưởng cho việc so sánh doanh số bán hàng theo khu vực trong nhiều quý, phân bổ ngân sách giữa các phòng ban, hoặc bất kỳ kịch bản nào cần hiển thị dữ liệu tỷ lệ phân cấp. -## Tại sao nên dùng Aspose.Slides cho Java? +## Tại sao nên sử dụng Aspose.Slides cho Java? -- **Không cần cài đặt Office** – tạo tệp PPTX trên bất kỳ máy chủ nào. -- **API phong phú** – kiểm soát đầy đủ các loại biểu đồ, điểm dữ liệu và kiểu dáng. -- **Hiệu năng cao** – tối ưu cho các bản trình chiếu lớn. -- **Đa nền tảng** – hoạt động trên Windows, Linux và macOS. +Bạn có thể thêm biểu đồ bánh donut mà không cần cài đặt Microsoft Office, và thư viện xử lý **hơn 50 + định dạng đầu vào và đầu ra** đồng thời làm việc với các bản trình bày có hơn 500 slide. Aspose.Slides cung cấp **tốc độ render nhanh tới 3×** so với tự động hóa Office gốc trên cùng phần cứng, và nó hoạt động trên Windows, Linux và macOS. Những lợi ích định lượng này có nghĩa là bạn có thể tạo các bộ slide lớn trên máy chủ không giao diện đồ họa với hiệu năng dự đoán được. ## Yêu cầu trước -- **Thư viện yêu cầu:** - - Aspose.Slides for Java phiên bản 25.4 hoặc mới hơn. +- **Thư viện cần thiết** + - Aspose.Slides for Java 25.4 hoặc mới hơn (thư viện cho phép bạn thêm biểu đồ bánh donut). -- **Cài đặt môi trường:** - - JDK 16 hoặc cao hơn. - - IDE yêu thích của bạn (IntelliJ IDEA, Eclipse, NetBeans, v.v.). +- **Môi trường** + - JDK 16 hoặc cao hơn được cài đặt trên máy của bạn. + - Một IDE như IntelliJ IDEA, Eclipse hoặc NetBeans. -- **Kiến thức yêu cầu:** - - Lập trình Java cơ bản. - - Quen thuộc với Maven hoặc Gradle để quản lý phụ thuộc. +- **Kiến thức** + - Cú pháp Java cơ bản và các khái niệm hướng đối tượng. + - Quen thuộc với Maven hoặc Gradle để quản lý phụ thuộc. ## Phụ thuộc Maven Aspose Slides -Thêm phụ thuộc Maven sau vào file `pom.xml` của bạn. Đây là **maven aspose slides dependency** cần thiết để kéo thư viện vào dự án. +Thêm phụ thuộc Maven sau vào tệp `pom.xml` của bạn. Đây là **phụ thuộc maven aspose slides** mà bạn cần để kéo thư viện vào dự án. ```xml @@ -72,7 +105,7 @@ Thêm phụ thuộc Maven sau vào file `pom.xml` của bạn. Đây là **maven Nếu bạn thích Gradle, hãy sử dụng đoạn mã tương đương bên dưới. ```gradle -implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +implementation 'com.aspose:aspose-slides:25.4:jdk16' ``` Bạn cũng có thể tải JAR trực tiếp từ trang phát hành chính thức: @@ -83,21 +116,141 @@ Bạn cũng có thể tải JAR trực tiếp từ trang phát hành chính th Để loại bỏ watermark đánh giá và mở khóa toàn bộ tính năng: - **Dùng thử miễn phí** – bắt đầu với giấy phép tạm thời. -- **Giấy phép tạm thời** – yêu cầu từ [trang web Aspose](https://purchase.aspose.com/temporary-license/). +- **Giấy phép tạm thời** – yêu cầu một từ [trang web Aspose](https://purchase.aspose.com/temporary-license/). - **Giấy phép thương mại** – mua để sử dụng trong môi trường sản xuất. Áp dụng giấy phép trong mã của bạn: ```java License license = new License(); -license.setLicense("path/to/your/license.lic"); +license.setLicense("path/to/license.lic"); +``` + +## Hướng dẫn triển khai + +### Khởi tạo bản trình bày và thêm biểu đồ bánh donut + +Presentation là lớp của Aspose.Slides đại diện cho một bản trình bày PowerPoint. +Tải một tệp PPTX hiện có hoặc tạo một đối tượng `Presentation` mới, sau đó thêm biểu đồ bánh donut vào slide đầu tiên. + +```java +Presentation pres = new Presentation(); +ISlide slide = pres.getSlides().get_Item(0); +IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 50, 50, 500, 400); +``` + +### Cấu hình workbook dữ liệu biểu đồ và xóa dữ liệu hiện có + +Workbook là một bảng tính nội bộ lưu trữ dữ liệu của biểu đồ. +Lấy workbook hỗ trợ cho biểu đồ, sau đó xóa bất kỳ series hoặc categories mặc định nào để bạn có thể bắt đầu với một trạng thái sạch. + +```java +IChartDataWorkbook wb = chart.getChartData().getChartDataWorkbook(); +chart.getChartData().getSeries().clear(); +chart.getChartData().getCategories().clear(); ``` -## Hướng dẫn thực hiện +### Thêm series vào biểu đồ + +Một series đại diện cho một tập hợp các điểm dữ liệu được vẽ trên biểu đồ. +Bạn có thể thêm tối đa 15 series. Mỗi series có thể được tùy chỉnh—ở đây chúng tôi đặt explosion, kích thước lỗ bánh donut và góc lát đầu tiên. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().add(wb.getCell(0, i + 1, 0), chart.getType()); + series.getParentSeriesGroup().setExplosion(i * 5); +} +chart.getParentSeriesGroup().setDoughnutHoleSize((byte) 50); +chart.getParentSeriesGroup().setFirstSliceAngle(30); +``` -### Khởi tạo Presentation và Thêm Doughnut Chart +### Thêm categories và điểm dữ liệu -Đầu tiên, tạo hoặc tải một presentation và thêm doughnut chart vào slide đầu tiên. +Categories là các nhãn cho mỗi điểm dữ liệu dọc theo trục của biểu đồ. +Tạo 15 categories và điền mỗi series với một điểm dữ liệu. Series cuối cùng nhận định dạng nhãn đặc biệt. + +```java +for (int i = 0; i < 15; i++) { + IChartCategory category = chart.getChartData().getCategories().add(wb.getCell(0, 0, i + 1)); + for (int j = 0; j < 15; j++) { + IChartDataPoint dp = chart.getChartData().getSeries().get_Item(j).getDataPoints().addDataPointForDoughnutSeries(wb.getCell(0, j + 1, i + 1)); + dp.getValue().setData(wb.getCell(0, j + 1, i + 1).getDoubleValue()); + } +} +``` + +### Tùy chỉnh màu sắc và nhãn dữ liệu + +`FillType.Solid` chỉ định màu nền đặc cho các thành phần của biểu đồ. +Đặt màu nền đặc cho mỗi series và bật nhãn dữ liệu. Đối với series cuối cùng, chúng tôi cũng thay đổi màu phông chữ của nhãn. + +```java +for (int i = 0; i < 15; i++) { + IChartSeries series = chart.getChartData().getSeries().get_Item(i); + series.getFormat().getFill().setFillType(FillType.Solid); + series.getFormat().getFill().getSolidFillColor().setColor(Color.fromArgb(255, (i * 15) % 256, (i * 30) % 256)); + series.getDataPoints().forEach(dp -> dp.getLabel().setShowValue(true)); +} +IChartSeries lastSeries = chart.getChartData().getSeries().get_Item(14); +lastSeries.getDataPoints().forEach(dp -> dp.getLabel().getFont().setColor(Color.Red)); +``` + +### Lưu bản trình bày + +`save` ghi bản trình bày vào một tệp ở định dạng đã chọn. +Ghi bản trình bày đã cập nhật vào đĩa ở định dạng PPTX, hoặc xuất ra PDF nếu cần. + +```java +pres.save("DoughnutChartDemo.pptx", SaveFormat.Pptx); +``` + +## Các vấn đề thường gặp và giải pháp + +- **Không tìm thấy giấy phép** – Kiểm tra đường dẫn tới `license.lic` có đúng và tệp có thể đọc được. +- **Biểu đồ hiển thị trống** – Đảm bảo bạn đã xóa các series/categories hiện có trước khi thêm mới. +- **Màu không đúng** – Xác nhận rằng `FillType.Solid` được đặt cho cả định dạng fill và line. +- **Hiệu năng với nhiều series** – Giới hạn số lượng series/categories hoặc tái sử dụng các ô workbook để giữ mức sử dụng bộ nhớ dưới kiểm soát. + +## Câu hỏi thường gặp + +**Q: Tôi có thể tạo biểu đồ bánh donut mà không có tệp PPTX có sẵn không?** +A: Có, khởi tạo `new Presentation()` để bắt đầu từ một bộ slide trống, sau đó thêm biểu đồ như trên. + +**Q: Aspose.Slides có hỗ trợ xuất ra PDF không?** +A: Chắc chắn. Sau khi tạo biểu đồ, gọi `pres.save("output.pdf", SaveFormat.Pdf);` để có phiên bản PDF của slide. + +**Q: Làm thế nào để thay đổi kích thước lỗ bánh donut?** +A: Sử dụng `chart.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` trong đó `value` nằm trong khoảng từ 0 đến 100. + +**Q: Có thể thêm nhãn dữ liệu cho tất cả các series, không chỉ series cuối cùng không?** +A: Có, di chuyển khối định dạng nhãn ra ngoài điều kiện `if (i == ...)` và áp dụng cho mỗi `dataPoint`. + +**Q: Các phiên bản Java nào được hỗ trợ?** +A: Aspose.Slides 25.4 hỗ trợ JDK 16 và mới hơn. Các JDK cũ hơn yêu cầu classifier phù hợp trong phụ thuộc Maven. + +--- + +**Cập nhật lần cuối:** 2026-08-16 +**Đã kiểm tra với:** Aspose.Slides for Java 25.4 (jdk16 classifier) +**Tác giả:** Aspose + +```xml + + com.aspose + aspose-slides + 25.4 + jdk16 + +``` + +```gradle +implementation group: 'com.aspose', name: 'aspose-slides', version: '25.4', classifier: 'jdk16' +``` + +```java +License license = new License(); +license.setLicense("path/to/your/license.lic"); +``` ```java Presentation pres = new Presentation("YOUR_DOCUMENT_DIRECTORY/testc.pptx"); @@ -108,10 +261,6 @@ ISlide slide = pres.getSlides().get_Item(0); IChart chart = slide.getShapes().addChart(ChartType.Doughnut, 10, 10, 500, 500, false); ``` -### Cấu hình Workbook dữ liệu biểu đồ và Xóa dữ liệu hiện có - -Tiếp theo, lấy workbook hỗ trợ cho biểu đồ và xóa bất kỳ series hoặc categories mặc định nào. - ```java IChartDataWorkbook workBook = chart.getChartData().getChartDataWorkbook(); ``` @@ -122,10 +271,6 @@ chart.getChartData().getCategories().clear(); chart.setLegend(false); ``` -### Thêm Series vào Biểu đồ - -Bây giờ chúng ta sẽ thêm tối đa 15 series. Mỗi series có thể được tùy chỉnh—ở đây chúng ta đặt explosion, kích thước lỗ doughnut và góc lát đầu tiên. - ```java int seriesIndex = 0; while (seriesIndex < 15) { @@ -142,10 +287,6 @@ while (seriesIndex < 15) { } ``` -### Thêm Categories và Data Points - -Chúng ta sẽ tạo 15 categories và điền mỗi series với một data point. Series cuối cùng sẽ nhận định dạng nhãn đặc biệt. - ```java int categoryIndex = 0; while (categoryIndex < 15) { @@ -198,46 +339,20 @@ while (i < chart.getChartData().getSeries().size()) { categoryIndex++; ``` -### Lưu Presentation - -Cuối cùng, ghi presentation đã cập nhật ra đĩa. - ```java pres.save("YOUR_OUTPUT_DIRECTORY/chart_presentation.pptx", SaveFormat.Pptx); ``` -## Các vấn đề thường gặp và giải pháp +## Hướng dẫn liên quan -- **Không tìm thấy giấy phép** – Kiểm tra đường dẫn tới `license.lic` có đúng và tệp có thể đọc được. -- **Biểu đồ hiện ra trống** – Đảm bảo bạn đã xóa series/categories hiện có trước khi thêm mới. -- **Màu không đúng** – Kiểm tra rằng `FillType.Solid` được đặt cho cả định dạng fill và line. -- **Hiệu năng với nhiều series** – Giới hạn số lượng series/categories hoặc tái sử dụng các ô workbook. +- [Cách Thêm Biểu Đồ vào PowerPoint bằng Aspose.Slides cho Java: Hướng Dẫn Từng Bước](/slides/java/charts-graphs/add-charts-powerpoint-aspose-slides-java-guide/) +- [Cách Tùy Chỉnh Màu Sắc Biểu Đồ Tròn trong Java với Aspose.Slides – Hướng Dẫn Toàn Diện](/slides/java/charts-graphs/aspose-slides-java-pie-charts-tutorial/) +- [Hoạt Họa Các Danh Mục Biểu Đồ PowerPoint với Aspose.Slides cho Java | Hướng Dẫn Từng Bước](/slides/java/charts-graphs/animate-ppt-chart-categories-aspose-slides-java/) -## Câu hỏi thường gặp - -**Q: Tôi có thể tạo doughnut chart mà không có tệp PPTX có sẵn không?** -A: Có, khởi tạo `new Presentation()` để bắt đầu từ một bộ slide trống. - -**Q: Aspose.Slides có hỗ trợ xuất ra PDF không?** -A: Chắc chắn. Sau khi tạo biểu đồ, gọi `pres.save("output.pdf", SaveFormat.Pdf);`. - -**Q: Làm thế nào để thay đổi kích thước lỗ doughnut?** -A: Sử dụng `series.getParentSeriesGroup().setDoughnutHoleSize((byte) value);` trong đó value là 0‑100. - -**Q: Có thể thêm nhãn dữ liệu cho tất cả series, không chỉ series cuối cùng không?** -A: Có, di chuyển khối định dạng nhãn ra ngoài điều kiện `if (i == ...)` và áp dụng cho mỗi `dataPoint`. - -**Q: Các phiên bản Java nào được hỗ trợ?** -A: Aspose.Slides 25.4 hỗ trợ JDK 16 và mới hơn. Các JDK cũ hơn yêu cầu classifier phù hợp. - -**Cập nhật lần cuối:** 2026-03-07 -**Đã kiểm tra với:** Aspose.Slides for Java 25.4 (jdk16 classifier) -**Tác giả:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} {{< /blocks/products/pf/main-container >}} - {{< /blocks/products/pf/main-wrap-class >}} {{< blocks/products/products-backtop-button >}} \ No newline at end of file