diff --git a/words/arabic/java/document-conversion-and-export/using-charts/_index.md b/words/arabic/java/document-conversion-and-export/using-charts/_index.md index 868ee3247..d5fb88540 100644 --- a/words/arabic/java/document-conversion-and-export/using-charts/_index.md +++ b/words/arabic/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,12 @@ --- -"description": "تعرّف على كيفية إنشاء المخططات وتخصيصها في Aspose.Words لجافا. استكشف أنواع المخططات وتنسيقها وخصائص المحاور لتصور البيانات." -"linktitle": "استخدام المخططات البيانية" -"second_title": "واجهة برمجة تطبيقات معالجة مستندات Java Aspose.Words" -"title": "استخدام المخططات البيانية في Aspose.Words للغة Java" -"url": "/ar/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: تعلم كيفية إنشاء مخطط عمودي وتنسيق تسميات بيانات المخطط باستخدام Aspose.Words + for Java. استكشف إضافة سلاسل متعددة، وتغيير نوع المحور، وإخفاء محور المخطط. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: كيفية إنشاء مخطط عمودي باستخدام Aspose.Words للـ Java +url: /ar/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +15,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# استخدام المخططات البيانية في Aspose.Words للغة Java +# كيفية إنشاء مخطط عمودي باستخدام Aspose.Words for Java +في هذا البرنامج التعليمي ستقوم **بإنشاء مخطط عمودي** داخل مستندات Word مباشرةً باستخدام Aspose.Words for Java. سنستعرض إنشاء أنواع مختلفة من المخططات، إضافة سلاسل متعددة، تنسيق تسميات بيانات المخطط، تغيير نوع المحور، وحتى إخفاء محور المخطط عندما تحتاج إلى مظهر أنظف. في النهاية ستحصل على نهج جاهز للإنتاج لتضمين مخططات غنية في مستنداتك. -## مقدمة لاستخدام المخططات البيانية في Aspose.Words للغة Java +## إجابات سريعة +- **ما هو الصنف الأساسي لإنشاء مخطط؟** `DocumentBuilder` مع `insertChart`. +- **أي طريقة تُضيف سلسلة جديدة؟** `chart.getSeries().add(...)`. +- **كيف أقوم بتنسيق تسميات بيانات المخطط؟** استخدم `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **هل يمكنني إخفاء محور؟** نعم، استدعِ `setHidden(true)` على كائن المحور. +- **هل أحتاج إلى ترخيص لـ Aspose.Words؟** الترخيص مطلوب للاستخدام الإنتاجي؛ تتوفر نسخة تجريبية مجانية. -في هذا البرنامج التعليمي، سنستكشف كيفية العمل مع المخططات البيانية باستخدام Aspose.Words لجافا. ستتعلم كيفية إنشاء أنواع مختلفة من المخططات البيانية، وتخصيص خصائص المحاور، وتنسيق تسميات البيانات، والمزيد. هيا بنا! +## ما هو المخطط العمودي ولماذا نستخدمه؟ -## إنشاء مخطط خطي +يعرض المخطط العمودي البيانات الفئوية كأعمدة رأسية، مما يجعله مثالياً لمقارنة القيم عبر المجموعات (المبيعات حسب المنطقة، المصاريف الشهرية، إلخ). في تطبيقات Java، يتيح لك إنشاء مخطط عمودي باستخدام Aspose.Words تضمين هذه الرسوم مباشرةً في ملفات Word / DOCX دون الحاجة إلى Excel أو أدوات خارجية. -لإنشاء مخطط خطي، استخدم الكود التالي: +## كيفية إنشاء مخطط عمودي + +فيما يلي مثال بسيط ينشئ مخططًا عموديًا بسيطًا. الشيفرة مطابقة تمامًا للمقتطف الأصلي – أضفنا فقط تعليقات توضيحية لتسهيل الفهم. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### إضافة سلاسل متعددة + +يمكنك **إضافة سلاسل متعددة** إلى مخطط عمودي عن طريق استدعاء `chart.getSeries().add(...)` بشكل متكرر، كما هو موضح أعلاه. يمكن لكل سلسلة أن تحتوي على مجموعة خاصة من الفئات والقيم، مما يتيح لك مقارنة عدة مجموعات بيانات جنبًا إلى جنب. + +## كيفية إنشاء مخطط خط مع تسميات بيانات مخصصة + +إذا كنت بحاجة إلى مخطط خط بدلاً من المخطط العمودي، فإن النمط نفسه ينطبق. يوضح هذا المثال أيضًا **تنسيق تسميات بيانات المخطط** باستخدام تنسيقات رقمية مختلفة. ```java Document doc = new Document(); @@ -31,10 +66,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// حذف السلسلة المولدة افتراضيًا. +// Delete default generated series. chart.getSeries().clear(); -// إضافة سلسلة تحتوي على بيانات وعناوين بيانات. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +80,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// أو قم بربط كود التنسيق بخلية المصدر. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## إنشاء أنواع أخرى من المخططات البيانية +### إضافة تسميات البيانات -يمكنك إنشاء أنواع مختلفة من المخططات البيانية، مثل المخطط العمودي، والمخطط المساحي، والمخطط الفقاعي، والمخطط المبعثر، وغيرها باستخدام تقنيات مشابهة. إليك مثال على إدراج مخطط بياني عمودي بسيط: +النداء `series1.hasDataLabels(true)` **يضيف تسميات البيانات** إلى السلسلة، بينما يجعل `setShowValue(true)` القيم الفعلية مرئية على المخطط. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// حذف السلسلة المولدة افتراضيًا. -chart.getSeries().clear(); - -// إنشاء الفئات وإضافة البيانات. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` +## كيفية تغيير نوع المحور وتخصيص خصائص المحور -## تخصيص خصائص المحور - -يمكنك تخصيص خصائص المحور، مثل تغيير نوع المحور، وتعيين علامات التجزئة، وتنسيق التسميات، وغيرها. إليك مثال على تعريف خصائص المحور X وY: +تغيير نوع المحور (مثلاً من تاريخ إلى فئة) يتيح لك التحكم في طريقة رسم نقاط البيانات. يوضح هذا المقتطف أيضًا كيفية **إخفاء محور المخطط** إذا كنت تفضل تصميمًا بسيطًا. ```java Document doc = new Document(); @@ -82,20 +100,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// مسح السلسلة الافتراضية وإضافة بياناتك. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// قم بتغيير المحور X ليكون فئة بدلاً من التاريخ. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // يتم قياسها بوحدات العرض على المحور Y (المئات). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +127,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## تنسيق تسميات البيانات +### تغيير نوع المحور + +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **يغير نوع المحور** من محور يعتمد على التاريخ إلى محور فئوي، مما يمنحك السيطرة الكاملة على موضع التسميات. -يمكنك تنسيق تسميات البيانات بتنسيقات أرقام مختلفة. إليك مثال: +## كيفية تنسيق تسميات بيانات المخطط (تنسيقات رقمية) + +يمكنك تطبيق تنسيق رقمي مباشرةً على المحور أو تسميات البيانات. يوضح هذا المثال تنسيق أرقام المحور Y بفاصل آلاف. ```java Document doc = new Document(); @@ -116,7 +141,7 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// مسح السلسلة الافتراضية وإضافة بياناتك. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); @@ -125,41 +150,39 @@ doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ## تخصيصات إضافية للمخطط -يمكنك تخصيص مخططاتك بشكل أكبر عن طريق ضبط الحدود، ووحدات الفواصل بين التسميات، وإخفاء محاور المخطط، والمزيد. استكشف مقتطفات التعليمات البرمجية المُقدمة لمعرفة المزيد عن هذه الخيارات. - -## خاتمة - -في هذا البرنامج التعليمي، استكشفنا كيفية العمل مع المخططات البيانية باستخدام Aspose.Words لجافا. تعلمت كيفية إنشاء أنواع مختلفة من المخططات البيانية، وتخصيص خصائص المحاور، وتنسيق تسميات البيانات، والمزيد. يوفر Aspose.Words لجافا أدوات فعّالة لإضافة تمثيلات بصرية للبيانات إلى مستنداتك، مما يُحسّن طريقة عرض المعلومات. +بعيدًا عن الأساسيات، يمكنك تعديل الحدود، ضبط وحدات الفاصل بين التسميات، إخفاء محاور معينة، والمزيد. راجع وثائق Aspose.Words for Java API للحصول على القائمة الكاملة للخصائص. -## الأسئلة الشائعة +## الأسئلة المتكررة -### كيف يمكنني إضافة سلاسل متعددة إلى الرسم البياني؟ +**س: كيف يمكنني إضافة سلاسل متعددة إلى مخطط؟** +ج: استخدم `chart.getSeries().add()` لكل سلسلة تريد عرضها. يمكن لكل استدعاء توفير اسم فريد، ومصفوفة فئات، ومصفوفة قيم. -يمكنك إضافة سلاسل متعددة إلى مخطط باستخدام `chart.getSeries().add()` الطريقة. تأكد من تحديد اسم السلسلة والفئات وقيم البيانات. +**س: كيف أقوم بتنسيق تسميات بيانات المخطط باستخدام تنسيقات رقمية مخصصة؟** +ج: احصل على كائن `DataLabels` الخاص بالسلسلة واستدعِ `getNumberFormat().setFormatCode("your format")`. يمكنك أيضًا ربط التنسيق بخلية مصدر باستخدام `isLinkedToSource(true)`. -### كيف يمكنني تنسيق تسميات البيانات باستخدام تنسيقات الأرقام المخصصة؟ +**س: كيف يمكنني إخفاء محور المخطط؟** +ج: استدعِ `setHidden(true)` على كائن `ChartAxis` الذي تريد إخفائه (مثال: `chart.getAxisY().setHidden(true)`). -يمكنك تنسيق تسميات البيانات عن طريق الوصول إلى `DataLabels` خصائص السلسلة وتعيين رمز التنسيق المطلوب باستخدام `getNumberFormat().setFormatCode()`. +**س: ما هي الطريقة الأفضل لتغيير نوع المحور؟** +ج: استخدم `setCategoryType(AxisCategoryType.CATEGORY)` للمحاور الفئوية أو `AxisCategoryType.DATE` للمحاور التاريخية. -### كيف أقوم بتخصيص خصائص المحور في الرسم البياني؟ +**س: كيف أضيف تسميات بيانات إلى سلسلة؟** +ج: فعّلها باستخدام `series.hasDataLabels(true)` ثم اضبط الرؤية عبر `series.getDataLabels().setShowValue(true)`. -يمكنك تخصيص خصائص المحور مثل النوع وعلامات التجزئة والعلامات والمزيد عن طريق الوصول إلى `ChartAxis` خصائص مثل `setCategoryType()`، `setCrosses()`، و `setMajorTickMark()`. +## الخلاصة -### كيف يمكنني إنشاء أنواع أخرى من الرسوم البيانية مثل الرسوم البيانية المنتشرة أو الرسوم البيانية المساحية؟ +لقد غطينا كل ما تحتاجه **لإنشاء مخططات عمودية** باستخدام Aspose.Words for Java—من إدراج مخططات أساسية وإضافة سلاسل متعددة، إلى تنسيق تسميات بيانات المخطط، تغيير نوع المحور، وإخفاء محاور المخطط للحصول على مظهر نظيف. دمج هذه التقنيات في خطوط تقاريرك أو عمليات توليد المستندات سيمنحك مستندات Word احترافية مدعومة بالبيانات. -يمكنك إنشاء أنواع مختلفة من المخططات عن طريق تحديد الأنواع المناسبة `ChartType` عند إدخال الرسم البياني باستخدام `builder.insertChart(ChartType.TYPE, width, height)`. - -### كيف يمكنني إخفاء محور الرسم البياني؟ - -يمكنك إخفاء محور الرسم البياني عن طريق ضبط `setHidden(true)` خاصية المحور. +--- +**آخر تحديث:** 2025-12-13 +**تم الاختبار مع:** Aspose.Words for Java 24.12 (الأحدث) +**المؤلف:** 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/words/chinese/java/document-conversion-and-export/using-charts/_index.md b/words/chinese/java/document-conversion-and-export/using-charts/_index.md index 1d13bc2be..0b479b332 100644 --- a/words/chinese/java/document-conversion-and-export/using-charts/_index.md +++ b/words/chinese/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,11 @@ --- -"description": "学习如何在 Aspose.Words for Java 中创建和自定义图表。探索数据可视化的图表类型、格式和轴属性。" -"linktitle": "使用图表" -"second_title": "Aspose.Words Java文档处理API" -"title": "在 Aspose.Words for Java 中使用图表" -"url": "/zh/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: 学习如何使用 Aspose.Words for Java 创建柱形图并格式化图表数据标签。探索添加多个系列、更改坐标轴类型以及隐藏坐标轴。 +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: 如何使用 Aspose.Words for Java 创建柱状图 +url: /zh/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +14,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# 在 Aspose.Words for Java 中使用图表 +# 使用 Aspose.Words for Java 创建柱状图 +在本教程中，您将 **创建柱状图** 可视化，直接嵌入 Word 文档，使用 Aspose.Words for Java。我们将演示如何创建不同类型的图表、添加多个系列、格式化图表数据标签、更改坐标轴类型，甚至在需要更简洁外观时隐藏坐标轴。完成后，您将掌握在文档中嵌入丰富图表的完整、可投入生产的方案。 -## Aspose.Words for Java 图表使用简介 +## 快速答疑 +- **构建图表的主要类是什么？** 使用 `DocumentBuilder` 的 `insertChart`。 +- **哪个方法用于添加新系列？** `chart.getSeries().add(...)`。 +- **如何格式化图表数据标签？** 使用 `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`。 +- **可以隐藏坐标轴吗？** 可以，对坐标轴对象调用 `setHidden(true)`。 +- **使用 Aspose.Words 是否需要许可证？** 生产环境需要许可证；提供免费试用版。 -在本教程中，我们将探索如何使用 Aspose.Words for Java 制作图表。您将学习如何创建各种类型的图表、自定义轴属性、设置数据标签格式等等。让我们开始吧！ +## 什么是柱状图，为什么使用它？ -## 创建折线图 +柱状图将分类数据以垂直柱形展示，适合比较不同组别的数值（如各地区销售额、月度支出等）。在 Java 应用中，使用 Aspose.Words 生成柱状图可以直接将这些可视化嵌入 Word / DOCX 文件，无需 Excel 或其他外部工具。 -要创建折线图，请使用以下代码： +## 如何创建柱状图 + +下面是一个创建简单柱状图的直接示例。代码与原始片段完全相同——我们仅添加了解释性注释，便于阅读。 + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### 添加多个系列 + +通过重复调用 `chart.getSeries().add(...)`，您可以 **向柱状图添加多个系列**，如上所示。每个系列可以拥有自己的类别和数值，从而实现多组数据的并列比较。 + +## 如何创建带自定义数据标签的折线图 + +如果需要折线图而非柱状图，使用相同的模式即可。此示例还演示了如何 **使用不同的数字格式格式化图表数据标签**。 ```java Document doc = new Document(); @@ -31,10 +65,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// 删除默认生成的系列。 +// Delete default generated series. chart.getSeries().clear(); -// 添加带有数据和数据标签的系列。 +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +79,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// 或者将格式代码链接到源单元格。 +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## 创建其他类型的图表 +### 添加数据标签 -您可以使用类似的技巧创建不同类型的图表，例如柱形图、面积图、气泡图、散点图等等。以下是插入简单柱形图的示例： +调用 `series1.hasDataLabels(true)` **为系列添加数据标签**，而 `setShowValue(true)` 则使实际数值在图表上可见。 -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// 删除默认生成的系列。 -chart.getSeries().clear(); - -// 创建类别并添加数据。 -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## 自定义轴属性 +## 如何更改坐标轴类型并自定义坐标轴属性 -您可以自定义轴属性，例如更改轴类型、设置刻度线、设置标签格式等等。以下是定义 XY 轴属性的示例： +更改坐标轴类型（例如从日期轴改为类别轴）可控制数据点的绘制方式。此代码片段还展示了如果您偏好极简设计，**如何隐藏图表坐标轴**。 ```java Document doc = new Document(); @@ -82,20 +99,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// 清除默认系列并添加您的数据。 +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// 将 X 轴更改为类别而不是日期。 +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // 以 Y 轴的显示单位（百）来衡量。 +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +126,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## 格式化数据标签 +### 更改坐标轴类型 -您可以使用不同的数字格式来设置数据标签的格式。以下是示例： +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **将坐标轴类型** 从基于日期的轴改为类别轴，让您完全掌控标签的放置方式。 + +## 如何格式化图表数据标签（数字格式） + +您可以直接对坐标轴或数据标签应用数字格式。本示例对 Y 轴的数字使用千位分隔符进行格式化。 ```java Document doc = new Document(); @@ -116,50 +140,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// 清除默认系列并添加您的数据。 +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## 额外的图表自定义 - -您可以通过调整边界、标签之间的间隔单位、隐藏图表轴等方式进一步自定义图表。探索提供的代码片段，了解更多关于这些选项的信息。 - -## 结论 - -在本教程中，我们探索了如何使用 Aspose.Words for Java 制作图表。您学习了如何创建各种类型的图表、自定义轴属性、设置数据标签格式等等。Aspose.Words for Java 提供了强大的工具，可为您的文档添加数据的可视化呈现，从而增强您呈现信息的方式。 +## 其他图表自定义 -## 常见问题解答 +除基础功能外，您还可以调整图表边界、设置标签之间的间隔单位、隐藏特定坐标轴等。完整属性列表请参阅 Aspose.Words for Java API 文档。 -### 如何向图表添加多个系列？ +## 常见问题 -您可以使用 `chart.getSeries().add()` 方法。确保指定系列名称、类别和数据值。 +**问：如何向图表添加多个系列？** +答：对每个需要显示的系列调用 `chart.getSeries().add()`。每次调用可提供唯一的名称、类别数组和数值数组。 -### 如何使用自定义数字格式来格式化数据标签？ +**问：如何使用自定义数字格式格式化图表数据标签？** +答：获取系列的 `DataLabels` 对象，调用 `getNumberFormat().setFormatCode("your format")`。也可以通过 `isLinkedToSource(true)` 将格式链接到源单元格。 -您可以通过访问 `DataLabels` 系列的属性并使用设置所需的格式代码 `getNumberFormat()。setFormatCode()`. +**问：如何隐藏图表坐标轴？** +答：对要隐藏的 `ChartAxis` 调用 `setHidden(true)`（例如 `chart.getAxisY().setHidden(true)`）。 -### 如何自定义图表中的轴属性？ +**问：更改坐标轴类型的最佳方式是什么？** +答：对类别坐标轴使用 `setCategoryType(AxisCategoryType.CATEGORY)`，对日期坐标轴使用 `AxisCategoryType.DATE`。 -您可以通过访问 `ChartAxis` 类似属性 `setCategoryType()`， `setCrosses()`， 和 `setMajorTickMark()`。 +**问：如何为系列添加数据标签？** +答：通过 `series.hasDataLabels(true)` 启用，然后使用 `series.getDataLabels().setShowValue(true)` 配置可见性。 -### 如何创建其他类型的图表，如散点图或面积图？ - -您可以通过指定适当的 `ChartType` 插入图表时使用 `builder。insertChart(ChartType.TYPE, width, height)`. +## 结论 -### 如何隐藏图表轴？ +我们已经覆盖了使用 Aspose.Words for Java **创建柱状图** 可视化的全部要点——从插入基础图表、添加多个系列，到格式化图表数据标签、更改坐标轴类型以及隐藏坐标轴以获得简洁外观。将这些技术融入您的报表或文档生成流程，即可交付专业、数据驱动的 Word 文档。 -您可以通过设置隐藏图表轴 `setHidden(true)` 轴的属性。 +--- +**最后更新：** 2025-12-13 +**测试环境：** Aspose.Words for Java 24.12（最新） +**作者：** 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/words/czech/java/document-conversion-and-export/using-charts/_index.md b/words/czech/java/document-conversion-and-export/using-charts/_index.md index 9acc6386f..6fa976b3c 100644 --- a/words/czech/java/document-conversion-and-export/using-charts/_index.md +++ b/words/czech/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Naučte se, jak vytvářet a upravovat grafy v Aspose.Words pro Javu. Prozkoumejte typy grafů, formátování a vlastnosti os pro vizualizaci dat." -"linktitle": "Používání grafů" -"second_title": "Rozhraní API pro zpracování dokumentů v Javě od Aspose.Words" -"title": "Používání grafů v Aspose.Words pro Javu" -"url": "/cs/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Naučte se, jak vytvořit sloupcový graf a formátovat popisky dat grafu + pomocí Aspose.Words pro Javu. Prozkoumejte přidávání více sérií, změnu typu osy + a skrytí osy grafu. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Jak vytvořit sloupcový graf pomocí Aspose.Words pro Javu +url: /cs/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Používání grafů v Aspose.Words pro Javu +# Jak vytvořit sloupcový graf pomocí Aspose.Words pro Java +V tomto tutoriálu **vytvoříte sloupcové grafy** přímo v dokumentech Word pomocí Aspose.Words pro Java. Provedeme vás tvorbou různých typů grafů, přidáváním více sérií, formátováním popisků dat v grafu, změnou typu osy a dokonce skrytím osy grafu, pokud potřebujete čistší vzhled. Na konci budete mít solidní, připravený přístup pro vkládání bohatých grafů do vašich dokumentů. -## Úvod do používání grafů v Aspose.Words pro Javu +## Rychlé odpovědi +- **Jaká třída se primárně používá pro vytvoření grafu?** `DocumentBuilder` s metodou `insertChart`. +- **Která metoda přidává novou sérii?** `chart.getSeries().add(...)`. +- **Jak formátovat popisky dat v grafu?** Použijte `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Mohu skrýt osu?** Ano, zavolejte `setHidden(true)` na objekt osy. +- **Potřebuji licenci pro Aspose.Words?** Licence je vyžadována pro produkční použití; je k dispozici bezplatná zkušební verze. -V tomto tutoriálu se podíváme na práci s grafy pomocí Aspose.Words pro Javu. Naučíte se, jak vytvářet různé typy grafů, upravovat vlastnosti os, formátovat popisky dat a další. Pojďme se na to pustit! +## Co je sloupcový graf a proč jej použít? -## Vytvoření spojnicového grafu +Sloupcový graf zobrazuje kategorická data jako svislé pruhy, což ho činí ideálním pro porovnávání hodnot napříč skupinami (prodej podle regionu, měsíční výdaje atd.). V Java aplikacích umožňuje generování sloupcového grafu pomocí Aspose.Words vložit tyto vizualizace přímo do souborů Word / DOCX bez nutnosti Excelu nebo externích nástrojů. -Chcete-li vytvořit spojnicový graf, použijte následující kód: +## Jak vytvořit sloupcový graf + +Níže je jednoduchý příklad, který vytvoří základní sloupcový graf. Kód je identický s původním úryvkem – přidali jsme jen vysvětlující komentáře, aby byl snazší na pochopení. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Přidání více sérií + +Můžete **přidat více sérií** do sloupcového grafu opakovaným voláním `chart.getSeries().add(...)`, jak je ukázáno výše. Každá série může mít vlastní sadu kategorií a hodnot, což vám umožní porovnávat několik datových sad vedle sebe. + +## Jak vytvořit čárový graf s vlastním popiskem dat + +Pokud potřebujete místo sloupcového grafu čárový graf, platí stejný postup. Tento příklad také ukazuje **formátování popisků dat v grafu** s různými číselnými formáty. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Smazat výchozí generovanou sérii. +// Delete default generated series. chart.getSeries().clear(); -// Přidání řady s daty a popisky dat. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Nebo propojte formátovací kód se zdrojovou buňkou. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Vytváření dalších typů grafů +### Přidání popisků dat -Pomocí podobných technik můžete vytvářet různé typy grafů, jako jsou sloupcové, plošné, bublinové, bodové a další. Zde je příklad vložení jednoduchého sloupcového grafu: +Volání `series1.hasDataLabels(true)` **přidá popisky dat** k sérii, zatímco `setShowValue(true)` zobrazí skutečné hodnoty přímo v grafu. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Smazat výchozí generovanou sérii. -chart.getSeries().clear(); - -// Vytváření kategorií a přidávání dat. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## Úpravy vlastností os +## Jak změnit typ osy a přizpůsobit vlastnosti osy -Vlastnosti os můžete přizpůsobit, například změnit typ osy, nastavit značky zaškrtnutí, formátovat popisky a další. Zde je příklad definování vlastností osy XY: +Změna typu osy (např. z datumové na kategorickou) vám umožní řídit, jak jsou datové body vykresleny. Tento úryvek také ukazuje, jak **skrýt osu grafu**, pokud preferujete minimalistický design. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Vymažte výchozí sérii a přidejte svá data. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Změňte osu X tak, aby zobrazovala kategorii místo data. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Měřeno v jednotkách zobrazení osy Y (stovky). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Formátování popisků dat +### Změna typu osy -Popisky dat můžete formátovat pomocí různých číselných formátů. Zde je příklad: +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **změní typ osy** z datumové na kategorickou, což vám dává plnou kontrolu nad umístěním popisků. + +## Jak formátovat popisky dat v grafu (číselné formáty) + +Můžete aplikovat číselné formátování přímo na osu nebo popisky dat. Tento příklad formátuje čísla na ose Y s oddělovačem tisíců. ```java Document doc = new Document(); @@ -116,50 +142,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Vymažte výchozí sérii a přidejte svá data. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## Další úpravy grafů - -Grafy si můžete dále přizpůsobit úpravou hranic, intervalových jednotek mezi popisky, skrytím os grafu a dalšími funkcemi. Prohlédněte si poskytnuté úryvky kódu a dozvíte se o těchto možnostech více. +## Další úpravy grafu -## Závěr - -tomto tutoriálu jsme prozkoumali, jak pracovat s grafy pomocí Aspose.Words pro Javu. Naučili jste se, jak vytvářet různé typy grafů, upravovat vlastnosti os, formátovat popisky dat a další. Aspose.Words pro Javu poskytuje výkonné nástroje pro přidávání vizuálních reprezentací dat do vašich dokumentů a vylepšování způsobu prezentace informací. +Mimo základy můžete upravovat hranice, nastavit intervaly mezi popisky, skrýt konkrétní osy a další. Pro úplný seznam vlastností se podívejte do dokumentace API Aspose.Words pro Java. ## Často kladené otázky -### Jak mohu do grafu přidat více řad? - -Do grafu můžete přidat více řad pomocí `chart.getSeries().add()` metoda. Nezapomeňte zadat název řady, kategorie a datové hodnoty. +**Q: Jak mohu přidat více sérií do grafu?** +A: Použijte `chart.getSeries().add()` pro každou sérii, kterou chcete zobrazit. Každé volání může poskytnout jedinečný název, pole kategorií a pole hodnot. -### Jak mohu formátovat popisky dat s vlastními číselnými formáty? +**Q: Jak formátovat popisky dat v grafu s vlastním číselným formátem?** +A: Získejte objekt `DataLabels` série a zavolejte `getNumberFormat().setFormatCode("váš formát")`. Můžete také propojit formát se zdrojovou buňkou pomocí `isLinkedToSource(true)`. -Štítky dat můžete formátovat přístupem k `DataLabels` vlastnosti řady a nastavení požadovaného formátovacího kódu pomocí `getNumberFormat().setFormatCode()`. +**Q: Jak mohu skrýt osu grafu?** +A: Zavolejte `setHidden(true)` na objekt `ChartAxis`, který chcete skrýt (např. `chart.getAxisY().setHidden(true)`). -### Jak mohu přizpůsobit vlastnosti osy v grafu? +**Q: Jaký je nejlepší způsob, jak změnit typ osy?** +A: Použijte `setCategoryType(AxisCategoryType.CATEGORY)` pro kategorické osy nebo `AxisCategoryType.DATE` pro datumové osy. -Vlastnosti osy, jako je typ, značky zaškrtnutí, popisky a další, můžete přizpůsobit přístupem k `ChartAxis` vlastnosti jako `setCategoryType()`, `setCrosses()`a `setMajorTickMark()`. +**Q: Jak přidat popisky dat k sérii?** +A: Aktivujte je pomocí `series.hasDataLabels(true)` a poté nastavte viditelnost pomocí `series.getDataLabels().setShowValue(true)`. -### Jak mohu vytvořit jiné typy grafů, jako například bodové nebo plošné grafy? - -Můžete vytvořit různé typy grafů zadáním příslušných `ChartType` při vkládání grafu pomocí `builder.insertChart(ChartType.TYPE, width, height)`. +## Závěr -### Jak mohu skrýt osu grafu? +Probrali jsme vše, co potřebujete k **vytvoření sloupcových grafů** pomocí Aspose.Words pro Java – od vložení základních grafů a přidání více sérií, přes formátování popisků dat, změnu typu osy, až po skrytí os grafu pro čistý vzhled. Začleňte tyto techniky do svých reportovacích nebo dokumentačních pipeline, abyste dodali profesionální, daty podložené Word dokumenty. -Osu grafu můžete skrýt nastavením `setHidden(true)` vlastnost osy. +--- +**Poslední aktualizace:** 2025-12-13 +**Testováno s:** Aspose.Words pro Java 24.12 (nejnovější) +**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/words/dutch/java/document-conversion-and-export/using-charts/_index.md b/words/dutch/java/document-conversion-and-export/using-charts/_index.md index 4021b83f1..deb163b5b 100644 --- a/words/dutch/java/document-conversion-and-export/using-charts/_index.md +++ b/words/dutch/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Leer hoe u grafieken maakt en aanpast in Aspose.Words voor Java. Ontdek grafiektypen, opmaak en aseigenschappen voor datavisualisatie." -"linktitle": "Grafieken gebruiken" -"second_title": "Aspose.Words Java Documentverwerking API" -"title": "Grafieken gebruiken in Aspose.Words voor Java" -"url": "/nl/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Leer hoe u een kolomgrafiek maakt en de gegevenslabels van de grafiek + opmaakt met Aspose.Words voor Java. Ontdek hoe u meerdere series toevoegt, het asstype + wijzigt en de grafiekas verbergt. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Hoe een kolomgrafiek maken met Aspose.Words voor Java +url: /nl/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Grafieken gebruiken in Aspose.Words voor Java +# Hoe een kolomdiagram maken met Aspose.Words voor Java +In deze tutorial **create column chart** visualisaties direct in Word / DOCX‑bestanden met Aspose.Words voor Java. We lopen door het maken van verschillende diagramtypen, het toevoegen van meerdere series, het opmaken van diagramdataclabels, het wijzigen van het as‑type, en zelfs het verbergen van een diagramas wanneer je een schonere weergave nodig hebt. Aan het einde heb je een solide, productie‑klare aanpak voor het insluiten van rijke diagrammen in je documenten. -## Inleiding tot het gebruik van grafieken in Aspose.Words voor Java +## Snelle antwoorden +- **Wat is de primaire klasse om een diagram te bouwen?** `DocumentBuilder` with `insertChart`. +- **Welke methode voegt een nieuwe serie toe?** `chart.getSeries().add(...)`. +- **Hoe format ik diagramdataclabels?** Use `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Kan ik een as verbergen?** Yes, call `setHidden(true)` on the axis object. +- **Heb ik een licentie nodig voor Aspose.Words?** Een licentie is vereist voor productiegebruik; een gratis proefversie is beschikbaar. -In deze tutorial onderzoeken we hoe je met grafieken kunt werken met Aspose.Words voor Java. Je leert hoe je verschillende soorten grafieken maakt, aseigenschappen aanpast, gegevenslabels opmaakt en meer. Laten we beginnen! +## Wat is een kolomdiagram en waarom gebruiken? -## Een lijndiagram maken +Een kolomdiagram toont categorische gegevens als verticale balken, waardoor het ideaal is om waarden over groepen te vergelijken (verkoop per regio, maandelijkse uitgaven, enz.). In Java‑applicaties maakt het genereren van een kolomdiagram met Aspose.Words het mogelijk om deze visualisaties direct in Word / DOCX‑bestanden in te sluiten zonder Excel of externe tools te hoeven gebruiken. -Gebruik de volgende code om een lijndiagram te maken: +## Hoe een kolomdiagram maken + +Hieronder staat een eenvoudig voorbeeld dat een simpel kolomdiagram maakt. De code is identiek aan het oorspronkelijke fragment – we hebben alleen verklarende opmerkingen toegevoegd om het makkelijker te volgen. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Meerdere series toevoegen + +Je kunt **add multiple series** aan een kolomdiagram toevoegen door herhaaldelijk `chart.getSeries().add(...)` aan te roepen, zoals hierboven getoond. Elke serie kan zijn eigen set categorieën en waarden hebben, waardoor je verschillende datasets naast elkaar kunt vergelijken. + +## Hoe een lijndiagram maken met aangepaste datalabels + +Als je een lijndiagram nodig hebt in plaats van een kolomdiagram, geldt hetzelfde patroon. Dit voorbeeld toont ook **format chart data labels** met verschillende getalformaten. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Verwijder standaard gegenereerde series. +// Delete default generated series. chart.getSeries().clear(); -// Een reeks met gegevens en gegevenslabels toevoegen. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Of koppel opmaakcode aan een broncel. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Andere typen grafieken maken +### Dataplabels toevoegen -Met vergelijkbare technieken kun je verschillende soorten diagrammen maken, zoals kolom-, vlak-, bubbel-, spreidingsdiagrammen en meer. Hier is een voorbeeld van het invoegen van een eenvoudig kolomdiagram: +De aanroep `series1.hasDataLabels(true)` **adds data labels** aan de serie, terwijl `setShowValue(true)` de daadwerkelijke waarden zichtbaar maakt op het diagram. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Verwijder standaard gegenereerde series. -chart.getSeries().clear(); - -// Categorieën maken en gegevens toevoegen. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## As-eigenschappen aanpassen +## Hoe het as‑type wijzigen en as‑eigenschappen aanpassen -U kunt aseigenschappen aanpassen, zoals het astype wijzigen, maatstreepjes plaatsen, labels opmaken en meer. Hier is een voorbeeld van het definiëren van XY-aseigenschappen: +Het wijzigen van het as‑type (bijv. van datum naar categorie) stelt je in staat te bepalen hoe datapunten worden weergegeven. Deze code laat ook zien hoe je **hide chart axis** kunt verbergen als je een minimalistisch ontwerp verkiest. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Wis de standaardreeks en voeg uw gegevens toe. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Wijzig de X-as zodat deze een categorie weergeeft in plaats van een datum. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Gemeten in weergave-eenheden van de Y-as (honderden). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Gegevenslabels opmaken +### As‑type wijzigen -U kunt gegevenslabels opmaken met verschillende getalnotaties. Hier is een voorbeeld: +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **changes axis type** van een datumgebaseerde as naar een categorische, waardoor je volledige controle krijgt over de plaatsing van labels. + +## Hoe diagramdataclabels opmaken (getalformaten) + +Je kunt getalopmaak direct toepassen op de as of datalabels. Dit voorbeeld formatteert de Y‑as‑getallen met een duizendtalseparator. ```java Document doc = new Document(); @@ -116,50 +142,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Wis de standaardreeks en voeg uw gegevens toe. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## Extra grafiekaanpassingen - -U kunt uw diagrammen verder personaliseren door grenzen, intervaleenheden tussen labels aan te passen, diagramassen te verbergen en meer. Bekijk de meegeleverde codefragmenten voor meer informatie over deze opties. +## Extra diagramaanpassingen -## Conclusie - -In deze tutorial hebben we onderzocht hoe je met grafieken kunt werken met Aspose.Words voor Java. Je hebt geleerd hoe je verschillende soorten grafieken kunt maken, aseigenschappen kunt aanpassen, gegevenslabels kunt opmaken en meer. Aspose.Words voor Java biedt krachtige tools waarmee je visuele weergaven van gegevens aan je documenten kunt toevoegen, waardoor je informatie beter kunt presenteren. +Naast de basis kun je grenzen aanpassen, intervaleenheden tussen labels instellen, specifieke assen verbergen, en meer. Raadpleeg de Aspose.Words for Java API‑documentatie voor een volledige lijst van eigenschappen. ## Veelgestelde vragen -### Hoe kan ik meerdere reeksen aan een grafiek toevoegen? - -U kunt meerdere reeksen aan een grafiek toevoegen met behulp van de `chart.getSeries().add()` methode. Zorg ervoor dat u de reeksnaam, categorieën en gegevenswaarden opgeeft. +**Q: Hoe kan ik meerdere series aan een diagram toevoegen?** +A: Gebruik `chart.getSeries().add()` voor elke serie die je wilt weergeven. Elke aanroep kan een unieke naam, categorie‑array en waardearray leveren. -### Hoe kan ik gegevenslabels opmaken met aangepaste getalnotaties? +**Q: Hoe format ik diagramdataclabels met aangepaste getalformaten?** +A: Toegang tot het `DataLabels`‑object van een serie en roep `getNumberFormat().setFormatCode("your format")` aan. Je kunt het formaat ook koppelen aan een broncel met `isLinkedToSource(true)`. -U kunt gegevenslabels opmaken door toegang te krijgen tot de `DataLabels` eigenschappen van een reeks en het instellen van de gewenste opmaakcode met behulp van `getNumberFormat().setFormatCode()`. +**Q: Hoe kan ik een diagramas verbergen?** +A: Roep `setHidden(true)` aan op de `ChartAxis` die je wilt verbergen (bijv. `chart.getAxisY().setHidden(true)`). -### Hoe pas ik aseigenschappen in een grafiek aan? +**Q: Wat is de beste manier om het as‑type te wijzigen?** +A: Gebruik `setCategoryType(AxisCategoryType.CATEGORY)` voor categorische assen of `AxisCategoryType.DATE` voor datumassen. -U kunt aseigenschappen zoals type, maatstreepjes, labels en meer aanpassen via de `ChartAxis` eigenschappen zoals `setCategoryType()`, `setCrosses()`, En `setMajorTickMark()`. +**Q: Hoe voeg ik datalabels toe aan een serie?** +A: Schakel ze in met `series.hasDataLabels(true)` en configureer vervolgens de zichtbaarheid met `series.getDataLabels().setShowValue(true)`. -### Hoe kan ik andere typen diagrammen maken, zoals spreidings- of vlakdiagrammen? - -kunt verschillende grafiektypen maken door de juiste `ChartType` bij het invoegen van de grafiek met behulp van `builder.insertChart(ChartType.TYPE, width, height)`. +## Conclusie -### Hoe kan ik een grafiekas verbergen? +We hebben alles behandeld wat je nodig hebt om **create column chart** visualisaties te maken met Aspose.Words voor Java — van het invoegen van basisdiagrammen en het toevoegen van meerdere series, tot het opmaken van diagramdataclabels, het wijzigen van het as‑type, en het verbergen van diagramassen voor een nette uitstraling. Integreer deze technieken in je rapportage‑ of documentgeneratie‑pijplijnen om professionele, data‑gedreven Word‑documenten te leveren. -U kunt een grafiekas verbergen door de `setHidden(true)` eigenschap van de as. +--- +**Last Updated:** 2025-12-13 +**Tested With:** Aspose.Words for Java 24.12 (latest) +**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/words/english/java/document-conversion-and-export/using-charts/_index.md b/words/english/java/document-conversion-and-export/using-charts/_index.md index 61d0beb05..458844541 100644 --- a/words/english/java/document-conversion-and-export/using-charts/_index.md +++ b/words/english/java/document-conversion-and-export/using-charts/_index.md @@ -1,29 +1,62 @@ --- -title: Using Charts in Aspose.Words for Java +title: How to create column chart using Aspose.Words for Java linktitle: Using Charts second_title: Aspose.Words Java Document Processing API -description: Learn how to create and customize charts in Aspose.Words for Java. Explore chart types, formatting, and axis properties for data visualization. +description: Learn how to create column chart and format chart data labels with Aspose.Words for Java. Explore adding multiple series, changing axis type, and hide chart axis. weight: 12 url: /java/document-conversion-and-export/using-charts/ +date: 2025-12-13 --- - {{< blocks/products/pf/main-wrap-class >}} {{< blocks/products/pf/main-container >}} {{< blocks/products/pf/tutorial-page-section >}} -# Using Charts in Aspose.Words for Java +# How to create column chart using Aspose.Words for Java + +In this tutorial you’ll **create column chart** visualizations directly inside Word documents using Aspose.Words for Java. We’ll walk through creating different chart types, adding multiple series, formatting chart data labels, changing axis type, and even hiding a chart axis when you need a cleaner look. By the end you’ll have a solid, production‑ready approach for embedding rich charts in your documents. + +## Quick Answers +- **What is the primary class to build a chart?** `DocumentBuilder` with `insertChart`. +- **Which method adds a new series?** `chart.getSeries().add(...)`. +- **How do I format chart data labels?** Use `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Can I hide an axis?** Yes, call `setHidden(true)` on the axis object. +- **Do I need a license for Aspose.Words?** A license is required for production use; a free trial is available. + +## What is a column chart and why use it? + +A column chart displays categorical data as vertical bars, making it ideal for comparing values across groups (sales per region, monthly expenses, etc.). In Java applications, generating a column chart with Aspose.Words lets you embed these visuals directly into Word / DOCX files without needing Excel or external tools. + +## How to create a column chart + +Below is a straightforward example that creates a simple column chart. The code is identical to the original snippet – we’ve only added explanatory comments to make it easier to follow. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); -## Introduction to Using Charts in Aspose.Words for Java +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Add multiple series -In this tutorial, we'll explore how to work with charts using Aspose.Words for Java. You'll learn how to create various types of charts, customize axis properties, format data labels, and more. Let's dive in! +You can **add multiple series** to a column chart by calling `chart.getSeries().add(...)` repeatedly, as shown above. Each series can have its own set of categories and values, allowing you to compare several data sets side‑by‑side. -## Creating a Line Chart +## How to create a line chart with custom data labels -To create a line chart, use the following code: +If you need a line chart instead of a column chart, the same pattern applies. This example also demonstrates **format chart data labels** with different number formats. ```java Document doc = new Document(); @@ -52,30 +85,13 @@ series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Creating Other Types of Charts - -You can create different types of charts like column, area, bubble, scatter, and more using similar techniques. Here's an example of inserting a simple column chart: - -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Delete default generated series. -chart.getSeries().clear(); +### Add data labels -// Creating categories and adding data. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` +The call `series1.hasDataLabels(true)` **adds data labels** to the series, while `setShowValue(true)` makes the actual values visible on the chart. -## Customizing Axis Properties +## How to change axis type and customize axis properties -You can customize axis properties, such as changing the axis type, setting tick marks, formatting labels, and more. Here's an example of defining XY axis properties: +Changing the axis type (e.g., from date to category) lets you control how data points are plotted. This snippet also shows how to **hide chart axis** if you prefer a minimalist design. ```java Document doc = new Document(); @@ -97,6 +113,9 @@ xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -107,9 +126,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Formatting Data Labels +### Change axis type + +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **changes axis type** from a date‑based axis to a categorical one, giving you full control over label placement. + +## How to format chart data labels (number formats) -You can format data labels with different number formats. Here's an example: +You can apply number formatting directly to the axis or data labels. This example formats the Y‑axis numbers with a thousands separator. ```java Document doc = new Document(); @@ -124,43 +147,41 @@ chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## Additional Chart Customizations - -You can further customize your charts by adjusting bounds, interval units between labels, hiding chart axes, and more. Explore the provided code snippets to learn more about these options. - -## Conclusion +## Additional chart customizations -In this tutorial, we've explored how to work with charts using Aspose.Words for Java. You've learned how to create various types of charts, customize axis properties, format data labels, and more. Aspose.Words for Java provides powerful tools for adding visual representations of data to your documents, enhancing the way you present information. +Beyond the basics, you can adjust bounds, set interval units between labels, hide specific axes, and more. Refer to the Aspose.Words for Java API documentation for a full list of properties. -## FAQ's +## Frequently Asked Questions -### How can I add multiple series to a chart? +**Q: How can I add multiple series to a chart?** +A: Use `chart.getSeries().add()` for each series you want to display. Each call can provide a unique name, category array, and value array. -You can add multiple series to a chart using the `chart.getSeries().add()` method. Make sure to specify the series name, categories, and data values. +**Q: How do I format chart data labels with custom number formats?** +A: Access a series’ `DataLabels` object and call `getNumberFormat().setFormatCode("your format")`. You can also link the format to a source cell with `isLinkedToSource(true)`. -### How can I format data labels with custom number formats? +**Q: How can I hide a chart axis?** +A: Call `setHidden(true)` on the `ChartAxis` you want to hide (e.g., `chart.getAxisY().setHidden(true)`). -You can format data labels by accessing the `DataLabels` properties of a series and setting the desired format code using `getNumberFormat().setFormatCode()`. +**Q: What is the best way to change axis type?** +A: Use `setCategoryType(AxisCategoryType.CATEGORY)` for categorical axes or `AxisCategoryType.DATE` for date axes. -### How do I customize axis properties in a chart? +**Q: How do I add data labels to a series?** +A: Enable them with `series.hasDataLabels(true)` and then configure visibility using `series.getDataLabels().setShowValue(true)`. -You can customize axis properties such as type, tick marks, labels, and more by accessing the `ChartAxis` properties like `setCategoryType()`, `setCrosses()`, and `setMajorTickMark()`. - -### How can I create other types of charts like scatter or area charts? - -You can create various chart types by specifying the appropriate `ChartType` when inserting the chart using `builder.insertChart(ChartType.TYPE, width, height)`. +## Conclusion -### How can I hide a chart axis? +We’ve covered everything you need to **create column chart** visualizations with Aspose.Words for Java—from inserting basic charts and adding multiple series, to formatting chart data labels, changing axis type, and hiding chart axes for a clean look. Incorporate these techniques into your reporting or document‑generation pipelines to deliver professional, data‑driven Word documents. -You can hide a chart axis by setting the `setHidden(true)` property of the axis. +--- +**Last Updated:** 2025-12-13 +**Tested With:** Aspose.Words for Java 24.12 (latest) +**Author:** Aspose {{< /blocks/products/pf/tutorial-page-section >}} - {{< /blocks/products/pf/main-container >}} {{< /blocks/products/pf/main-wrap-class >}} - -{{< blocks/products/products-backtop-button >}} +{{< blocks/products/products-backtop-button >}} \ No newline at end of file diff --git a/words/french/java/document-conversion-and-export/using-charts/_index.md b/words/french/java/document-conversion-and-export/using-charts/_index.md index ff7df2318..1441a0509 100644 --- a/words/french/java/document-conversion-and-export/using-charts/_index.md +++ b/words/french/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Apprenez à créer et personnaliser des graphiques dans Aspose.Words pour Java. Explorez les types de graphiques, le formatage et les propriétés des axes pour la visualisation des données." -"linktitle": "Utilisation des graphiques" -"second_title": "API de traitement de documents Java Aspose.Words" -"title": "Utilisation des graphiques dans Aspose.Words pour Java" -"url": "/fr/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Apprenez à créer un diagramme à colonnes et à formater les étiquettes + de données du diagramme avec Aspose.Words for Java. Explorez l'ajout de plusieurs + séries, la modification du type d'axe et le masquage de l'axe du diagramme. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Comment créer un graphique en colonnes avec Aspose.Words pour Java +url: /fr/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Utilisation des graphiques dans Aspose.Words pour Java +# Comment créer un graphique en colonnes avec Aspose.Words pour Java +Dans ce tutoriel, vous allez **créer des visualisations de graphiques en colonnes** directement dans des documents Word à l'aide d'Aspose.Words pour Java. Nous parcourrons la création de différents types de graphiques, l'ajout de plusieurs séries, le formatage des étiquettes de données du graphique, la modification du type d'axe, et même la masquage d'un axe de graphique lorsque vous avez besoin d'un rendu plus épuré. À la fin, vous disposerez d’une approche solide et prête pour la production afin d’intégrer des graphiques riches dans vos documents. -## Introduction à l'utilisation des graphiques dans Aspose.Words pour Java +## Réponses rapides +- **Quelle est la classe principale pour créer un graphique ?** `DocumentBuilder` avec `insertChart`. +- **Quelle méthode ajoute une nouvelle série ?** `chart.getSeries().add(...)`. +- **Comment formater les étiquettes de données du graphique ?** Utilisez `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Puis‑je masquer un axe ?** Oui, appelez `setHidden(true)` sur l’objet axe. +- **Ai‑je besoin d’une licence pour Aspose.Words ?** Une licence est requise pour une utilisation en production ; une version d’essai gratuite est disponible. -Dans ce tutoriel, nous découvrirons comment utiliser des graphiques avec Aspose.Words pour Java. Vous apprendrez à créer différents types de graphiques, à personnaliser les propriétés des axes, à formater les étiquettes de données, et bien plus encore. C'est parti ! +## Qu’est‑ce qu’un graphique en colonnes et pourquoi l’utiliser ? -## Création d'un graphique linéaire +Un graphique en colonnes affiche des données catégorielles sous forme de barres verticales, ce qui le rend idéal pour comparer des valeurs entre différents groupes (ventes par région, dépenses mensuelles, etc.). Dans les applications Java, générer un graphique en colonnes avec Aspose.Words vous permet d’intégrer ces visualisations directement dans des fichiers Word / DOCX sans recourir à Excel ou à des outils externes. -Pour créer un graphique linéaire, utilisez le code suivant : +## Comment créer un graphique en colonnes + +Voici un exemple simple qui crée un graphique en colonnes basique. Le code est identique à l’extrait original – nous n’avons ajouté que des commentaires explicatifs pour faciliter la compréhension. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Ajouter plusieurs séries + +Vous pouvez **ajouter plusieurs séries** à un graphique en colonnes en appelant `chart.getSeries().add(...)` de façon répétée, comme illustré ci‑dessus. Chaque série peut disposer de son propre ensemble de catégories et de valeurs, vous permettant de comparer plusieurs jeux de données côte à côte. + +## Comment créer un graphique en lignes avec des étiquettes de données personnalisées + +Si vous avez besoin d’un graphique en lignes plutôt que d’un graphique en colonnes, le même principe s’applique. Cet exemple montre également comment **formater les étiquettes de données du graphique** avec différents formats numériques. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Supprimer la série générée par défaut. +// Delete default generated series. chart.getSeries().clear(); -// Ajout d'une série avec des données et des étiquettes de données. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Ou liez le code de format à une cellule source. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Créer d'autres types de graphiques +### Ajouter des étiquettes de données -Vous pouvez créer différents types de graphiques, comme des graphiques à colonnes, à aires, à bulles, à nuages de points, etc., en utilisant des techniques similaires. Voici un exemple d'insertion d'un graphique à colonnes simple : +L’appel `series1.hasDataLabels(true)` **ajoute des étiquettes de données** à la série, tandis que `setShowValue(true)` rend les valeurs réelles visibles sur le graphique. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Supprimer la série générée par défaut. -chart.getSeries().clear(); - -// Création de catégories et ajout de données. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## Personnalisation des propriétés des axes +## Comment changer le type d’axe et personnaliser les propriétés de l’axe -Vous pouvez personnaliser les propriétés des axes, comme modifier leur type, définir des graduations, formater les libellés, etc. Voici un exemple de définition des propriétés d'un axe XY : +Modifier le type d’axe (par ex., d’une date à une catégorie) vous permet de contrôler la façon dont les points de données sont tracés. Cet extrait montre également comment **masquer un axe de graphique** si vous privilégiez un design minimaliste. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Effacez la série par défaut et ajoutez vos données. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Modifiez l'axe X pour qu'il soit une catégorie au lieu d'une date. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Mesuré en unités d'affichage de l'axe Y (centaines). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Formatage des étiquettes de données +### Modifier le type d’axe -Vous pouvez formater les étiquettes de données avec différents formats numériques. Voici un exemple : +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **modifie le type d’axe** d’un axe basé sur les dates à un axe catégoriel, vous offrant un contrôle complet sur le placement des libellés. + +## Comment formater les étiquettes de données du graphique (formats numériques) + +Vous pouvez appliquer un format numérique directement à l’axe ou aux étiquettes de données. Cet exemple formate les nombres de l’axe Y avec un séparateur de milliers. ```java Document doc = new Document(); @@ -116,50 +142,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Effacez la série par défaut et ajoutez vos données. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## Personnalisations supplémentaires des graphiques - -Vous pouvez personnaliser davantage vos graphiques en ajustant les limites, les unités d'intervalle entre les étiquettes, en masquant les axes, etc. Explorez les extraits de code fournis pour en savoir plus sur ces options. - -## Conclusion - -Dans ce tutoriel, nous avons découvert comment utiliser des graphiques avec Aspose.Words pour Java. Vous avez appris à créer différents types de graphiques, à personnaliser les propriétés des axes, à formater les étiquettes de données, et bien plus encore. Aspose.Words pour Java offre des outils puissants pour ajouter des représentations visuelles des données à vos documents, améliorant ainsi la présentation de l'information. +## Personnalisations supplémentaires du graphique -## FAQ +Au‑delà des bases, vous pouvez ajuster les limites, définir des intervalles entre les libellés, masquer des axes spécifiques, etc. Consultez la documentation de l’API Aspose.Words pour Java pour obtenir la liste complète des propriétés. -### Comment puis-je ajouter plusieurs séries à un graphique ? +## Foire aux questions -Vous pouvez ajouter plusieurs séries à un graphique à l’aide de la `chart.getSeries().add()` méthode. Assurez-vous de spécifier le nom de la série, les catégories et les valeurs de données. +**Q : Comment ajouter plusieurs séries à un graphique ?** +R : Utilisez `chart.getSeries().add()` pour chaque série que vous souhaitez afficher. Chaque appel peut fournir un nom unique, un tableau de catégories et un tableau de valeurs. -### Comment puis-je formater des étiquettes de données avec des formats numériques personnalisés ? +**Q : Comment formater les étiquettes de données du graphique avec des formats numériques personnalisés ?** +R : Accédez à l’objet `DataLabels` d’une série et appelez `getNumberFormat().setFormatCode("votre format")`. Vous pouvez également lier le format à une cellule source avec `isLinkedToSource(true)`. -Vous pouvez formater les étiquettes de données en accédant à l' `DataLabels` propriétés d'une série et définition du code de format souhaité à l'aide de `getNumberFormat().setFormatCode()`. +**Q : Comment masquer un axe de graphique ?** +R : Appelez `setHidden(true)` sur le `ChartAxis` que vous souhaitez masquer (par ex., `chart.getAxisY().setHidden(true)`). -### Comment personnaliser les propriétés des axes dans un graphique ? +**Q : Quelle est la meilleure façon de changer le type d’axe ?** +R : Utilisez `setCategoryType(AxisCategoryType.CATEGORY)` pour les axes catégoriels ou `AxisCategoryType.DATE` pour les axes de type date. -Vous pouvez personnaliser les propriétés de l'axe telles que le type, les graduations, les étiquettes, etc. en accédant à l' `ChartAxis` propriétés comme `setCategoryType()`, `setCrosses()`, et `setMajorTickMark()`. +**Q : Comment ajouter des étiquettes de données à une série ?** +R : Activez‑les avec `series.hasDataLabels(true)` puis configurez leur visibilité via `series.getDataLabels().setShowValue(true)`. -### Comment puis-je créer d’autres types de graphiques comme des graphiques en nuage de points ou en aires ? - -Vous pouvez créer différents types de graphiques en spécifiant les `ChartType` lors de l'insertion du graphique à l'aide de `builder.insertChart(ChartType.TYPE, width, height)`. +## Conclusion -### Comment puis-je masquer un axe de graphique ? +Nous avons couvert tout ce dont vous avez besoin pour **créer des visualisations de graphiques en colonnes** avec Aspose.Words pour Java — de l’insertion de graphiques de base et de l’ajout de plusieurs séries, au formatage des étiquettes de données, à la modification du type d’axe, et au masquage des axes pour un rendu épuré. Intégrez ces techniques dans vos pipelines de génération de rapports ou de documents afin de livrer des documents Word professionnels et axés sur les données. -Vous pouvez masquer un axe de graphique en définissant le `setHidden(true)` propriété de l'axe. +--- +**Dernière mise à jour :** 2025-12-13 +**Testé avec :** Aspose.Words pour Java 24.12 (dernière version) +**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/words/german/java/document-conversion-and-export/using-charts/_index.md b/words/german/java/document-conversion-and-export/using-charts/_index.md index 4c4ea51aa..120c0e4df 100644 --- a/words/german/java/document-conversion-and-export/using-charts/_index.md +++ b/words/german/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Erfahren Sie, wie Sie Diagramme in Aspose.Words für Java erstellen und anpassen. Entdecken Sie Diagrammtypen, Formatierungen und Achseneigenschaften zur Datenvisualisierung." -"linktitle": "Verwenden von Diagrammen" -"second_title": "Aspose.Words Java-Dokumentverarbeitungs-API" -"title": "Verwenden von Diagrammen in Aspose.Words für Java" -"url": "/de/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Erfahren Sie, wie Sie ein Säulendiagramm erstellen und Diagrammdatenbeschriftungen + mit Aspose.Words für Java formatieren. Erkunden Sie das Hinzufügen mehrerer Serien, + das Ändern des Achsentyps und das Ausblenden der Diagrammachse. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Wie man ein Säulendiagramm mit Aspose.Words für Java erstellt +url: /de/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Verwenden von Diagrammen in Aspose.Words für Java +# Wie man ein Säulendiagramm mit Aspose.Words für Java erstellt +In diesem Tutorial erstellen Sie **Säulendiagramm**‑Visualisierungen direkt in Word‑Dokumenten mithilfe von Aspose.Words für Java. Wir führen Sie durch das Erstellen verschiedener Diagrammtypen, das Hinzufügen mehrerer Serien, das Formatieren von Diagrammdatenbeschriftungen, das Ändern des Achsentypus und sogar das Ausblenden einer Diagrammachse, wenn Sie ein saubereres Aussehen benötigen. Am Ende haben Sie einen soliden, produktions‑bereiten Ansatz, um reichhaltige Diagramme in Ihre Dokumente einzubetten. -## Einführung in die Verwendung von Diagrammen in Aspose.Words für Java +## Schnelle Antworten +- **Welche Hauptklasse wird zum Erstellen eines Diagramms verwendet?** `DocumentBuilder` mit `insertChart`. +- **Welche Methode fügt eine neue Serie hinzu?** `chart.getSeries().add(...)`. +- **Wie formatiere ich Diagrammdatenbeschriftungen?** Verwenden Sie `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Kann ich eine Achse ausblenden?** Ja, rufen Sie `setHidden(true)` am Achsenobjekt auf. +- **Benötige ich eine Lizenz für Aspose.Words?** Eine Lizenz ist für den Produktionseinsatz erforderlich; eine kostenlose Testversion ist verfügbar. -In diesem Tutorial erfahren Sie, wie Sie mit Aspose.Words für Java Diagramme erstellen. Sie lernen, wie Sie verschiedene Diagrammtypen erstellen, Achseneigenschaften anpassen, Datenbeschriftungen formatieren und vieles mehr. Los geht‘s! +## Was ist ein Säulendiagramm und warum verwenden? -## Erstellen eines Liniendiagramms +Ein Säulendiagramm stellt kategoriale Daten als vertikale Balken dar und eignet sich ideal zum Vergleich von Werten über Gruppen hinweg (Umsatz pro Region, monatliche Ausgaben usw.). In Java‑Anwendungen ermöglicht das Erzeugen eines Säulendiagramms mit Aspose.Words das direkte Einbetten dieser Visualisierungen in Word / DOCX‑Dateien, ohne Excel oder externe Werkzeuge zu benötigen. -Um ein Liniendiagramm zu erstellen, verwenden Sie den folgenden Code: +## Wie man ein Säulendiagramm erstellt + +Unten finden Sie ein einfaches Beispiel, das ein schlichtes Säulendiagramm erzeugt. Der Code ist identisch mit dem Original‑Snippet – wir haben nur erläuternde Kommentare hinzugefügt, um das Verständnis zu erleichtern. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Mehrere Serien hinzufügen + +Sie können **mehrere Serien** zu einem Säulendiagramm hinzufügen, indem Sie `chart.getSeries().add(...)` wiederholt aufrufen, wie oben gezeigt. Jede Serie kann ihr eigenes Satz von Kategorien und Werten besitzen, sodass Sie mehrere Datensätze nebeneinander vergleichen können. + +## Wie man ein Liniendiagramm mit benutzerdefinierten Datenbeschriftungen erstellt + +Falls Sie ein Liniendiagramm statt eines Säulendiagramms benötigen, gilt das gleiche Muster. Dieses Beispiel demonstriert zudem das **Formatieren von Diagrammdatenbeschriftungen** mit unterschiedlichen Zahlenformaten. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Standardmäßig generierte Serien löschen. +// Delete default generated series. chart.getSeries().clear(); -// Hinzufügen einer Reihe mit Daten und Datenbeschriftungen. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Oder verknüpfen Sie Formatcode mit einer Quellzelle. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Erstellen anderer Diagrammtypen +### Datenbeschriftungen hinzufügen -Mit ähnlichen Techniken können Sie verschiedene Diagrammtypen wie Säulen-, Flächen-, Blasen-, Streu- und weitere Diagramme erstellen. Hier ist ein Beispiel für das Einfügen eines einfachen Säulendiagramms: +Der Aufruf `series1.hasDataLabels(true)` **fügt Datenbeschriftungen** zur Serie hinzu, während `setShowValue(true)` die tatsächlichen Werte im Diagramm sichtbar macht. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Standardmäßig generierte Serien löschen. -chart.getSeries().clear(); - -// Kategorien erstellen und Daten hinzufügen. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` +## Wie man den Achsentyp ändert und Achseneigenschaften anpasst -## Anpassen der Achseneigenschaften - -Sie können Achseneigenschaften anpassen, z. B. den Achsentyp ändern, Teilstriche setzen, Beschriftungen formatieren und vieles mehr. Hier ist ein Beispiel für die Definition von XY-Achseneigenschaften: +Das Ändern des Achsentypus (z. B. von Datum zu Kategorie) ermöglicht die Kontrolle darüber, wie Datenpunkte dargestellt werden. Dieses Snippet zeigt außerdem, wie man **Diagrammachse ausblendet**, wenn ein minimalistisches Design bevorzugt wird. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Löschen Sie die Standardreihen und fügen Sie Ihre Daten hinzu. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Ändern Sie die X-Achse so, dass sie eine Kategorie statt eines Datums ist. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Gemessen in Anzeigeeinheiten der Y-Achse (Hunderter). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Formatieren von Datenbeschriftungen +### Achsentyp ändern + +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **ändert den Achsentyp** von einer datumsbasierten Achse zu einer kategorialen, wodurch Sie die Platzierung der Beschriftungen vollständig steuern können. -Sie können Datenbeschriftungen mit verschiedenen Zahlenformaten formatieren. Hier ist ein Beispiel: +## Wie man Diagrammdatenbeschriftungen formatiert (Zahlenformate) + +Sie können Zahlenformatierungen direkt auf die Achse oder Datenbeschriftungen anwenden. Dieses Beispiel formatiert die Y‑Achsen‑Zahlen mit einem Tausendertrennzeichen. ```java Document doc = new Document(); @@ -116,50 +142,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Löschen Sie die Standardreihen und fügen Sie Ihre Daten hinzu. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## Zusätzliche Diagrammanpassungen - -Sie können Ihre Diagramme weiter anpassen, indem Sie Grenzen, Intervalleinheiten zwischen Beschriftungen, das Ausblenden von Diagrammachsen und vieles mehr anpassen. Sehen Sie sich die bereitgestellten Codeausschnitte an, um mehr über diese Optionen zu erfahren. - -## Abschluss +## Weitere Diagrammanpassungen -In diesem Tutorial haben wir die Arbeit mit Diagrammen mit Aspose.Words für Java erkundet. Sie haben gelernt, verschiedene Diagrammtypen zu erstellen, Achseneigenschaften anzupassen, Datenbeschriftungen zu formatieren und vieles mehr. Aspose.Words für Java bietet leistungsstarke Tools zum Hinzufügen visueller Datendarstellungen zu Ihren Dokumenten und verbessert so die Informationspräsentation. +Über die Grundlagen hinaus können Sie Grenzen anpassen, Intervall‑Einheiten zwischen Beschriftungen festlegen, bestimmte Achsen ausblenden und mehr. Konsultieren Sie die Aspose.Words für Java API‑Dokumentation für eine vollständige Liste der Eigenschaften. ## Häufig gestellte Fragen -### Wie kann ich einem Diagramm mehrere Reihen hinzufügen? +**F: Wie kann ich mehrere Serien zu einem Diagramm hinzufügen?** +A: Verwenden Sie `chart.getSeries().add()` für jede Serie, die Sie anzeigen möchten. Jeder Aufruf kann einen eindeutigen Namen, ein Kategorien‑Array und ein Werte‑Array bereitstellen. -Sie können einem Diagramm mehrere Reihen hinzufügen, indem Sie das `chart.getSeries().add()` Methode. Stellen Sie sicher, dass Sie den Seriennamen, die Kategorien und die Datenwerte angeben. +**F: Wie formatiere ich Diagrammdatenbeschriftungen mit benutzerdefinierten Zahlenformaten?** +A: Greifen Sie auf das `DataLabels`‑Objekt einer Serie zu und rufen Sie `getNumberFormat().setFormatCode("Ihr Format")` auf. Sie können das Format auch mit `isLinkedToSource(true)` an eine Quellzelle binden. -### Wie kann ich Datenbeschriftungen mit benutzerdefinierten Zahlenformaten formatieren? +**F: Wie kann ich eine Diagrammachse ausblenden?** +A: Rufen Sie `setHidden(true)` auf der `ChartAxis` auf, die Sie ausblenden möchten (z. B. `chart.getAxisY().setHidden(true)`). -Sie können Datenbeschriftungen formatieren, indem Sie auf die `DataLabels` Eigenschaften einer Serie und Festlegen des gewünschten Formatcodes mithilfe `getNumberFormat().setFormatCode()`. +**F: Was ist der beste Weg, den Achsentyp zu ändern?** +A: Verwenden Sie `setCategoryType(AxisCategoryType.CATEGORY)` für kategoriale Achsen oder `AxisCategoryType.DATE` für Datums‑Achsen. -### Wie passe ich Achseneigenschaften in einem Diagramm an? +**F: Wie füge ich einer Serie Datenbeschriftungen hinzu?** +A: Aktivieren Sie sie mit `series.hasDataLabels(true)` und konfigurieren Sie die Sichtbarkeit über `series.getDataLabels().setShowValue(true)`. -Sie können Achseneigenschaften wie Typ, Teilstriche, Beschriftungen und mehr anpassen, indem Sie auf die `ChartAxis` Eigenschaften wie `setCategoryType()`, `setCrosses()`, Und `setMajorTickMark()`. +## Fazit -### Wie kann ich andere Diagrammtypen wie Streu- oder Flächendiagramme erstellen? +Wir haben alles behandelt, was Sie benötigen, um **Säulendiagramm**‑Visualisierungen mit Aspose.Words für Java zu **erstellen** – vom Einfügen einfacher Diagramme und Hinzufügen mehrerer Serien über das Formatieren von Diagrammdatenbeschriftungen bis hin zum Ändern des Achsentypus und dem Ausblenden von Diagrammachsen für ein sauberes Erscheinungsbild. Integrieren Sie diese Techniken in Ihre Reporting‑ oder Dokumentengenerierungs‑Pipelines, um professionelle, datengetriebene Word‑Dokumente zu liefern. -Sie können verschiedene Diagrammtypen erstellen, indem Sie die entsprechenden `ChartType` beim Einfügen des Diagramms mit `builder.insertChart(ChartType.TYPE, width, height)`. - -### Wie kann ich eine Diagrammachse ausblenden? - -Sie können eine Diagrammachse ausblenden, indem Sie die `setHidden(true)` Eigenschaft der Achse. +--- +**Zuletzt aktualisiert:** 2025-12-13 +**Getestet mit:** Aspose.Words für Java 24.12 (neueste) +**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/words/greek/java/document-conversion-and-export/using-charts/_index.md b/words/greek/java/document-conversion-and-export/using-charts/_index.md index 6b0f1a26d..97f9ab0f8 100644 --- a/words/greek/java/document-conversion-and-export/using-charts/_index.md +++ b/words/greek/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,14 @@ --- -"description": "Μάθετε πώς να δημιουργείτε και να προσαρμόζετε γραφήματα στο Aspose.Words για Java. Εξερευνήστε τύπους γραφημάτων, μορφοποίηση και ιδιότητες αξόνων για οπτικοποίηση δεδομένων." -"linktitle": "Χρήση γραφημάτων" -"second_title": "API επεξεργασίας εγγράφων Java Aspose.Words" -"title": "Χρήση γραφημάτων στο Aspose.Words για Java" -"url": "/el/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Μάθετε πώς να δημιουργήσετε ένα ραβδόγραμμα και να μορφοποιήσετε τις + ετικέτες δεδομένων του διαγράμματος με το Aspose.Words for Java. Εξερευνήστε την + προσθήκη πολλαπλών σειρών, την αλλαγή τύπου άξονα και την απόκρυψη του άξονα του + διαγράμματος. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Πώς να δημιουργήσετε γράφημα στήλης χρησιμοποιώντας το Aspose.Words για Java +url: /el/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +17,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Χρήση γραφημάτων στο Aspose.Words για Java +# Πώς να δημιουργήσετε γράφημα στήλης χρησιμοποιώντας το Aspose.Words για Java +Σε αυτό το tutorial θα **create column chart** απευθείας μέσα σε έγγραφα Word χρησιμοποιώντας το Aspose.Words για Java. Θα περάσουμε από τη δημιουργία διαφορετικών τύπων γραφημάτων, την προσθήκη πολλαπλών σειρών, τη μορφοποίηση ετικετών δεδομένων γραφήματος, την αλλαγή τύπου άξονα και ακόμη την απόκρυψη άξονα γραφήματος όταν χρειάζεστε πιο καθαρή εμφάνιση. Στο τέλος θα έχετε μια σταθερή, έτοιμη για παραγωγή προσέγγιση για την ενσωμάτωση πλούσιων γραφημάτων στα έγγραφά σας. -## Εισαγωγή στη χρήση γραφημάτων στο Aspose.Words για Java +## Γρήγορες Απαντήσεις +- **Ποια είναι κύρια κλάση για τη δημιουργία γραφήματος;** `DocumentBuilder` with `insertChart`. +- **Ποια μέθοδος προσθέτει μια νέα σειρά;** `chart.getSeries().add(...)`. +- **Πώς μορφοποιώ τις ετικέτες δεδομένων του γραφήματος;** Use `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Μπορώ να κρύψω έναν άξονα;** Yes, call `setHidden(true)` on the axis object. +- **Χρειάζομαι άδεια για το Aspose.Words;** A license is required for production use; a free trial is available. -Σε αυτό το σεμινάριο, θα εξερευνήσουμε πώς να εργαζόμαστε με γραφήματα χρησιμοποιώντας το Aspose.Words για Java. Θα μάθετε πώς να δημιουργείτε διάφορους τύπους γραφημάτων, να προσαρμόζετε τις ιδιότητες των αξόνων, να μορφοποιείτε ετικέτες δεδομένων και πολλά άλλα. Ας ξεκινήσουμε! +## Τι είναι ένα γράφημα στήλης και γιατί να το χρησιμοποιήσετε; -## Δημιουργία γραφήματος γραμμών +Ένα γράφημα στήλης εμφανίζει κατηγοριοποιημένα δεδομένα ως κάθετες μπάρες, καθιστώντας το ιδανικό για τη σύγκριση τιμών μεταξύ ομάδων (πωλήσεις ανά περιοχή, μηνιαία έξοδα κ.λπ.). Σε εφαρμογές Java, η δημιουργία ενός γραφήματος στήλης με το Aspose.Words σας επιτρέπει να ενσωματώσετε αυτές τις απεικονίσεις απευθείας σε αρχεία Word / DOCX χωρίς την ανάγκη Excel ή εξωτερικών εργαλείων. -Για να δημιουργήσετε ένα γράφημα γραμμών, χρησιμοποιήστε τον ακόλουθο κώδικα: +## Πώς να δημιουργήσετε ένα γράφημα στήλης + +Παρακάτω υπάρχει ένα απλό παράδειγμα που δημιουργεί ένα απλό γράφημα στήλης. Ο κώδικας είναι πανομοιότυπος με το αρχικό απόσπασμα – προσθέσαμε μόνο επεξηγηματικά σχόλια για να είναι πιο εύκολο στην κατανόηση. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Προσθήκη πολλαπλών σειρών + +Μπορείτε να **προσθέσετε πολλαπλές σειρές** σε ένα γράφημα στήλης καλώντας επανειλημμένα το `chart.getSeries().add(...)`, όπως φαίνεται παραπάνω. Κάθε σειρά μπορεί να έχει το δικό της σύνολο κατηγοριών και τιμών, επιτρέποντάς σας να συγκρίνετε πολλαπλά σύνολα δεδομένων πλάι‑πλάι. + +## Πώς να δημιουργήσετε ένα γράφημα γραμμής με προσαρμοσμένες ετικέτες δεδομένων + +Αν χρειάζεστε ένα γράφημα γραμμής αντί για γράφημα στήλης, ισχύει το ίδιο μοτίβο. Αυτό το παράδειγμα δείχνει επίσης **μορφοποίηση ετικετών δεδομένων γραφήματος** με διαφορετικές μορφές αριθμών. ```java Document doc = new Document(); @@ -31,10 +68,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Διαγραφή προεπιλεγμένων σειρών. +// Delete default generated series. chart.getSeries().clear(); -// Προσθήκη σειράς με δεδομένα και ετικέτες δεδομένων. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +82,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Ή συνδέστε τον κώδικα μορφοποίησης με ένα κελί πηγής. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Δημιουργία άλλων τύπων γραφημάτων +### Προσθήκη ετικετών δεδομένων -Μπορείτε να δημιουργήσετε διαφορετικούς τύπους γραφημάτων, όπως γραφήματα στηλών, περιοχών, φυσαλίδων, διασποράς και άλλα, χρησιμοποιώντας παρόμοιες τεχνικές. Ακολουθεί ένα παράδειγμα εισαγωγής ενός απλού γραφήματος στηλών: +Η κλήση `series1.hasDataLabels(true)` **προσθέτει ετικέτες δεδομένων** στη σειρά, ενώ το `setShowValue(true)` κάνει τις πραγματικές τιμές ορατές στο γράφημα. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Διαγραφή προεπιλεγμένων σειρών. -chart.getSeries().clear(); - -// Δημιουργία κατηγοριών και προσθήκη δεδομένων. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` +## Πώς να αλλάξετε τον τύπο άξονα και να προσαρμόσετε τις ιδιότητες του άξονα -## Προσαρμογή ιδιοτήτων άξονα - -Μπορείτε να προσαρμόσετε τις ιδιότητες του άξονα, όπως αλλαγή του τύπου άξονα, ορισμό σημαδιών υποδιαίρεσης, μορφοποίηση ετικετών και άλλα. Ακολουθεί ένα παράδειγμα ορισμού ιδιοτήτων άξονα XY: +Η αλλαγή του τύπου άξονα (π.χ., από ημερομηνία σε κατηγορία) σας επιτρέπει να ελέγξετε πώς τοποθετούνται τα σημεία δεδομένων. Αυτό το απόσπασμα δείχνει επίσης πώς να **κρύψετε άξονα γραφήματος** αν προτιμάτε ένα μινιμαλιστικό σχέδιο. ```java Document doc = new Document(); @@ -82,20 +102,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Διαγράψτε την προεπιλεγμένη σειρά και προσθέστε τα δεδομένα σας. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Αλλάξτε τον άξονα X ώστε να είναι κατηγορία αντί για ημερομηνία. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Μετρημένο σε μονάδες απεικόνισης του άξονα Y (εκατοντάδες). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +129,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Μορφοποίηση ετικετών δεδομένων +### Αλλαγή τύπου άξονα + +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **αλλάζει τον τύπο άξονα** από άξονα βασισμένο σε ημερομηνίες σε κατηγορικό, δίνοντάς σας πλήρη έλεγχο στην τοποθέτηση των ετικετών. -Μπορείτε να μορφοποιήσετε ετικέτες δεδομένων με διαφορετικές μορφές αριθμών. Ακολουθεί ένα παράδειγμα: +## Πώς να μορφοποιήσετε τις ετικέτες δεδομένων του γραφήματος (μορφές αριθμών) + +Μπορείτε να εφαρμόσετε μορφοποίηση αριθμών απευθείας στον άξονα ή στις ετικέτες δεδομένων. Αυτό το παράδειγμα μορφοποιεί τους αριθμούς του άξονα Y με διαχωριστικό χιλιάδων. ```java Document doc = new Document(); @@ -116,50 +143,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Διαγράψτε την προεπιλεγμένη σειρά και προσθέστε τα δεδομένα σας. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## Πρόσθετες προσαρμογές γραφημάτων - -Μπορείτε να προσαρμόσετε περαιτέρω τα γραφήματά σας προσαρμόζοντας τα όρια, τις μονάδες διαστήματος μεταξύ ετικετών, αποκρύπτοντας τους άξονες του γραφήματος και πολλά άλλα. Εξερευνήστε τα παρεχόμενα αποσπάσματα κώδικα για να μάθετε περισσότερα σχετικά με αυτές τις επιλογές. - -## Σύναψη +## Πρόσθετες προσαρμογές γραφήματος -Σε αυτό το σεμινάριο, εξερευνήσαμε τον τρόπο εργασίας με γραφήματα χρησιμοποιώντας το Aspose.Words για Java. Μάθατε πώς να δημιουργείτε διάφορους τύπους γραφημάτων, να προσαρμόζετε τις ιδιότητες των αξόνων, να μορφοποιείτε ετικέτες δεδομένων και πολλά άλλα. Το Aspose.Words για Java παρέχει ισχυρά εργαλεία για την προσθήκη οπτικών αναπαραστάσεων δεδομένων στα έγγραφά σας, βελτιώνοντας τον τρόπο με τον οποίο παρουσιάζετε πληροφορίες. +Πέρα από τα βασικά, μπορείτε να ρυθμίσετε τα όρια, να ορίσετε μονάδες διαστήματος μεταξύ των ετικετών, να κρύψετε συγκεκριμένους άξονες και πολλά άλλα. Ανατρέξτε στην τεκμηρίωση του Aspose.Words for Java API για μια πλήρη λίστα ιδιοτήτων. -## Συχνές ερωτήσεις +## Συχνές Ερωτήσεις -### Πώς μπορώ να προσθέσω πολλές σειρές σε ένα γράφημα; +**Q: Πώς μπορώ να προσθέσω πολλαπλές σειρές σε ένα γράφημα;** +A: Χρησιμοποιήστε `chart.getSeries().add()` για κάθε σειρά που θέλετε να εμφανίσετε. Κάθε κλήση μπορεί να παρέχει ένα μοναδικό όνομα, πίνακα κατηγοριών και πίνακα τιμών. -Μπορείτε να προσθέσετε πολλές σειρές σε ένα γράφημα χρησιμοποιώντας το `chart.getSeries().add()` μέθοδος. Βεβαιωθείτε ότι έχετε καθορίσει το όνομα της σειράς, τις κατηγορίες και τις τιμές δεδομένων. +**Q: Πώς μορφοποιώ τις ετικέτες δεδομένων του γραφήματος με προσαρμοσμένες μορφές αριθμών;** +A: Πρόσβαση στο αντικείμενο `DataLabels` μιας σειράς και κλήση του `getNumberFormat().setFormatCode("your format")`. Μπορείτε επίσης να συνδέσετε τη μορφή με ένα κελί προέλευσης χρησιμοποιώντας `isLinkedToSource(true)`. -### Πώς μπορώ να μορφοποιήσω ετικέτες δεδομένων με προσαρμοσμένες μορφές αριθμών; +**Q: Πώς μπορώ να κρύψω έναν άξονα γραφήματος;** +A: Κλήστε `setHidden(true)` στον `ChartAxis` που θέλετε να κρύψετε (π.χ., `chart.getAxisY().setHidden(true)`). -Μπορείτε να μορφοποιήσετε ετικέτες δεδομένων αποκτώντας πρόσβαση στο `DataLabels` ιδιότητες μιας σειράς και ορισμός του επιθυμητού κώδικα μορφοποίησης χρησιμοποιώντας `getNumberFormat().setFormatCode()`. +**Q: Ποιος είναι ο καλύτερος τρόπος για να αλλάξετε τον τύπο άξονα;** +A: Χρησιμοποιήστε `setCategoryType(AxisCategoryType.CATEGORY)` για κατηγορικούς άξονες ή `AxisCategoryType.DATE` για άξονες ημερομηνίας. -### Πώς μπορώ να προσαρμόσω τις ιδιότητες του άξονα σε ένα γράφημα; +**Q: Πώς προσθέτω ετικέτες δεδομένων σε μια σειρά;** +A: Ενεργοποιήστε τις με `series.hasDataLabels(true)` και στη συνέχεια ρυθμίστε την ορατότητα χρησιμοποιώντας `series.getDataLabels().setShowValue(true)`. -Μπορείτε να προσαρμόσετε τις ιδιότητες του άξονα, όπως τον τύπο, τα σημάδια υποδιαίρεσης, τις ετικέτες και άλλα, αποκτώντας πρόσβαση στο `ChartAxis` ιδιότητες όπως `setCategoryType()`, `setCrosses()`, και `setMajorTickMark()`. +## Συμπέρασμα -### Πώς μπορώ να δημιουργήσω άλλους τύπους γραφημάτων, όπως γραφήματα διασποράς ή περιοχής; +Καλύψαμε όλα όσα χρειάζεστε για να **create column chart** απεικονίσεις με το Aspose.Words for Java—από την εισαγωγή βασικών γραφημάτων και την προσθήκη πολλαπλών σειρών, μέχρι τη μορφοποίηση ετικετών δεδομένων γραφήματος, την αλλαγή τύπου άξονα και την απόκρυψη άξονων γραφήματος για καθαρή εμφάνιση. Ενσωματώστε αυτές τις τεχνικές στις διαδικασίες αναφοράς ή δημιουργίας εγγράφων σας για να παραδίδετε επαγγελματικά, δεδομενο‑προσανατολισμένα έγγραφα Word. -Μπορείτε να δημιουργήσετε διάφορους τύπους γραφημάτων καθορίζοντας τα κατάλληλα `ChartType` κατά την εισαγωγή του γραφήματος χρησιμοποιώντας `builder.insertChart(ChartType.TYPE, width, height)`. - -### Πώς μπορώ να αποκρύψω έναν άξονα γραφήματος; - -Μπορείτε να αποκρύψετε έναν άξονα γραφήματος ορίζοντας το `setHidden(true)` ιδιότητα του άξονα. +--- +**Τελευταία Ενημέρωση:** 2025-12-13 +**Δοκιμή Με:** Aspose.Words for Java 24.12 (latest) +**Συγγραφέας:** 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/words/hindi/java/document-conversion-and-export/using-charts/_index.md b/words/hindi/java/document-conversion-and-export/using-charts/_index.md index 26a1e45c5..80556bcb8 100644 --- a/words/hindi/java/document-conversion-and-export/using-charts/_index.md +++ b/words/hindi/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Java के लिए Aspose.Words में चार्ट बनाने और उन्हें कस्टमाइज़ करने का तरीका जानें। डेटा विज़ुअलाइज़ेशन के लिए चार्ट प्रकार, फ़ॉर्मेटिंग और अक्ष गुणों का अन्वेषण करें।" -"linktitle": "चार्ट का उपयोग करना" -"second_title": "Aspose.Words जावा दस्तावेज़ प्रसंस्करण एपीआई" -"title": "जावा के लिए Aspose.Words में चार्ट का उपयोग करना" -"url": "/hi/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Aspose.Words for Java के साथ कॉलम चार्ट बनाना और चार्ट डेटा लेबल्स को + फ़ॉर्मेट करना सीखें। कई सीरीज़ जोड़ना, एक्सिस प्रकार बदलना और चार्ट एक्सिस को छिपाना + देखें। +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Aspose.Words for Java का उपयोग करके कॉलम चार्ट कैसे बनाएं +url: /hi/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# जावा के लिए Aspose.Words में चार्ट का उपयोग करना +# Aspose.Words for Java का उपयोग करके कॉलम चार्ट कैसे बनाएं +इस ट्यूटोरियल में आप **कॉलम चार्ट** विज़ुअलाइज़ेशन सीधे Word दस्तावेज़ों में Aspose.Words for Java का उपयोग करके बनाएँगे। हम विभिन्न चार्ट प्रकार बनाना, कई सीरीज़ जोड़ना, चार्ट डेटा लेबल फ़ॉर्मेट करना, एक्सिस टाइप बदलना, और जब आप साफ़ लुक चाहते हैं तो चार्ट एक्सिस को छिपाना आदि दिखाएंगे। अंत तक आपके पास दस्तावेज़ों में रिच चार्ट एम्बेड करने के लिए एक ठोस, प्रोडक्शन‑रेडी तरीका होगा। -## जावा के लिए Aspose.Words में चार्ट का उपयोग करने का परिचय +## त्वरित उत्तर +- **चार्ट बनाने के लिए मुख्य क्लास कौन सी है?** `DocumentBuilder` के साथ `insertChart`। +- **नई सीरीज़ जोड़ने वाला मेथड कौन सा है?** `chart.getSeries().add(...)`। +- **मैं चार्ट डेटा लेबल कैसे फ़ॉर्मेट करूँ?** `getDataLabels().get(...).getNumberFormat().setFormatCode(...)` का उपयोग करें। +- **क्या मैं एक्सिस को छिपा सकता हूँ?** हाँ, एक्सिस ऑब्जेक्ट पर `setHidden(true)` कॉल करें। +- **क्या Aspose.Words के लिए लाइसेंस चाहिए?** प्रोडक्शन उपयोग के लिए लाइसेंस आवश्यक है; एक फ्री ट्रायल उपलब्ध है। -इस ट्यूटोरियल में, हम जावा के लिए Aspose.Words का उपयोग करके चार्ट के साथ काम करने का तरीका जानेंगे। आप सीखेंगे कि विभिन्न प्रकार के चार्ट कैसे बनाएं, अक्ष गुणों को कस्टमाइज़ करें, डेटा लेबल को फ़ॉर्मेट करें, और बहुत कुछ। आइए शुरू करते हैं! +## कॉलम चार्ट क्या है और इसे क्यों उपयोग करें? -## लाइन चार्ट बनाना +कॉलम चार्ट श्रेणीबद्ध डेटा को वर्टिकल बार के रूप में दर्शाता है, जिससे समूहों (क्षेत्र अनुसार बिक्री, मासिक खर्च आदि) के बीच मानों की तुलना आसान हो जाती है। Java एप्लिकेशन में Aspose.Words के साथ कॉलम चार्ट जनरेट करने से आप इन विज़ुअल को सीधे Word / DOCX फ़ाइलों में एम्बेड कर सकते हैं, बिना Excel या बाहरी टूल्स की जरूरत के। -लाइन चार्ट बनाने के लिए निम्नलिखित कोड का उपयोग करें: +## कॉलम चार्ट कैसे बनाएं + +नीचे एक सरल उदाहरण है जो एक बेसिक कॉलम चार्ट बनाता है। कोड मूल स्निपेट जैसा ही है – हमने केवल समझाने वाले कमेंट्स जोड़े हैं ताकि इसे फॉलो करना आसान हो। + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### कई सीरीज़ जोड़ें + +आप **कई सीरीज़** को `chart.getSeries().add(...)` को बार‑बार कॉल करके कॉलम चार्ट में जोड़ सकते हैं, जैसा कि ऊपर दिखाया गया है। प्रत्येक सीरीज़ का अपना कैटेगरी और वैल्यू सेट हो सकता है, जिससे आप कई डेटा सेट साइड‑बाय‑साइड तुलना कर सकते हैं। + +## कस्टम डेटा लेबल वाले लाइन चार्ट कैसे बनाएं + +यदि आपको कॉलम चार्ट की बजाय लाइन चार्ट चाहिए, तो वही पैटर्न लागू होता है। यह उदाहरण भी **चार्ट डेटा लेबल फ़ॉर्मेट** को विभिन्न नंबर फ़ॉर्मेट के साथ दिखाता है। ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// डिफ़ॉल्ट रूप से उत्पन्न श्रृंखला को हटाएँ. +// Delete default generated series. chart.getSeries().clear(); -// डेटा और डेटा लेबल के साथ एक श्रृंखला जोड़ना. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// या प्रारूप कोड को स्रोत सेल से लिंक करें. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## अन्य प्रकार के चार्ट बनाना +### डेटा लेबल जोड़ें -आप समान तकनीकों का उपयोग करके कॉलम, क्षेत्र, बबल, स्कैटर आदि जैसे विभिन्न प्रकार के चार्ट बना सकते हैं। यहाँ एक सरल कॉलम चार्ट सम्मिलित करने का एक उदाहरण दिया गया है: +`series1.hasDataLabels(true)` कॉल **डेटा लेबल जोड़ती** है, जबकि `setShowValue(true)` चार्ट पर वास्तविक मान दिखाता है। -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// डिफ़ॉल्ट रूप से उत्पन्न श्रृंखला को हटाएँ. -chart.getSeries().clear(); - -// श्रेणियाँ बनाना और डेटा जोड़ना. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## अक्ष गुण अनुकूलित करना +## एक्सिस टाइप बदलें और एक्सिस प्रॉपर्टीज़ कस्टमाइज़ करें -आप अक्ष गुणों को अनुकूलित कर सकते हैं, जैसे कि अक्ष प्रकार बदलना, टिक मार्क सेट करना, लेबल फ़ॉर्मेट करना, और बहुत कुछ। यहाँ XY अक्ष गुणों को परिभाषित करने का एक उदाहरण दिया गया है: +एक्सिस टाइप बदलने (जैसे डेट से कैटेगरी) से आप डेटा पॉइंट्स के प्लॉटिंग को नियंत्रित कर सकते हैं। यह स्निपेट यह भी दिखाता है कि **चार्ट एक्सिस को छिपाया** जा सकता है यदि आप न्यूनतम डिज़ाइन पसंद करते हैं। ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// डिफ़ॉल्ट श्रृंखला साफ़ करें और अपना डेटा जोड़ें. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// X अक्ष को दिनांक के स्थान पर श्रेणी में बदलें। +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // वाई अक्ष (सैकड़ों) की प्रदर्शन इकाइयों में मापा जाता है। +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## डेटा लेबल का प्रारूपण +### एक्सिस टाइप बदलें -आप डेटा लेबल को अलग-अलग संख्या फ़ॉर्मेट में फ़ॉर्मेट कर सकते हैं। यहाँ एक उदाहरण दिया गया है: +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **एक्सिस टाइप** को डेट‑बेस्ड एक्सिस से कैटेगोरिकल में बदलता है, जिससे लेबल प्लेसमेंट पर पूरी नियंत्रण मिलती है। + +## चार्ट डेटा लेबल फ़ॉर्मेट करें (नंबर फ़ॉर्मेट) + +आप सीधे एक्सिस या डेटा लेबल पर नंबर फ़ॉर्मेट लागू कर सकते हैं। यह उदाहरण Y‑एक्सिस के नंबरों को थाउज़ेंड सेपरेटर के साथ फ़ॉर्मेट करता है। ```java Document doc = new Document(); @@ -116,50 +142,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// डिफ़ॉल्ट श्रृंखला साफ़ करें और अपना डेटा जोड़ें. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## अतिरिक्त चार्ट अनुकूलन - -आप सीमाओं, लेबल के बीच अंतराल इकाइयों, चार्ट अक्षों को छिपाने, और बहुत कुछ समायोजित करके अपने चार्ट को और भी अधिक अनुकूलित कर सकते हैं। इन विकल्पों के बारे में अधिक जानने के लिए दिए गए कोड स्निपेट देखें। +## अतिरिक्त चार्ट कस्टमाइज़ेशन -## निष्कर्ष - -इस ट्यूटोरियल में, हमने जावा के लिए Aspose.Words का उपयोग करके चार्ट के साथ काम करने का तरीका खोजा है। आपने सीखा है कि विभिन्न प्रकार के चार्ट कैसे बनाएं, अक्ष गुणों को अनुकूलित करें, डेटा लेबल को प्रारूपित करें, और बहुत कुछ। जावा के लिए Aspose.Words आपके दस्तावेज़ों में डेटा के दृश्य प्रतिनिधित्व जोड़ने के लिए शक्तिशाली उपकरण प्रदान करता है, जिससे आप जानकारी प्रस्तुत करने के तरीके को बेहतर बनाते हैं। +बेसिक से आगे, आप बाउंड्स एडजस्ट कर सकते हैं, लेबल्स के बीच इंटरवल यूनिट सेट कर सकते हैं, विशिष्ट एक्सिस को छिपा सकते हैं, आदि। पूरी प्रॉपर्टी सूची के लिए Aspose.Words for Java API डॉक्यूमेंटेशन देखें। ## अक्सर पूछे जाने वाले प्रश्न -### मैं एक चार्ट में एकाधिक श्रृंखलाएं कैसे जोड़ सकता हूं? - -आप इसका उपयोग करके चार्ट में एकाधिक श्रृंखलाएँ जोड़ सकते हैं `chart.getSeries().add()` विधि। श्रृंखला नाम, श्रेणियाँ और डेटा मान निर्दिष्ट करना सुनिश्चित करें। +**प्रश्न: मैं चार्ट में कई सीरीज़ कैसे जोड़ूँ?** +उत्तर: आप `chart.getSeries().add()` को प्रत्येक सीरीज़ के लिए उपयोग करें। प्रत्येक कॉल में यूनिक नाम, कैटेगरी एरे, और वैल्यू एरे प्रदान किया जा सकता है। -### मैं कस्टम संख्या प्रारूपों के साथ डेटा लेबल को कैसे प्रारूपित कर सकता हूं? +**प्रश्न: मैं कस्टम नंबर फ़ॉर्मेट के साथ चार्ट डेटा लेबल कैसे फ़ॉर्मेट करूँ?** +उत्तर: किसी सीरीज़ के `DataLabels` ऑब्जेक्ट को एक्सेस करें और `getNumberFormat().setFormatCode("your format")` कॉल करें। आप `isLinkedToSource(true)` के साथ फ़ॉर्मेट को स्रोत सेल से भी लिंक कर सकते हैं। -आप डेटा लेबल को एक्सेस करके फ़ॉर्मेट कर सकते हैं `DataLabels` किसी श्रृंखला के गुणधर्मों का उपयोग करके वांछित प्रारूप कोड सेट करना `getNumberFormat().setFormatCode()`. +**प्रश्न: मैं चार्ट एक्सिस को कैसे छिपा सकता हूँ?** +उत्तर: `ChartAxis` को आप छिपाना चाहते हैं, उस पर `setHidden(true)` कॉल करें (उदा., `chart.getAxisY().setHidden(true)` )। -### मैं चार्ट में अक्ष गुण कैसे अनुकूलित करूँ? +**प्रश्न: एक्सिस टाइप बदलने का सबसे अच्छा तरीका क्या है?** +उत्तर: कैटेगोरिकल एक्सिस के लिए `setCategoryType(AxisCategoryType.CATEGORY)` और डेट एक्सिस के लिए `AxisCategoryType.DATE` उपयोग करें। -आप एक्सेस करके अक्ष गुण जैसे प्रकार, टिक मार्क, लेबल और अधिक को अनुकूलित कर सकते हैं `ChartAxis` जैसे गुण `setCategoryType()`, `setCrosses()`, और `setMajorTickMark()`. +**प्रश्न: मैं सीरीज़ में डेटा लेबल कैसे जोड़ूँ?** +उत्तर: `series.hasDataLabels(true)` से उन्हें एनेबल करें और फिर `series.getDataLabels().setShowValue(true)` से विज़िबिलिटी कॉन्फ़िगर करें। -### मैं स्कैटर या क्षेत्र चार्ट जैसे अन्य प्रकार के चार्ट कैसे बना सकता हूं? - -आप उपयुक्त चार्ट निर्दिष्ट करके विभिन्न चार्ट प्रकार बना सकते हैं `ChartType` चार्ट का उपयोग करते समय `builder.insertChart(ChartType.TYPE, width, height)`. +## निष्कर्ष -### मैं चार्ट अक्ष को कैसे छिपा सकता हूँ? +हमने Aspose.Words for Java के साथ **कॉलम चार्ट** विज़ुअलाइज़ेशन बनाने के सभी आवश्यक पहलुओं को कवर किया—बेसिक चार्ट इन्सर्ट करना, कई सीरीज़ जोड़ना, चार्ट डेटा लेबल फ़ॉर्मेट करना, एक्सिस टाइप बदलना, और साफ़ लुक के लिए एक्सिस छिपाना। इन तकनीकों को अपने रिपोर्टिंग या डॉक्यूमेंट‑जनरेशन पाइपलाइन में इंटीग्रेट करें ताकि प्रोफेशनल, डेटा‑ड्रिवन Word दस्तावेज़ प्रदान कर सकें। -आप चार्ट अक्ष को सेट करके छिपा सकते हैं `setHidden(true)` अक्ष की संपत्ति. +--- +**अंतिम अपडेट:** 2025-12-13 +**टेस्टेड विद:** Aspose.Words for Java 24.12 (latest) +**लेखक:** 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/words/hongkong/java/document-conversion-and-export/using-charts/_index.md b/words/hongkong/java/document-conversion-and-export/using-charts/_index.md index d1758532c..2d863bccc 100644 --- a/words/hongkong/java/document-conversion-and-export/using-charts/_index.md +++ b/words/hongkong/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,11 @@ --- -"description": "了解如何在 Aspose.Words for Java 中建立和自訂圖表。探索資料視覺化的圖表類型、格式和軸屬性。" -"linktitle": "使用圖表" -"second_title": "Aspose.Words Java文件處理API" -"title": "在 Aspose.Words for Java 中使用圖表" -"url": "/zh-hant/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: 學習如何使用 Aspose.Words for Java 建立柱狀圖並設定圖表資料標籤。探索加入多個系列、變更軸類型以及隱藏圖表軸。 +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: 如何使用 Aspose.Words for Java 建立柱形圖 +url: /zh-hant/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +14,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# 在 Aspose.Words for Java 中使用圖表 +# 如何使用 Aspose.Words for Java 建立柱狀圖 +在本教學中，您將使用 Aspose.Words for Java 直接在 Word 文件中 **建立柱狀圖** 可視化。我們將逐步說明如何建立不同類型的圖表、加入多個資料系列、格式化圖表資料標籤、變更座標軸類型，甚至在需要更簡潔外觀時隱藏圖表座標軸。完成後，您將掌握一套穩固、可投入生產環境的方式，將豐富圖表嵌入文件中。 -## Aspose.Words for Java 圖表使用簡介 +## 快速答覆 +- **建立圖表的主要類別是什麼？** `DocumentBuilder` 搭配 `insertChart`。 +- **哪個方法可加入新系列？** `chart.getSeries().add(...)`。 +- **如何格式化圖表資料標籤？** 使用 `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`。 +- **我可以隱藏座標軸嗎？** 可以，對座標軸物件呼叫 `setHidden(true)`。 +- **使用 Aspose.Words 是否需要授權？** 生產環境必須購買授權；亦提供免費試用版。 -在本教程中，我們將探討如何使用 Aspose.Words for Java 處理圖表。您將學習如何建立各種類型的圖表、自訂軸屬性、格式化資料標籤等。讓我們開始吧！ +## 什麼是柱狀圖，為什麼要使用它？ -## 建立折線圖 +柱狀圖以垂直長條顯示類別資料，非常適合比較不同群組的數值（例如各區域銷售額、每月支出等）。在 Java 應用程式中，使用 Aspose.Words 產生柱狀圖，可直接將這些視覺化圖表嵌入 Word / DOCX 檔案，無需 Excel 或其他外部工具。 -若要建立折線圖，請使用以下程式碼： +## 如何建立柱狀圖 + +以下是一個簡單的範例，建立一個基本的柱狀圖。程式碼與原始片段完全相同，我們僅加入說明性註解以便於閱讀。 + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### 加入多個系列 + +您可以透過重複呼叫 `chart.getSeries().add(...)`，如上例所示，**加入多個系列** 到柱狀圖中。每個系列可擁有自己的類別與數值，讓您能夠並排比較多組資料。 + +## 如何建立帶自訂資料標籤的折線圖 + +若需要折線圖而非柱狀圖，使用方式相同。此範例同時示範如何以不同的數字格式 **格式化圖表資料標籤**。 ```java Document doc = new Document(); @@ -31,10 +65,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// 刪除預設產生的系列。 +// Delete default generated series. chart.getSeries().clear(); -// 新增帶有資料和資料標籤的系列。 +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +79,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// 或將格式代碼連結到來源單元格。 +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## 建立其他類型的圖表 +### 加入資料標籤 -您可以使用類似的技術來建立不同類型的圖表，例如長條圖、面積圖、氣泡圖、散點圖等。以下是插入簡單長條圖的範例： +呼叫 `series1.hasDataLabels(true)` **為系列加入資料標籤**，而 `setShowValue(true)` 則會在圖表上顯示實際數值。 -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// 刪除預設產生的系列。 -chart.getSeries().clear(); - -// 建立類別並新增資料。 -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## 自訂軸屬性 +## 如何變更座標軸類型與自訂座標軸屬性 -您可以自訂軸屬性，例如變更軸類型、設定刻度線、格式化標籤等。以下是定義 XY 軸屬性的範例： +變更座標軸類型（例如由日期軸改為類別軸）可控制資料點的繪製方式。此程式碼片段亦示範若想要極簡設計，如何 **隱藏圖表座標軸**。 ```java Document doc = new Document(); @@ -82,20 +99,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// 清除預設系列並新增您的資料。 +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// 將 X 軸更改為類別而不是日期。 +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // 以 Y 軸的顯示單位（百）來衡量。 +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +126,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## 格式化資料標籤 +### 變更座標軸類型 -您可以使用不同的數字格式來格式化資料標籤。以下是一個例子： +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **將座標軸類型** 從日期軸變更為類別軸，讓您完全掌控標籤的放置方式。 + +## 如何格式化圖表資料標籤（數字格式） + +您可以直接對座標軸或資料標籤套用數字格式。此範例將 Y 軸的數字以千位分隔符號顯示。 ```java Document doc = new Document(); @@ -116,50 +140,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// 清除預設系列並新增您的資料。 +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## 額外的圖表自訂 - -您可以透過調整邊界、標籤之間的間隔單位、隱藏圖表軸等來進一步自訂圖表。探索提供的程式碼片段以了解有關這些選項的更多資訊。 - -## 結論 - -在本教學中，我們探討如何使用 Aspose.Words for Java 處理圖表。您已經學習如何建立各種類型的圖表、自訂軸屬性、格式化資料標籤等等。 Aspose.Words for Java 提供了強大的工具，可將資料的視覺化表示新增至您的文件中，從而增強您呈現資訊的方式。 +## 其他圖表自訂功能 -## 常見問題解答 +除基本功能外，您還可以調整範圍、設定標籤之間的間隔單位、隱藏特定座標軸等。請參閱 Aspose.Words for Java API 文件，以取得完整屬性清單。 -### 如何為圖表新增多個系列？ +## 常見問題 -您可以使用 `chart.getSeries().add()` 方法。確保指定係列名稱、類別和資料值。 +**Q: 如何在圖表中加入多個系列？** +A: 對每個欲顯示的系列呼叫 `chart.getSeries().add()`。每次呼叫可提供唯一的名稱、類別陣列與數值陣列。 -### 如何使用自訂數字格式來格式化資料標籤？ +**Q: 如何使用自訂數字格式來格式化圖表資料標籤？** +A: 取得系列的 `DataLabels` 物件，並呼叫 `getNumberFormat().setFormatCode("your format")`。亦可使用 `isLinkedToSource(true)` 將格式連結至來源儲存格。 -您可以透過訪問 `DataLabels` 系列的屬性並使用設定所需的格式代碼 `getNumberFormat()。setFormatCode()`. +**Q: 如何隱藏圖表座標軸？** +A: 在欲隱藏的 `ChartAxis` 上呼叫 `setHidden(true)`（例如 `chart.getAxisY().setHidden(true)`）。 -### 如何自訂圖表中的軸屬性？ +**Q: 變更座標軸類型的最佳方式是什麼？** +A: 對類別座標軸使用 `setCategoryType(AxisCategoryType.CATEGORY)`，對日期座標軸使用 `AxisCategoryType.DATE`。 -您可以透過訪問 `ChartAxis` 類似屬性 `setCategoryType()`， `setCrosses()`， 和 `setMajorTickMark()`。 +**Q: 如何為系列加入資料標籤？** +A: 使用 `series.hasDataLabels(true)` 啟用，然後透過 `series.getDataLabels().setShowValue(true)` 設定可見性。 -### 如何建立其他類型的圖表，如散點圖或面積圖？ - -您可以透過指定適當的 `ChartType` 插入圖表時使用 `builder。insertChart(ChartType.TYPE, width, height)`. +## 結論 -### 如何隱藏圖表軸？ +我們已說明如何使用 Aspose.Words for Java **建立柱狀圖** 可視化——從插入基本圖表、加入多個系列、格式化圖表資料標籤、變更座標軸類型，到隱藏圖表座標軸以獲得簡潔外觀。將這些技巧整合至您的報表或文件產生流程，即可交付專業且以資料驅動的 Word 文件。 -您可以透過設定隱藏圖表軸 `setHidden(true)` 軸的屬性。 +--- +**最後更新：** 2025-12-13 +**測試環境：** Aspose.Words for Java 24.12 (latest) +**作者：** 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/words/hungarian/java/document-conversion-and-export/using-charts/_index.md b/words/hungarian/java/document-conversion-and-export/using-charts/_index.md index 6a06b105f..7d7688984 100644 --- a/words/hungarian/java/document-conversion-and-export/using-charts/_index.md +++ b/words/hungarian/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Ismerd meg, hogyan hozhatsz létre és szabhatsz testre diagramokat az Aspose.Words for Java programban. Ismerd meg a diagramtípusokat, a formázást és a tengelytulajdonságokat az adatvizualizációhoz." -"linktitle": "Diagramok használata" -"second_title": "Aspose.Words Java dokumentumfeldolgozó API" -"title": "Diagramok használata az Aspose.Words Java-ban" -"url": "/hu/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Ismerje meg, hogyan hozhat létre oszlopdiagramot és formázhatja a diagram + adatcímkéit az Aspose.Words for Java segítségével. Fedezze fel több sorozat hozzáadását, + a tengely típusának módosítását és a diagramtengely elrejtését. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Hogyan készítsünk oszlopdiagramot az Aspose.Words for Java használatával +url: /hu/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Diagramok használata az Aspose.Words Java-ban +# Hogyan hozzunk létre oszlopdiagramot az Aspose.Words for Java segítségével +Ebben az útmutatóban **oszlopdiagramot** fogsz létrehozni közvetlenül a Word‑dokumentumokban az Aspose.Words for Java használatával. Bemutatjuk, hogyan hozhatsz létre különböző diagramtípusokat, hogyan adhatod hozzá több sorozatot, hogyan formázhatod a diagram adatcímkéket, hogyan változtathatod meg a tengely típusát, és akár hogyan rejtheted el a diagram tengelyét, ha letisztultabb megjelenést szeretnél. A végére egy stabil, termelés‑kész megközelítést kapsz a gazdag diagramok beágyazásához a dokumentumaidba. -## Bevezetés a diagramok használatába az Aspose.Words Java-ban +## Gyors válaszok +- **Mi a fő osztály egy diagram felépítéséhez?** `DocumentBuilder` a `insertChart` metódussal. +- **Melyik metódus ad hozzá új sorozatot?** `chart.getSeries().add(...)`. +- **Hogyan formázhatom a diagram adatcímkéket?** Használd a `getDataLabels().get(...).getNumberFormat().setFormatCode(...)` hívást. +- **Elrejthetek egy tengelyt?** Igen, hívd meg a `setHidden(true)` metódust a tengely objektumon. +- **Szükség van licencre az Aspose.Words‑hez?** Licenc szükséges a termelési környezetben; ingyenes próba elérhető. -Ebben az oktatóanyagban azt vizsgáljuk meg, hogyan dolgozhatunk diagramokkal az Aspose.Words for Java használatával. Megtanulod, hogyan hozhatsz létre különféle típusú diagramokat, hogyan szabhatod testre a tengelyek tulajdonságait, hogyan formázhatod az adatfeliratokat és még sok mást. Vágjunk bele! +## Mi az az oszlopdiagram, és miért használjuk? -## Vonaldiagram létrehozása +Az oszlopdiagram a kategóriákat függőleges sávokként jeleníti meg, így ideális az értékek csoportok közötti összehasonlításához (pl. értékesítés régiónként, havi kiadások stb.). Java‑alkalmazásokban az Aspose.Words segítségével generált oszlopdiagram közvetlenül beágyazható a Word / DOCX fájlokba anélkül, hogy Excelre vagy külső eszközökre lenne szükség. -Vonaldiagram létrehozásához használja a következő kódot: +## Hogyan hozzunk létre oszlopdiagramot + +Az alábbi egyszerű példa egy alap oszlopdiagramot hoz létre. A kód megegyezik az eredeti snippet‑kel – csak magyarázó megjegyzéseket adtunk hozzá, hogy könnyebben követhető legyen. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Több sorozat hozzáadása + +**Több sorozatot** adhatsz hozzá egy oszlopdiagramhoz a `chart.getSeries().add(...)` ismételt meghívásával, ahogyan a fenti példában látható. Minden sorozat saját kategória‑ és értékkészlettel rendelkezhet, lehetővé téve több adathalmaz oldal‑oldali összehasonlítását. + +## Hogyan hozzunk létre vonaldiagramot egyedi adatcímkékkel + +Ha vonaldiagramra van szükséged az oszlopdiagram helyett, ugyanaz a minta alkalmazható. Ez a példa bemutatja, hogyan **formázhatod a diagram adatcímkéket** különböző számformátumokkal. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Alapértelmezetten generált sorozat törlése. +// Delete default generated series. chart.getSeries().clear(); -// Adatsorok hozzáadása adatokkal és adatcímkékkel. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Vagy csatolja a formátumkódot egy forráscellához. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Más típusú diagramok létrehozása +### Adatcímkék hozzáadása -Különböző típusú diagramokat hozhat létre, például oszlop-, terület-, buborék-, szórt- és egyéb diagramokat hasonló technikákkal. Íme egy példa egy egyszerű oszlopdiagram beszúrására: +A `series1.hasDataLabels(true)` **adatcímkéket ad** a sorozathoz, míg a `setShowValue(true)` megjeleníti a tényleges értékeket a diagramon. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Alapértelmezetten generált sorozat törlése. -chart.getSeries().clear(); - -// Kategóriák létrehozása és adatok hozzáadása. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` +## Hogyan változtassuk meg a tengely típusát és testre szabjuk a tengely tulajdonságait -## Tengelytulajdonságok testreszabása - -Testreszabhatja a tengelyek tulajdonságait, például módosíthatja a tengely típusát, beállíthat osztásjeleket, formázhatja a feliratokat és egyebeket. Íme egy példa az XY tengely tulajdonságainak definiálására: +A tengely típusának módosítása (pl. dátumtól kategóriáig) lehetővé teszi, hogy szabályozd, hogyan kerülnek ábrázolásra az adatpontok. Ez a snippet azt is mutatja, hogyan **rejtsd el a diagram tengelyét**, ha minimalista megjelenést szeretnél. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Töröld az alapértelmezett sorozatokat, és add hozzá az adataidat. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Módosítsa az X tengelyt úgy, hogy dátum helyett kategória legyen. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Az Y tengely megjelenítési egységeiben mérve (százas). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Adatcímkék formázása +### Tengely típusának módosítása + +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **módosítja a tengely típusát** egy dátumalapú tengelyről kategóriálisra, így teljes kontrollt kapsz a címkék elhelyezése felett. -Az adatfeliratokat különböző számformátumokkal formázhatja. Íme egy példa: +## Hogyan formázzuk a diagram adatcímkéket (számformátumok) + +A számformátumok közvetlenül a tengelyre vagy az adatcímkékre alkalmazhatók. Ez a példa az Y‑tengely számait ezres elválasztóval formázza. ```java Document doc = new Document(); @@ -116,50 +142,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Töröld az alapértelmezett sorozatokat, és add hozzá az adataidat. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## További diagram-testreszabási lehetőségek - -A diagramokat tovább testreszabhatja a határok, a címkék közötti intervallumegységek módosításával, a diagramtengelyek elrejtésével és egyebekkel. A mellékelt kódrészletekből többet is megtudhat ezekről a lehetőségekről. - -## Következtetés +## További diagram testreszabások -Ebben az oktatóanyagban azt vizsgáltuk meg, hogyan dolgozhatunk diagramokkal az Aspose.Words for Java segítségével. Megtanultuk, hogyan hozhatunk létre különféle típusú diagramokat, hogyan szabhatjuk testre a tengelytulajdonságokat, hogyan formázhatjuk az adatfeliratokat és egyebeket. Az Aspose.Words for Java hatékony eszközöket biztosít az adatok vizuális ábrázolásainak hozzáadásához a dokumentumokhoz, javítva az információk bemutatásának módját. +Az alapok mellett beállíthatod a határokat, meghatározhatod a címkék közötti intervallum egységeket, elrejtheted a specifikus tengelyeket, és még sok mást. Tekintsd meg az Aspose.Words for Java API dokumentációját a teljes tulajdonságlistáért. -## GYIK +## Gyakran ismételt kérdések -### Hogyan adhatok hozzá több adatsort egy diagramhoz? +**K: Hogyan adhatok hozzá több sorozatot egy diagramhoz?** +V: Használd a `chart.getSeries().add()` metódust minden egyes sorozathoz, amelyet meg szeretnél jeleníteni. Minden hívás megadhat egyedi nevet, kategória‑tömböt és érték‑tömböt. -Több adatsort is hozzáadhat egy diagramhoz a `chart.getSeries().add()` metódus. Feltétlenül adja meg a sorozat nevét, a kategóriákat és az adatértékeket. +**K: Hogyan formázhatom a diagram adatcímkéket egyedi számformátumokkal?** +V: Szerezz hozzá egy sorozat `DataLabels` objektumához, majd hívd meg a `getNumberFormat().setFormatCode("your format")` metódust. A formátumot összekapcsolhatod egy forráscellával a `isLinkedToSource(true)` segítségével is. -### Hogyan formázhatom az adatfeliratokat egyéni számformátumokkal? +**K: Hogyan rejthetem el egy diagram tengelyét?** +V: Hívd meg a `setHidden(true)` metódust a kívánt `ChartAxis` objektumon (pl. `chart.getAxisY().setHidden(true)`). -Az adatcímkéket a következővel formázhatja: `DataLabels` egy sorozat tulajdonságai és a kívánt formátumkód beállítása a `getNumberFormat().setFormatCode()`. +**K: Mi a legjobb módja a tengely típusának módosítására?** +V: Használd a `setCategoryType(AxisCategoryType.CATEGORY)`-t a kategóriális tengelyekhez, vagy az `AxisCategoryType.DATE`-t a dátumtengelyekhez. -### Hogyan szabhatom testre a tengelytulajdonságokat egy diagramban? +**K: Hogyan adhatok adatcímkéket egy sorozathoz?** +V: Engedélyezd őket a `series.hasDataLabels(true)` hívással, majd állítsd be a láthatóságot a `series.getDataLabels().setShowValue(true)` metódussal. -A tengelyek tulajdonságait, például a típust, az osztásjeleket, a feliratokat és egyebeket testreszabhatja a `ChartAxis` olyan tulajdonságok, mint `setCategoryType()`, `setCrosses()`, és `setMajorTickMark()`. +## Összegzés -### Hogyan hozhatok létre más típusú diagramokat, például szóródási vagy területdiagramokat? +Mindezt lefedtük, ami ahhoz szükséges, hogy **oszlopdiagramot** hozz létre az Aspose.Words for Java‑val – az alap diagramok beszúrásától a több sorozatos ábrákon át a diagram adatcímkék formázásáig, a tengely típusának módosításáig és a tengelyek elrejtéséig egy tiszta megjelenés érdekében. Alkalmazd ezeket a technikákat jelentés‑ vagy dokumentum‑generálási folyamataidban, hogy professzionális, adat‑vezérelt Word‑dokumentumokat szállíts. -Különböző diagramtípusokat hozhat létre a megfelelő megadásával `ChartType` diagram beillesztésekor a következő használatával: `builder.insertChart(ChartType.TYPE, width, height)`. - -### Hogyan rejthetek el egy diagramtengelyt? - -A diagramtengely elrejtéséhez állítsa be a `setHidden(true)` a tengely tulajdonsága. +--- +**Utoljára frissítve:** 2025-12-13 +**Tesztelve a következővel:** Aspose.Words for Java 24.12 (legújabb) +**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/words/indonesian/java/document-conversion-and-export/using-charts/_index.md b/words/indonesian/java/document-conversion-and-export/using-charts/_index.md index ab1ee2f20..eceee344d 100644 --- a/words/indonesian/java/document-conversion-and-export/using-charts/_index.md +++ b/words/indonesian/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Pelajari cara membuat dan menyesuaikan bagan di Aspose.Words untuk Java. Jelajahi jenis bagan, pemformatan, dan properti sumbu untuk visualisasi data." -"linktitle": "Menggunakan Grafik" -"second_title": "API Pemrosesan Dokumen Java Aspose.Words" -"title": "Menggunakan Bagan di Aspose.Words untuk Java" -"url": "/id/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Pelajari cara membuat diagram kolom dan memformat label data diagram + dengan Aspose.Words untuk Java. Jelajahi penambahan beberapa seri, mengubah tipe + sumbu, dan menyembunyikan sumbu diagram. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Cara membuat diagram kolom menggunakan Aspose.Words untuk Java +url: /id/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Menggunakan Bagan di Aspose.Words untuk Java +# Cara Membuat Diagram Kolom Menggunakan Aspose.Words untuk Java +Dalam tutorial ini Anda akan **membuat visualisasi diagram kolom** langsung di dalam dokumen Word menggunakan Aspose.Words untuk Java. Kami akan membahas cara membuat berbagai tipe diagram, menambahkan beberapa seri, memformat label data diagram, mengubah tipe sumbu, dan bahkan menyembunyikan sumbu diagram ketika Anda memerlukan tampilan yang lebih bersih. Pada akhir tutorial Anda akan memiliki pendekatan yang solid dan siap produksi untuk menyematkan diagram kaya ke dalam dokumen Anda. -## Pengantar Penggunaan Grafik di Aspose.Words untuk Java +## Jawaban Cepat +- **Kelas utama apa yang digunakan untuk membuat diagram?** `DocumentBuilder` dengan `insertChart`. +- **Metode apa yang menambahkan seri baru?** `chart.getSeries().add(...)`. +- **Bagaimana cara memformat label data diagram?** Gunakan `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Bisakah saya menyembunyikan sebuah sumbu?** Ya, panggil `setHidden(true)` pada objek sumbu. +- **Apakah saya memerlukan lisensi untuk Aspose.Words?** Lisensi diperlukan untuk penggunaan produksi; versi percobaan gratis tersedia. -Dalam tutorial ini, kita akan mempelajari cara bekerja dengan grafik menggunakan Aspose.Words untuk Java. Anda akan mempelajari cara membuat berbagai jenis grafik, menyesuaikan properti sumbu, memformat label data, dan banyak lagi. Mari kita mulai! +## Apa itu diagram kolom dan mengapa menggunakannya? -## Membuat Diagram Garis +Diagram kolom menampilkan data kategorikal sebagai batang vertikal, menjadikannya ideal untuk membandingkan nilai antar grup (penjualan per wilayah, pengeluaran bulanan, dll.). Dalam aplikasi Java, menghasilkan diagram kolom dengan Aspose.Words memungkinkan Anda menyematkan visual ini langsung ke dalam file Word / DOCX tanpa memerlukan Excel atau alat eksternal. -Untuk membuat diagram garis, gunakan kode berikut: +## Cara membuat diagram kolom + +Berikut adalah contoh sederhana yang membuat diagram kolom dasar. Kode ini identik dengan cuplikan asli – kami hanya menambahkan komentar penjelas agar lebih mudah diikuti. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Menambahkan beberapa seri + +Anda dapat **menambahkan beberapa seri** ke diagram kolom dengan memanggil `chart.getSeries().add(...)` berulang kali, seperti yang ditunjukkan di atas. Setiap seri dapat memiliki kumpulan kategori dan nilai masing‑masing, memungkinkan Anda membandingkan beberapa set data secara berdampingan. + +## Cara membuat diagram garis dengan label data khusus + +Jika Anda memerlukan diagram garis alih‑alih diagram kolom, pola yang sama dapat diterapkan. Contoh ini juga menunjukkan **memformat label data diagram** dengan format angka yang berbeda. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Hapus seri yang dihasilkan secara default. +// Delete default generated series. chart.getSeries().clear(); -// Menambahkan seri dengan data dan label data. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Atau tautan kode format ke sel sumber. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Membuat Jenis Grafik Lainnya +### Menambahkan label data -Anda dapat membuat berbagai jenis bagan seperti kolom, area, gelembung, sebaran, dan lainnya menggunakan teknik yang serupa. Berikut ini contoh penyisipan bagan kolom sederhana: +Pemanggilan `series1.hasDataLabels(true)` **menambahkan label data** ke seri, sementara `setShowValue(true)` membuat nilai aktual terlihat pada diagram. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Hapus seri yang dihasilkan secara default. -chart.getSeries().clear(); - -// Membuat kategori dan menambahkan data. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## Menyesuaikan Properti Sumbu +## Cara mengubah tipe sumbu dan menyesuaikan properti sumbu -Anda dapat menyesuaikan properti sumbu, seperti mengubah jenis sumbu, menetapkan tanda centang, memformat label, dan banyak lagi. Berikut ini contoh penetapan properti sumbu XY: +Mengubah tipe sumbu (misalnya, dari tanggal ke kategori) memberi Anda kontrol atas cara titik data dipetakan. Cuplikan ini juga menunjukkan cara **menyembunyikan sumbu diagram** jika Anda menginginkan desain minimalis. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Hapus seri default dan tambahkan data Anda. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Ubah sumbu X menjadi kategori, bukan tanggal. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Diukur dalam satuan tampilan sumbu Y (ratusan). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Memformat Label Data +### Mengubah tipe sumbu -Anda dapat memformat label data dengan format angka yang berbeda. Berikut contohnya: +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **mengubah tipe sumbu** dari sumbu berbasis tanggal menjadi sumbu kategorikal, memberi Anda kontrol penuh atas penempatan label. + +## Cara memformat label data diagram (format angka) + +Anda dapat menerapkan pemformatan angka langsung ke sumbu atau label data. Contoh ini memformat angka pada sumbu Y dengan pemisah ribuan. ```java Document doc = new Document(); @@ -116,50 +142,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Hapus seri default dan tambahkan data Anda. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## Kustomisasi Bagan Tambahan - -Anda dapat menyesuaikan diagram lebih lanjut dengan menyesuaikan batas, satuan interval antara label, menyembunyikan sumbu diagram, dan banyak lagi. Jelajahi cuplikan kode yang disediakan untuk mempelajari lebih lanjut tentang opsi ini. +## Kustomisasi diagram tambahan -## Kesimpulan - -Dalam tutorial ini, kami telah mempelajari cara bekerja dengan bagan menggunakan Aspose.Words untuk Java. Anda telah mempelajari cara membuat berbagai jenis bagan, menyesuaikan properti sumbu, memformat label data, dan banyak lagi. Aspose.Words untuk Java menyediakan alat yang hebat untuk menambahkan representasi visual data ke dokumen Anda, meningkatkan cara Anda menyajikan informasi. +Selain dasar‑dasarnya, Anda dapat menyesuaikan batas, mengatur interval antar label, menyembunyikan sumbu tertentu, dan lain‑lain. Lihat dokumentasi API Aspose.Words untuk Java untuk daftar lengkap properti. ## Pertanyaan yang Sering Diajukan -### Bagaimana cara menambahkan beberapa seri ke bagan? - -Anda dapat menambahkan beberapa seri ke bagan menggunakan `chart.getSeries().add()` metode. Pastikan untuk menentukan nama seri, kategori, dan nilai data. +**T: Bagaimana cara menambahkan beberapa seri ke sebuah diagram?** +J: Gunakan `chart.getSeries().add()` untuk setiap seri yang ingin Anda tampilkan. Setiap pemanggilan dapat menyediakan nama unik, array kategori, dan array nilai. -### Bagaimana cara memformat label data dengan format angka khusus? +**T: Bagaimana cara memformat label data diagram dengan format angka khusus?** +J: Akses objek `DataLabels` pada seri dan panggil `getNumberFormat().setFormatCode("format Anda")`. Anda juga dapat menautkan format ke sel sumber dengan `isLinkedToSource(true)`. -Anda dapat memformat label data dengan mengakses `DataLabels` properti seri dan pengaturan kode format yang diinginkan menggunakan `getNumberFormat().setFormatCode()`. +**T: Bagaimana cara menyembunyikan sebuah sumbu diagram?** +J: Panggil `setHidden(true)` pada `ChartAxis` yang ingin Anda sembunyikan (misalnya, `chart.getAxisY().setHidden(true)`). -### Bagaimana cara menyesuaikan properti sumbu dalam bagan? +**T: Apa cara terbaik untuk mengubah tipe sumbu?** +J: Gunakan `setCategoryType(AxisCategoryType.CATEGORY)` untuk sumbu kategorikal atau `AxisCategoryType.DATE` untuk sumbu tanggal. -Anda dapat menyesuaikan properti sumbu seperti jenis, tanda centang, label, dan lainnya dengan mengakses `ChartAxis` properti seperti `setCategoryType()`Bahasa Indonesia: `setCrosses()`, Dan `setMajorTickMark()`. +**T: Bagaimana cara menambahkan label data ke sebuah seri?** +J: Aktifkan dengan `series.hasDataLabels(true)` lalu konfigurasikan visibilitas menggunakan `series.getDataLabels().setShowValue(true)`. -### Bagaimana cara membuat jenis grafik lain seperti grafik sebar atau area? - -Anda dapat membuat berbagai jenis grafik dengan menentukan jenis yang sesuai `ChartType` saat memasukkan grafik menggunakan `builder.insertChart(ChartType.TYPE, width, height)`. +## Kesimpulan -### Bagaimana cara menyembunyikan sumbu grafik? +Kami telah membahas semua yang Anda perlukan untuk **membuat visualisasi diagram kolom** dengan Aspose.Words untuk Java—dari menyisipkan diagram dasar dan menambahkan beberapa seri, hingga memformat label data diagram, mengubah tipe sumbu, dan menyembunyikan sumbu diagram untuk tampilan bersih. Terapkan teknik ini ke dalam pipeline pelaporan atau pembuatan dokumen Anda untuk menghasilkan dokumen Word profesional yang didorong oleh data. -Anda dapat menyembunyikan sumbu grafik dengan mengatur `setHidden(true)` properti sumbu. +--- +**Terakhir Diperbarui:** 2025-12-13 +**Diuji Dengan:** Aspose.Words untuk Java 24.12 (terbaru) +**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/words/italian/java/document-conversion-and-export/using-charts/_index.md b/words/italian/java/document-conversion-and-export/using-charts/_index.md index 346f9c030..b241394a7 100644 --- a/words/italian/java/document-conversion-and-export/using-charts/_index.md +++ b/words/italian/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Scopri come creare e personalizzare grafici in Aspose.Words per Java. Esplora i tipi di grafico, la formattazione e le proprietà degli assi per la visualizzazione dei dati." -"linktitle": "Utilizzo dei grafici" -"second_title": "API di elaborazione dei documenti Java Aspose.Words" -"title": "Utilizzo di grafici in Aspose.Words per Java" -"url": "/it/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Scopri come creare un grafico a colonne e formattare le etichette dei + dati del grafico con Aspose.Words per Java. Esplora l'aggiunta di più serie, la + modifica del tipo di asse e la possibilità di nascondere l'asse del grafico. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Come creare un grafico a colonne usando Aspose.Words per Java +url: /it/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Utilizzo di grafici in Aspose.Words per Java +# Come creare un grafico a colonne usando Aspose.Words per Java +In questo tutorial **creerai visualizzazioni di grafici a colonne** direttamente all'interno di documenti Word usando Aspose.Words per Java. Vedremo come creare diversi tipi di grafico, aggiungere più serie, formattare le etichette dei dati del grafico, cambiare il tipo di asse e persino nascondere un asse del grafico quando è necessario un aspetto più pulito. Alla fine avrai un approccio solido, pronto per la produzione, per incorporare grafici ricchi nei tuoi documenti. -## Introduzione all'uso dei grafici in Aspose.Words per Java +## Risposte rapide +- **Qual è la classe principale per costruire un grafico?** `DocumentBuilder` con `insertChart`. +- **Quale metodo aggiunge una nuova serie?** `chart.getSeries().add(...)`. +- **Come formattare le etichette dei dati del grafico?** Usa `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Posso nascondere un asse?** Sì, chiama `setHidden(true)` sull'oggetto asse. +- **È necessaria una licenza per Aspose.Words?** È richiesta una licenza per l'uso in produzione; è disponibile una versione di prova gratuita. -In questo tutorial, esploreremo come lavorare con i grafici utilizzando Aspose.Words per Java. Imparerai a creare diversi tipi di grafici, personalizzare le proprietà degli assi, formattare le etichette dati e altro ancora. Iniziamo subito! +## Che cos'è un grafico a colonne e perché usarlo? -## Creazione di un grafico a linee +Un grafico a colonne visualizza dati categorici come barre verticali, rendendolo ideale per confrontare valori tra gruppi (vendite per regione, spese mensili, ecc.). Nelle applicazioni Java, generare un grafico a colonne con Aspose.Words ti consente di incorporare queste visualizzazioni direttamente nei file Word / DOCX senza dover ricorrere a Excel o strumenti esterni. -Per creare un grafico a linee, utilizzare il seguente codice: +## Come creare un grafico a colonne + +Di seguito trovi un esempio semplice che crea un grafico a colonne. Il codice è identico allo snippet originale – abbiamo aggiunto solo commenti esplicativi per renderlo più facile da seguire. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Aggiungere più serie + +Puoi **aggiungere più serie** a un grafico a colonne chiamando ripetutamente `chart.getSeries().add(...)`, come mostrato sopra. Ogni serie può avere il proprio insieme di categorie e valori, consentendoti di confrontare diversi set di dati fianco a fianco. + +## Come creare un grafico a linee con etichette dati personalizzate + +Se ti serve un grafico a linee invece di un grafico a colonne, lo stesso schema si applica. Questo esempio dimostra anche come **formattare le etichette dei dati del grafico** con formati numerici diversi. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Elimina le serie generate di default. +// Delete default generated series. chart.getSeries().clear(); -// Aggiungere una serie con dati ed etichette dati. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Oppure collega il codice di formato a una cella di origine. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Creazione di altri tipi di grafici +### Aggiungere etichette dati -È possibile creare diversi tipi di grafici, come a colonne, ad area, a bolle, a dispersione e altri ancora, utilizzando tecniche simili. Ecco un esempio di inserimento di un semplice grafico a colonne: +La chiamata `series1.hasDataLabels(true)` **aggiunge etichette dati** alla serie, mentre `setShowValue(true)` rende visibili i valori effettivi sul grafico. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Elimina le serie generate di default. -chart.getSeries().clear(); - -// Creazione di categorie e aggiunta di dati. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## Personalizzazione delle proprietà degli assi +## Come cambiare il tipo di asse e personalizzare le proprietà dell'asse -È possibile personalizzare le proprietà degli assi, ad esempio modificandone il tipo, impostando le tacche, formattando le etichette e altro ancora. Ecco un esempio di definizione delle proprietà degli assi XY: +Cambiare il tipo di asse (ad esempio da data a categoria) ti permette di controllare come i punti dati vengono tracciati. Questo snippet mostra anche come **nascondere l'asse del grafico** se preferisci un design minimalista. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Cancella le serie predefinite e aggiungi i tuoi dati. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Modificare l'asse X in modo che sia una categoria anziché una data. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Misurato in unità di visualizzazione dell'asse Y (centinaia). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Formattazione delle etichette dati +### Cambiare il tipo di asse -È possibile formattare le etichette dati con diversi formati numerici. Ecco un esempio: +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **cambia il tipo di asse** da un asse basato su data a uno categorico, offrendoti il pieno controllo sul posizionamento delle etichette. + +## Come formattare le etichette dei dati del grafico (formati numerici) + +Puoi applicare la formattazione numerica direttamente all'asse o alle etichette dei dati. Questo esempio formatta i numeri dell'asse Y con un separatore delle migliaia. ```java Document doc = new Document(); @@ -116,50 +142,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Cancella le serie predefinite e aggiungi i tuoi dati. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## Ulteriori personalizzazioni del grafico - -Puoi personalizzare ulteriormente i tuoi grafici modificando i limiti, le unità di intervallo tra le etichette, nascondendo gli assi del grafico e altro ancora. Esplora i frammenti di codice forniti per saperne di più su queste opzioni. +## Personalizzazioni aggiuntive del grafico -## Conclusione - -In questo tutorial abbiamo esplorato come lavorare con i grafici utilizzando Aspose.Words per Java. Hai imparato a creare diversi tipi di grafici, personalizzare le proprietà degli assi, formattare le etichette dati e altro ancora. Aspose.Words per Java offre potenti strumenti per aggiungere rappresentazioni visive dei dati ai tuoi documenti, migliorando il modo in cui presenti le informazioni. +Oltre alle basi, puoi regolare i limiti, impostare unità di intervallo tra le etichette, nascondere assi specifici e molto altro. Consulta la documentazione dell'API Aspose.Words per Java per l'elenco completo delle proprietà. ## Domande frequenti -### Come posso aggiungere più serie a un grafico? - -È possibile aggiungere più serie a un grafico utilizzando `chart.getSeries().add()` metodo. Assicurati di specificare il nome della serie, le categorie e i valori dei dati. +**D: Come posso aggiungere più serie a un grafico?** +R: Usa `chart.getSeries().add()` per ogni serie che desideri visualizzare. Ogni chiamata può fornire un nome unico, un array di categorie e un array di valori. -### Come posso formattare le etichette dati con formati numerici personalizzati? +**D: Come formattare le etichette dei dati del grafico con formati numerici personalizzati?** +R: Accedi all'oggetto `DataLabels` di una serie e chiama `getNumberFormat().setFormatCode("il tuo formato")`. Puoi anche collegare il formato a una cella di origine con `isLinkedToSource(true)`. -È possibile formattare le etichette dati accedendo a `DataLabels` proprietà di una serie e impostazione del codice di formato desiderato utilizzando `getNumberFormat().setFormatCode()`. +**D: Come posso nascondere un asse del grafico?** +R: Chiama `setHidden(true)` sul `ChartAxis` che desideri nascondere (ad esempio `chart.getAxisY().setHidden(true)`). -### Come posso personalizzare le proprietà degli assi in un grafico? +**D: Qual è il modo migliore per cambiare il tipo di asse?** +R: Usa `setCategoryType(AxisCategoryType.CATEGORY)` per assi categorici o `AxisCategoryType.DATE` per assi basati su data. -È possibile personalizzare le proprietà dell'asse come tipo, segni di spunta, etichette e altro ancora accedendo a `ChartAxis` proprietà come `setCategoryType()`, `setCrosses()`, E `setMajorTickMark()`. +**D: Come aggiungere etichette dati a una serie?** +R: Abilita le etichette con `series.hasDataLabels(true)` e poi configura la visibilità usando `series.getDataLabels().setShowValue(true)`. -### Come posso creare altri tipi di grafici, come grafici a dispersione o ad area? - -È possibile creare vari tipi di grafici specificando l'appropriato `ChartType` quando si inserisce il grafico utilizzando `builder.insertChart(ChartType.TYPE, width, height)`. +## Conclusione -### Come posso nascondere un asse di un grafico? +Abbiamo coperto tutto ciò che ti serve per **creare visualizzazioni di grafici a colonne** con Aspose.Words per Java—dall'inserimento di grafici di base e l'aggiunta di più serie, alla formattazione delle etichette dei dati, al cambiamento del tipo di asse e al nascondere gli assi per un aspetto pulito. Integra queste tecniche nei tuoi flussi di reporting o di generazione di documenti per fornire documenti Word professionali e basati sui dati. -È possibile nascondere un asse del grafico impostando `setHidden(true)` proprietà dell'asse. +--- +**Ultimo aggiornamento:** 2025-12-13 +**Testato con:** Aspose.Words per Java 24.12 (ultima versione) +**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/words/japanese/java/document-conversion-and-export/using-charts/_index.md b/words/japanese/java/document-conversion-and-export/using-charts/_index.md index 34dcbab88..fb4c4f63a 100644 --- a/words/japanese/java/document-conversion-and-export/using-charts/_index.md +++ b/words/japanese/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,11 @@ --- -"description": "Aspose.Words for Javaでグラフを作成およびカスタマイズする方法を学びます。グラフの種類、書式設定、軸のプロパティを活用して、データを視覚化します。" -"linktitle": "チャートの使用" -"second_title": "Aspose.Words Java ドキュメント処理 API" -"title": "Aspose.Words for Java でチャートを使用する" -"url": "/ja/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Aspose.Words for Java を使用して、縦棒グラフの作成方法とグラフのデータ ラベルの書式設定方法を学びます。複数の系列の追加、軸タイプの変更、軸の非表示についても探ります。 +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Aspose.Words for Java を使用して柱状グラフを作成する方法 +url: /ja/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +14,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Aspose.Words for Java でチャートを使用する +# Aspose.Words for Java を使用して縦棒グラフを作成する方法 +このチュートリアルでは、Aspose.Words for Java を使用して Word 文書内に **縦棒グラフ** を直接作成します。さまざまなグラフタイプの作成、複数シリーズの追加、グラフデータラベルの書式設定、軸タイプの変更、さらにはクリーンな外観が必要なときに軸を非表示にする方法まで順を追って解説します。最後まで読めば、ドキュメントにリッチなグラフを埋め込むための堅牢で本番環境向けのアプローチが身につきます。 -## Aspose.Words for Java でのチャートの使い方入門 +## クイック回答 +- **チャートを作成するための主要クラスは何ですか？** `DocumentBuilder` と `insertChart`。 +- **新しいシリーズを追加するメソッドはどれですか？** `chart.getSeries().add(...)`。 +- **チャートのデータラベルをフォーマットするには？** `getDataLabels().get(...).getNumberFormat().setFormatCode(...)` を使用します。 +- **軸を非表示にできますか？** はい、軸オブジェクトで `setHidden(true)` を呼び出します。 +- **Aspose.Words のライセンスは必要ですか？** 本番環境で使用するにはライセンスが必要です。無料トライアルも利用可能です。 -このチュートリアルでは、Aspose.Words for Java を使ってグラフを操作する方法を学びます。さまざまな種類のグラフの作成方法、軸プロパティのカスタマイズ方法、データラベルの書式設定方法などを学びます。さあ、始めましょう！ +## 縦棒グラフとは何か、なぜ使用するのか -## 折れ線グラフを作成する +縦棒グラフはカテゴリデータを垂直の棒で表現し、グループ間の値比較（地域別売上、月次費用など）に最適です。Java アプリケーションで Aspose.Words を使用して縦棒グラフを生成すれば、Excel や外部ツールを使わずに Word / DOCX ファイルに直接ビジュアルを埋め込むことができます。 -折れ線グラフを作成するには、次のコードを使用します。 +## 縦棒グラフの作成方法 + +以下はシンプルな縦棒グラフを作成する基本例です。コードは元のスニペットと同一で、理解しやすいように説明コメントを追加しています。 + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### 複数シリーズの追加 + +`chart.getSeries().add(...)` を繰り返し呼び出すことで **複数シリーズ** を縦棒グラフに追加できます。各シリーズは独自のカテゴリと値のセットを持ち、複数のデータセットを横並びで比較できます。 + +## カスタムデータラベル付き折れ線グラフの作成方法 + +縦棒グラフの代わりに折れ線グラフが必要な場合も、同様の手順で作成できます。この例では **異なる数値形式でデータラベルをフォーマット** する方法も示しています。 ```java Document doc = new Document(); @@ -31,10 +65,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// デフォルトで生成されたシリーズを削除します。 +// Delete default generated series. chart.getSeries().clear(); -// データとデータ ラベルを含むシリーズを追加します。 +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +79,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// または、書式コードをソース セルにリンクします。 +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## 他の種類のグラフを作成する +### データラベルの追加 -同様のテクニックを使って、縦棒グラフ、面グラフ、バブルグラフ、散布図など、さまざまな種類のグラフを作成できます。以下は、シンプルな縦棒グラフを挿入する例です。 +`series1.hasDataLabels(true)` はシリーズに **データラベルを追加** し、`setShowValue(true)` によって実際の数値をグラフ上に表示します。 -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// デフォルトで生成されたシリーズを削除します。 -chart.getSeries().clear(); - -// カテゴリを作成し、データを追加します。 -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## 軸プロパティのカスタマイズ +## 軸タイプの変更と軸プロパティのカスタマイズ方法 -軸の種類の変更、目盛りの設定、ラベルの書式設定など、軸のプロパティをカスタマイズできます。以下はXY軸のプロパティを定義する例です。 +軸タイプ（例：日付軸からカテゴリ軸への変更）を変更すると、データポイントのプロット方法を制御できます。このスニペットでは、ミニマリストデザインを好む場合に **軸を非表示** にする方法も示しています。 ```java Document doc = new Document(); @@ -82,20 +99,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// デフォルトのシリーズをクリアしてデータを追加します。 +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// X 軸を日付ではなくカテゴリに変更します。 +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Y 軸の表示単位 (百) で測定されます。 +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +126,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## データラベルの書式設定 +### 軸タイプの変更 -データラベルはさまざまな数値書式で書式設定できます。例を以下に示します。 +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` は **軸タイプ** を日付ベースからカテゴリベースに変更し、ラベル配置を自由にコントロールできるようにします。 + +## チャートデータラベルのフォーマット（数値形式） + +数値書式は軸やデータラベルに直接適用できます。この例では Y 軸の数値に千位区切りを付けています。 ```java Document doc = new Document(); @@ -116,7 +140,7 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// デフォルトのシリーズをクリアしてデータを追加します。 +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); @@ -125,41 +149,39 @@ doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ## 追加のチャートカスタマイズ -境界線、ラベル間の間隔、グラフ軸の非表示などを調整することで、グラフをさらにカスタマイズできます。これらのオプションの詳細については、提供されているコードスニペットをご覧ください。 - -## 結論 - -このチュートリアルでは、Aspose.Words for Java を使ってグラフを操作する方法を解説しました。さまざまな種類のグラフの作成方法、軸プロパティのカスタマイズ方法、データラベルの書式設定方法などを学習しました。Aspose.Words for Java は、ドキュメントにデータの視覚的な表現を追加し、情報の提示方法を向上させる強力なツールを提供します。 +基本に加えて、表示範囲の調整、ラベル間の間隔設定、特定軸の非表示など、さまざまなカスタマイズが可能です。詳細は Aspose.Words for Java API ドキュメントをご参照ください。 ## よくある質問 -### グラフに複数のシリーズを追加するにはどうすればよいですか? - -複数の系列をチャートに追加するには、 `chart.getSeries().add()` 方法。系列名、カテゴリ、データ値を必ず指定してください。 +**Q: チャートに複数のシリーズを追加するにはどうすればよいですか？** +A: 表示したい各シリーズに対して `chart.getSeries().add()` を使用します。各呼び出しで固有の名前、カテゴリ配列、値配列を指定できます。 -### カスタム数値形式でデータ ラベルをフォーマットするにはどうすればよいですか? +**Q: カスタム数値形式でチャートのデータラベルをフォーマットするには？** +A: シリーズの `DataLabels` オブジェクトにアクセスし、`getNumberFormat().setFormatCode("your format")` を呼び出します。`isLinkedToSource(true)` を使用して元セルの書式にリンクさせることも可能です。 -データラベルの書式設定は、 `DataLabels` シリーズのプロパティと、希望する書式コードの設定 `getNumberFormat()。setFormatCode()`. +**Q: チャートの軸を非表示にするには？** +A: 非表示にしたい `ChartAxis`（例：`chart.getAxisY()`）で `setHidden(true)` を呼び出します。 -### グラフの軸プロパティをカスタマイズするにはどうすればよいですか? +**Q: 軸タイプを変更する最適な方法は？** +A: カテゴリ軸には `setCategoryType(AxisCategoryType.CATEGORY)`、日付軸には `AxisCategoryType.DATE` を使用します。 -軸の種類、目盛り、ラベルなどの軸プロパティをカスタマイズするには、 `ChartAxis` 次のような特性 `setCategoryType()`、 `setCrosses()`、 そして `setMajorTickMark()`。 +**Q: シリーズにデータラベルを追加するには？** +A: `series.hasDataLabels(true)` で有効化し、`series.getDataLabels().setShowValue(true)` で表示設定を行います。 -### 散布図や面グラフなどの他の種類のグラフを作成するにはどうすればよいですか? - -適切な値を指定することで、さまざまなチャートタイプを作成できます。 `ChartType` チャートを挿入するときに `builder。insertChart(ChartType.TYPE, width, height)`. +## 結論 -### グラフの軸を非表示にするにはどうすればいいですか? +Aspose.Words for Java を使用した **縦棒グラフ** の作成方法を網羅しました。基本的なグラフの挿入、複数シリーズの追加、データラベルの書式設定、軸タイプの変更、そしてクリーンな外観のための軸非表示まで、レポートや文書生成パイプラインにこれらのテクニックを組み込むことで、プロフェッショナルでデータ駆動型の Word 文書を提供できます。 -チャートの軸を非表示にするには、 `setHidden(true)` 軸のプロパティ。 +--- +**Last Updated:** 2025-12-13 +**Tested With:** Aspose.Words for Java 24.12 (latest) +**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/words/korean/java/document-conversion-and-export/using-charts/_index.md b/words/korean/java/document-conversion-and-export/using-charts/_index.md index 0a72a79ea..dc58cd2b2 100644 --- a/words/korean/java/document-conversion-and-export/using-charts/_index.md +++ b/words/korean/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,12 @@ --- -"description": "Aspose.Words for Java에서 차트를 만들고 사용자 지정하는 방법을 알아보세요. 데이터 시각화를 위한 차트 유형, 서식 및 축 속성을 살펴보세요." -"linktitle": "차트 사용" -"second_title": "Aspose.Words Java 문서 처리 API" -"title": "Java용 Aspose.Words에서 차트 사용하기" -"url": "/ko/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Aspose.Words for Java를 사용하여 열 차트를 만들고 차트 데이터 레이블을 서식 지정하는 방법을 배웁니다. 여러 + 시리즈 추가, 축 유형 변경 및 차트 축 숨기기를 탐색합니다. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Aspose.Words for Java를 사용하여 열 차트 만드는 방법 +url: /ko/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +15,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Java용 Aspose.Words에서 차트 사용하기 +# Aspose.Words for Java를 사용하여 열 차트 만들기 +이 튜토리얼에서는 Aspose.Words for Java를 사용해 Word 문서 안에 **열 차트** 시각화를 직접 생성합니다. 다양한 차트 유형 만들기, 여러 시리즈 추가, 차트 데이터 레이블 서식 지정, 축 유형 변경, 필요에 따라 차트 축을 숨겨 깔끔하게 보이게 하는 방법을 단계별로 안내합니다. 마지막까지 따라하면 문서에 풍부한 차트를 삽입할 수 있는 실무 수준의 방법을 익히게 됩니다. -## Aspose.Words for Java에서 차트 사용 소개 +## 빠른 답변 +- **차트를 만들기 위한 기본 클래스는?** `DocumentBuilder`와 `insertChart`. +- **새 시리즈를 추가하는 메서드는?** `chart.getSeries().add(...)`. +- **차트 데이터 레이블을 어떻게 서식 지정하나요?** `getDataLabels().get(...).getNumberFormat().setFormatCode(...)` 사용. +- **축을 숨길 수 있나요?** 네, 축 객체에 `setHidden(true)`를 호출하면 됩니다. +- **Aspose.Words에 라이선스가 필요합니까?** 프로덕션 사용 시 라이선스가 필요하며, 무료 체험판을 제공하고 있습니다. -이 튜토리얼에서는 Aspose.Words for Java를 사용하여 차트를 만드는 방법을 살펴보겠습니다. 다양한 유형의 차트를 만들고, 축 속성을 사용자 정의하고, 데이터 레이블을 서식 지정하는 방법 등을 배우게 됩니다. 시작해 볼까요! +## 열 차트란 무엇이며 왜 사용하나요? -## 선형 차트 만들기 +열 차트는 범주형 데이터를 수직 막대로 표시하여 그룹 간 값을 비교하기에 적합합니다(예: 지역별 매출, 월별 지출 등). Java 애플리케이션에서 Aspose.Words를 사용해 열 차트를 생성하면 Excel이나 외부 도구 없이도 Word / DOCX 파일에 직접 시각화를 삽입할 수 있습니다. -선형 차트를 만들려면 다음 코드를 사용하세요. +## 열 차트 만들기 + +아래는 간단한 열 차트를 생성하는 예제입니다. 원본 코드와 동일하며 이해를 돕기 위해 설명 주석만 추가했습니다. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### 여러 시리즈 추가 + +`chart.getSeries().add(...)`를 반복 호출하면 **여러 시리즈**를 열 차트에 추가할 수 있습니다. 각 시리즈는 자체 카테고리와 값을 가질 수 있어 여러 데이터 세트를 나란히 비교할 수 있습니다. + +## 사용자 지정 데이터 레이블이 있는 선 차트 만들기 + +열 차트 대신 선 차트가 필요하다면 동일한 패턴을 적용하면 됩니다. 이 예제는 **차트 데이터 레이블 서식 지정**을 다양한 숫자 형식으로 적용하는 방법도 보여줍니다. ```java Document doc = new Document(); @@ -31,10 +66,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// 기본으로 생성된 시리즈를 삭제합니다. +// Delete default generated series. chart.getSeries().clear(); -// 데이터와 데이터 레이블이 있는 시리즈를 추가합니다. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +80,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// 또는 소스 셀에 형식 코드를 연결합니다. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## 다른 유형의 차트 만들기 +### 데이터 레이블 추가 -비슷한 기법을 사용하여 세로 막대형, 영역형, 거품형, 분산형 등 다양한 유형의 차트를 만들 수 있습니다. 간단한 세로 막대형 차트를 삽입하는 예시는 다음과 같습니다. +`series1.hasDataLabels(true)` 호출은 시리즈에 **데이터 레이블**을 추가하고, `setShowValue(true)`는 차트에 실제 값을 표시합니다. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// 기본으로 생성된 시리즈를 삭제합니다. -chart.getSeries().clear(); - -// 카테고리를 만들고 데이터를 추가합니다. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## 축 속성 사용자 정의 +## 축 유형 변경 및 축 속성 사용자 지정 -축 유형 변경, 눈금 설정, 레이블 서식 지정 등 축 속성을 사용자 지정할 수 있습니다. 다음은 XY 축 속성을 정의하는 예입니다. +축 유형을 변경(예: 날짜 축에서 범주 축으로)하면 데이터 포인트가 표시되는 방식을 제어할 수 있습니다. 또한 **차트 축 숨기기**를 통해 미니멀리즘 디자인을 구현하는 방법도 포함되어 있습니다. ```java Document doc = new Document(); @@ -82,20 +100,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// 기본 시리즈를 지우고 데이터를 추가하세요. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// 날짜 대신 범주를 X축으로 변경하세요. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Y축의 표시 단위(백)로 측정됩니다. +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +127,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## 데이터 레이블 서식 지정 +### 축 유형 변경 -데이터 레이블의 서식을 다양한 숫자 형식으로 지정할 수 있습니다. 예를 들어 다음과 같습니다. +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **축 유형**을 날짜 기반 축에서 범주형 축으로 바꾸어 레이블 배치를 자유롭게 제어할 수 있습니다. + +## 차트 데이터 레이블 서식 지정(숫자 형식) + +축이나 데이터 레이블에 직접 숫자 서식을 적용할 수 있습니다. 이 예제는 Y축 숫자를 천 단위 구분 기호가 포함된 형식으로 포맷합니다. ```java Document doc = new Document(); @@ -116,50 +141,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// 기본 시리즈를 지우고 데이터를 추가하세요. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## 추가 차트 사용자 정의 - -경계, 레이블 간 간격 단위, 차트 축 숨기기 등을 조정하여 차트를 더욱 세부적으로 사용자 지정할 수 있습니다. 제공된 코드 조각을 통해 이러한 옵션에 대해 자세히 알아보세요. +## 추가 차트 사용자 지정 -## 결론 - -이 튜토리얼에서는 Aspose.Words for Java를 사용하여 차트를 만드는 방법을 살펴보았습니다. 다양한 유형의 차트를 만들고, 축 속성을 사용자 정의하고, 데이터 레이블을 서식 지정하는 방법 등을 알아보았습니다. Aspose.Words for Java는 문서에 데이터를 시각적으로 표현하여 정보를 표현하는 방식을 향상시키는 강력한 도구를 제공합니다. +기본 기능 외에도 차트 경계 조정, 레이블 간 간격 단위 설정, 특정 축 숨기기 등 다양한 옵션을 활용할 수 있습니다. 전체 속성 목록은 Aspose.Words for Java API 문서를 참고하세요. ## 자주 묻는 질문 -### 차트에 여러 시리즈를 추가하려면 어떻게 해야 하나요? - -차트에 여러 시리즈를 추가하려면 다음을 사용하십시오. `chart.getSeries().add()` 메서드입니다. 시리즈 이름, 범주 및 데이터 값을 반드시 지정하세요. +**Q: 차트에 여러 시리즈를 어떻게 추가하나요?** +A: 표시하려는 각 시리즈마다 `chart.getSeries().add()`를 사용합니다. 각 호출에 고유한 이름, 카테고리 배열, 값 배열을 전달할 수 있습니다. -### 사용자 지정 숫자 서식을 사용하여 데이터 레이블을 어떻게 서식 지정할 수 있나요? +**Q: 사용자 지정 숫자 형식으로 차트 데이터 레이블을 어떻게 서식 지정하나요?** +A: 시리즈의 `DataLabels` 객체에 접근한 뒤 `getNumberFormat().setFormatCode("your format")`을 호출합니다. `isLinkedToSource(true)`를 사용해 형식을 원본 셀에 연결할 수도 있습니다. -데이터 레이블을 형식화하려면 다음을 수행하세요. `DataLabels` 시리즈의 속성 및 원하는 형식 코드 설정 `getNumberFormat().setFormatCode()`. +**Q: 차트 축을 숨기려면 어떻게 하나요?** +A: 숨기려는 `ChartAxis`에 `setHidden(true)`를 호출합니다(예: `chart.getAxisY().setHidden(true)`). -### 차트의 축 속성을 사용자 지정하려면 어떻게 해야 하나요? +**Q: 축 유형을 가장 효율적으로 변경하는 방법은?** +A: 범주형 축은 `setCategoryType(AxisCategoryType.CATEGORY)`, 날짜 축은 `AxisCategoryType.DATE`를 사용합니다. -축 속성(유형, 눈금 표시, 레이블 등)을 사용자 정의하려면 다음을 수행하세요. `ChartAxis` 같은 속성 `setCategoryType()`, `setCrosses()`, 그리고 `setMajorTickMark()`. +**Q: 시리즈에 데이터 레이블을 추가하려면?** +A: `series.hasDataLabels(true)`로 활성화한 뒤 `series.getDataLabels().setShowValue(true)`로 표시 여부를 설정합니다. -### 산점형 차트나 영역형 차트 등 다른 유형의 차트는 어떻게 만들 수 있나요? - -적절한 차트 유형을 지정하여 다양한 차트 유형을 만들 수 있습니다. `ChartType` 차트를 삽입할 때 `builder.insertChart(ChartType.TYPE, width, height)`. +## 결론 -### 차트 축을 숨기려면 어떻게 해야 하나요? +Aspose.Words for Java를 사용해 **열 차트** 시각화를 만드는 모든 과정을 살펴보았습니다. 기본 차트 삽입, 여러 시리즈 추가, 차트 데이터 레이블 서식 지정, 축 유형 변경, 차트 축 숨기기 등을 통해 깔끔하고 전문적인 데이터 기반 Word 문서를 만들 수 있습니다. 이러한 기술을 보고서나 문서 자동 생성 파이프라인에 적용해 보세요. -차트 축을 설정하여 숨길 수 있습니다. `setHidden(true)` 축의 속성. +--- +**마지막 업데이트:** 2025-12-13 +**테스트 환경:** Aspose.Words for Java 24.12 (최신) +**작성자:** 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/words/polish/java/document-conversion-and-export/using-charts/_index.md b/words/polish/java/document-conversion-and-export/using-charts/_index.md index bcb341566..2e5e1e169 100644 --- a/words/polish/java/document-conversion-and-export/using-charts/_index.md +++ b/words/polish/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Dowiedz się, jak tworzyć i dostosowywać wykresy w Aspose.Words for Java. Poznaj typy wykresów, formatowanie i właściwości osi do wizualizacji danych." -"linktitle": "Korzystanie z wykresów" -"second_title": "Aspose.Words API przetwarzania dokumentów Java" -"title": "Korzystanie z wykresów w Aspose.Words dla Java" -"url": "/pl/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Dowiedz się, jak tworzyć wykres słupkowy i formatować etykiety danych + wykresu przy użyciu Aspose.Words for Java. Poznaj dodawanie wielu serii, zmianę + typu osi oraz ukrywanie osi wykresu. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Jak utworzyć wykres słupkowy przy użyciu Aspose.Words dla Javy +url: /pl/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Korzystanie z wykresów w Aspose.Words dla Java +# Jak stworzyć wykres słupkowy przy użyciu Aspose.Words for Java +W tym samouczku **stworzysz wykres słupkowy** wizualizacje bezpośrednio w dokumentach Word przy użyciu Aspose.Words for Java. Przejdziemy przez tworzenie różnych typów wykresów, dodawanie wielu serii, formatowanie etykiet danych wykresu, zmianę typu osi oraz ukrywanie osi wykresu, gdy potrzebny jest czystszy wygląd. Po zakończeniu będziesz mieć solidne, gotowe do produkcji podejście do osadzania bogatych wykresów w swoich dokumentach. -## Wprowadzenie do korzystania z wykresów w Aspose.Words dla Java +## Szybkie odpowiedzi +- **Jaka jest podstawowa klasa do tworzenia wykresu?** `DocumentBuilder` z `insertChart`. +- **Która metoda dodaje nową serię?** `chart.getSeries().add(...)`. +- **Jak sformatować etykiety danych wykresu?** Użyj `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Czy mogę ukryć oś?** Tak, wywołaj `setHidden(true)` na obiekcie osi. +- **Czy potrzebna jest licencja na Aspose.Words?** Licencja jest wymagana do użytku produkcyjnego; dostępna jest darmowa wersja próbna. -W tym samouczku pokażemy, jak pracować z wykresami przy użyciu Aspose.Words for Java. Dowiesz się, jak tworzyć różne typy wykresów, dostosowywać właściwości osi, formatować etykiety danych i nie tylko. Zanurzmy się! +## Czym jest wykres słupkowy i dlaczego go używać? -## Tworzenie wykresu liniowego +Wykres słupkowy wyświetla dane kategorialne jako pionowe słupki, co czyni go idealnym do porównywania wartości pomiędzy grupami (sprzedaż w regionie, miesięczne wydatki itp.). W aplikacjach Java generowanie wykresu słupkowego przy użyciu Aspose.Words pozwala osadzać te wizualizacje bezpośrednio w plikach Word / DOCX bez potrzeby korzystania z Excela lub zewnętrznych narzędzi. -Aby utworzyć wykres liniowy, użyj następującego kodu: +## Jak stworzyć wykres słupkowy + +Poniżej znajduje się prosty przykład, który tworzy prosty wykres słupkowy. Kod jest identyczny jak w oryginalnym fragmencie – dodaliśmy jedynie komentarze wyjaśniające, aby ułatwić zrozumienie. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Dodaj wiele serii + +Możesz **dodać wiele serii** do wykresu słupkowego, wywołując wielokrotnie `chart.getSeries().add(...)`, jak pokazano powyżej. Każda seria może mieć własny zestaw kategorii i wartości, co pozwala porównywać kilka zestawów danych obok siebie. + +## Jak stworzyć wykres liniowy z niestandardowymi etykietami danych + +Jeśli potrzebujesz wykresu liniowego zamiast słupkowego, obowiązuje ten sam schemat. Ten przykład również pokazuje **formatowanie etykiet danych wykresu** przy użyciu różnych formatów liczbowych. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Usuń domyślnie wygenerowaną serię. +// Delete default generated series. chart.getSeries().clear(); -// Dodawanie serii z danymi i etykietami danych. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Lub połącz kod formatu z komórką źródłową. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Tworzenie innych typów wykresów +### Dodaj etykiety danych -Możesz tworzyć różne typy wykresów, takie jak kolumnowy, obszarowy, bąbelkowy, punktowy i inne, używając podobnych technik. Oto przykład wstawiania prostego wykresu kolumnowego: +Wywołanie `series1.hasDataLabels(true)` **dodaje etykiety danych** do serii, natomiast `setShowValue(true)` sprawia, że rzeczywiste wartości są widoczne na wykresie. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Usuń domyślnie wygenerowaną serię. -chart.getSeries().clear(); - -// Tworzenie kategorii i dodawanie danych. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` +## Jak zmienić typ osi i dostosować właściwości osi -## Dostosowywanie właściwości osi - -Możesz dostosować właściwości osi, takie jak zmiana typu osi, ustawienie znaczników, formatowanie etykiet i wiele więcej. Oto przykład definiowania właściwości osi XY: +Zmiana typu osi (np. z daty na kategorię) pozwala kontrolować sposób rysowania punktów danych. Ten fragment kodu również pokazuje, jak **ukryć oś wykresu**, jeśli preferujesz minimalistyczny projekt. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Wyczyść domyślne serie i dodaj swoje dane. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Zmień oś X tak, aby przedstawiała kategorię zamiast daty. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Mierzone w jednostkach wyświetlanych na osi Y (setkach). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Formatowanie etykiet danych +### Zmień typ osi + +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **zmienia typ osi** z oś opartej na dacie na oś kategorialną, dając pełną kontrolę nad rozmieszczeniem etykiet. -Możesz formatować etykiety danych za pomocą różnych formatów liczb. Oto przykład: +## Jak formatować etykiety danych wykresu (formaty liczbowe) + +Możesz zastosować formatowanie liczb bezpośrednio do osi lub etykiet danych. Ten przykład formatuje liczby na osi Y przy użyciu separatora tysięcy. ```java Document doc = new Document(); @@ -116,7 +142,7 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Wyczyść domyślne serie i dodaj swoje dane. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); @@ -125,41 +151,39 @@ doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ## Dodatkowe dostosowania wykresu -Możesz dalej dostosowywać swoje wykresy, dostosowując granice, jednostki interwału między etykietami, ukrywając osie wykresu i nie tylko. Przeglądaj dostarczone fragmenty kodu, aby dowiedzieć się więcej o tych opcjach. - -## Wniosek - -tym samouczku przyjrzeliśmy się, jak pracować z wykresami przy użyciu Aspose.Words for Java. Nauczyłeś się, jak tworzyć różne typy wykresów, dostosowywać właściwości osi, formatować etykiety danych i nie tylko. Aspose.Words for Java udostępnia potężne narzędzia do dodawania wizualnych reprezentacji danych do dokumentów, ulepszając sposób prezentacji informacji. +Poza podstawami możesz dostosować granice, ustawić jednostki interwału między etykietami, ukrywać konkretne osie i wiele więcej. Odwołaj się do dokumentacji API Aspose.Words for Java, aby uzyskać pełną listę właściwości. ## Najczęściej zadawane pytania -### Jak mogę dodać wiele serii do wykresu? +**Q: Jak mogę dodać wiele serii do wykresu?** +A: Użyj `chart.getSeries().add()` dla każdej serii, którą chcesz wyświetlić. Każde wywołanie może dostarczyć unikalną nazwę, tablicę kategorii i tablicę wartości. -Do wykresu można dodać wiele serii za pomocą `chart.getSeries().add()` metoda. Upewnij się, że określiłeś nazwę serii, kategorie i wartości danych. +**Q: Jak sformatować etykiety danych wykresu przy użyciu niestandardowych formatów liczbowych?** +A: Uzyskaj dostęp do obiektu `DataLabels` serii i wywołaj `getNumberFormat().setFormatCode("your format")`. Możesz także powiązać format z komórką źródłową przy użyciu `isLinkedToSource(true)`. -### Jak mogę sformatować etykiety danych, używając niestandardowych formatów liczb? +**Q: Jak mogę ukryć oś wykresu?** +A: Wywołaj `setHidden(true)` na obiekcie `ChartAxis`, który chcesz ukryć (np. `chart.getAxisY().setHidden(true)`). -Możesz sformatować etykiety danych, uzyskując dostęp do `DataLabels` właściwości serii i ustawienie żądanego kodu formatu za pomocą `getNumberFormat().setFormatCode()`. +**Q: Jaki jest najlepszy sposób na zmianę typu osi?** +A: Użyj `setCategoryType(AxisCategoryType.CATEGORY)` dla osi kategorialnych lub `AxisCategoryType.DATE` dla osi datowych. -### Jak dostosować właściwości osi na wykresie? +**Q: Jak dodać etykiety danych do serii?** +A: Włącz je za pomocą `series.hasDataLabels(true)`, a następnie skonfiguruj widoczność używając `series.getDataLabels().setShowValue(true)`. -Możesz dostosować właściwości osi, takie jak typ, znaczniki, etykiety i inne, uzyskując dostęp do `ChartAxis` właściwości takie jak `setCategoryType()`, `setCrosses()`, I `setMajorTickMark()`. +## Podsumowanie -### Jak mogę tworzyć inne rodzaje wykresów, np. wykresy punktowe lub wykresy powierzchniowe? +Omówiliśmy wszystko, co potrzebne, aby **stworzyć wykres słupkowy** wizualizacje przy użyciu Aspose.Words for Java — od wstawiania podstawowych wykresów i dodawania wielu serii, po formatowanie etykiet danych wykresu, zmianę typu osi oraz ukrywanie osi wykresu dla czystego wyglądu. Włącz te techniki do swoich procesów raportowania lub generowania dokumentów, aby dostarczać profesjonalne, oparte na danych dokumenty Word. -Możesz tworzyć różne typy wykresów, określając odpowiednie `ChartType` podczas wstawiania wykresu za pomocą `builder.insertChart(ChartType.TYPE, width, height)`. - -### Jak mogę ukryć oś wykresu? - -Możesz ukryć oś wykresu, ustawiając `setHidden(true)` Własność osi. +--- +**Ostatnia aktualizacja:** 2025-12-13 +**Testowano z:** Aspose.Words for Java 24.12 (latest) +**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/words/portuguese/java/document-conversion-and-export/using-charts/_index.md b/words/portuguese/java/document-conversion-and-export/using-charts/_index.md index e9bdd4bf2..4001aca01 100644 --- a/words/portuguese/java/document-conversion-and-export/using-charts/_index.md +++ b/words/portuguese/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Aprenda a criar e personalizar gráficos no Aspose.Words para Java. Explore tipos de gráficos, formatação e propriedades de eixo para visualização de dados." -"linktitle": "Usando gráficos" -"second_title": "API de processamento de documentos Java Aspose.Words" -"title": "Usando gráficos no Aspose.Words para Java" -"url": "/pt/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Aprenda a criar um gráfico de colunas e formatar os rótulos de dados + do gráfico com Aspose.Words para Java. Explore a adição de várias séries, a alteração + do tipo de eixo e a ocultação do eixo do gráfico. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Como criar gráfico de colunas usando Aspose.Words para Java +url: /pt/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Usando gráficos no Aspose.Words para Java +# Como criar um gráfico de colunas usando Aspose.Words para Java +Neste tutorial você **criará visualizações de gráfico de colunas** diretamente dentro de documentos Word usando Aspose.Words para Java. Vamos percorrer a criação de diferentes tipos de gráfico, a adição de múltiplas séries, a formatação de rótulos de dados do gráfico, a alteração do tipo de eixo e até mesmo a ocultação de um eixo do gráfico quando precisar de um visual mais limpo. Ao final, você terá uma abordagem sólida e pronta para produção para incorporar gráficos ricos em seus documentos. -## Introdução ao uso de gráficos no Aspose.Words para Java +## Respostas Rápidas +- **Qual é a classe principal para construir um gráfico?** `DocumentBuilder` com `insertChart`. +- **Qual método adiciona uma nova série?** `chart.getSeries().add(...)`. +- **Como formato os rótulos de dados do gráfico?** Use `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Posso ocultar um eixo?** Sim, chame `setHidden(true)` no objeto do eixo. +- **Preciso de licença para Aspose.Words?** Uma licença é necessária para uso em produção; uma versão de avaliação gratuita está disponível. -Neste tutorial, exploraremos como trabalhar com gráficos usando o Aspose.Words para Java. Você aprenderá a criar vários tipos de gráficos, personalizar propriedades de eixos, formatar rótulos de dados e muito mais. Vamos lá! +## O que é um gráfico de colunas e por que usá-lo? -## Criando um gráfico de linhas +Um gráfico de colunas exibe dados categóricos como barras verticais, tornando-o ideal para comparar valores entre grupos (vendas por região, despesas mensais, etc.). Em aplicações Java, gerar um gráfico de colunas com Aspose.Words permite incorporar esses visuais diretamente em arquivos Word / DOCX sem precisar do Excel ou de ferramentas externas. -Para criar um gráfico de linhas, use o seguinte código: +## Como criar um gráfico de colunas + +Abaixo está um exemplo simples que cria um gráfico de colunas básico. O código é idêntico ao trecho original – adicionamos apenas comentários explicativos para facilitar o entendimento. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Adicionar múltiplas séries + +Você pode **adicionar múltiplas séries** a um gráfico de colunas chamando `chart.getSeries().add(...)` repetidamente, como mostrado acima. Cada série pode ter seu próprio conjunto de categorias e valores, permitindo comparar vários conjuntos de dados lado a lado. + +## Como criar um gráfico de linhas com rótulos de dados personalizados + +Se precisar de um gráfico de linhas em vez de um gráfico de colunas, o mesmo padrão se aplica. Este exemplo também demonstra **formatar rótulos de dados do gráfico** com diferentes formatos numéricos. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Excluir série gerada padrão. +// Delete default generated series. chart.getSeries().clear(); -// Adicionando uma série com dados e rótulos de dados. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Ou vincule o código de formato a uma célula de origem. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Criando outros tipos de gráficos +### Adicionar rótulos de dados -Você pode criar diferentes tipos de gráficos, como colunas, áreas, bolhas, dispersão e muito mais, usando técnicas semelhantes. Veja um exemplo de como inserir um gráfico de colunas simples: +A chamada `series1.hasDataLabels(true)` **adiciona rótulos de dados** à série, enquanto `setShowValue(true)` torna os valores reais visíveis no gráfico. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Excluir série gerada padrão. -chart.getSeries().clear(); - -// Criando categorias e adicionando dados. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## Personalizando Propriedades do Eixo +## Como alterar o tipo de eixo e personalizar propriedades do eixo -Você pode personalizar as propriedades do eixo, como alterar o tipo de eixo, definir marcas de escala, formatar rótulos e muito mais. Veja um exemplo de definição das propriedades do eixo XY: +Alterar o tipo de eixo (por exemplo, de data para categoria) permite controlar como os pontos de dados são plotados. Este trecho também mostra como **ocultar o eixo do gráfico** se preferir um design minimalista. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Limpe as séries padrão e adicione seus dados. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Altere o eixo X para ser uma categoria em vez de uma data. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Medido em unidades de exibição do eixo Y (centenas). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Formatando rótulos de dados +### Alterar tipo de eixo -Você pode formatar rótulos de dados com diferentes formatos numéricos. Veja um exemplo: +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **altera o tipo de eixo** de um eixo baseado em datas para um eixo categórico, dando controle total sobre a colocação dos rótulos. + +## Como formatar rótulos de dados do gráfico (formatos numéricos) + +Você pode aplicar formatação numérica diretamente ao eixo ou aos rótulos de dados. Este exemplo formata os números do eixo Y com um separador de milhares. ```java Document doc = new Document(); @@ -116,7 +142,7 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Limpe as séries padrão e adicione seus dados. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); @@ -125,41 +151,39 @@ doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ## Personalizações adicionais de gráficos -Você pode personalizar ainda mais seus gráficos ajustando limites, unidades de intervalo entre rótulos, ocultando eixos do gráfico e muito mais. Explore os trechos de código fornecidos para saber mais sobre essas opções. - -## Conclusão - -Neste tutorial, exploramos como trabalhar com gráficos usando o Aspose.Words para Java. Você aprendeu a criar vários tipos de gráficos, personalizar propriedades de eixos, formatar rótulos de dados e muito mais. O Aspose.Words para Java oferece ferramentas poderosas para adicionar representações visuais de dados aos seus documentos, aprimorando a forma como você apresenta informações. - -## Perguntas frequentes +Além do básico, você pode ajustar limites, definir unidades de intervalo entre rótulos, ocultar eixos específicos e muito mais. Consulte a documentação da API Aspose.Words para Java para obter uma lista completa de propriedades. -### Como posso adicionar várias séries a um gráfico? +## Perguntas Frequentes -Você pode adicionar várias séries a um gráfico usando o `chart.getSeries().add()` método. Certifique-se de especificar o nome da série, as categorias e os valores dos dados. +**Q: Como posso adicionar múltiplas séries a um gráfico?** +A: Use `chart.getSeries().add()` para cada série que desejar exibir. Cada chamada pode fornecer um nome exclusivo, um array de categorias e um array de valores. -### Como posso formatar rótulos de dados com formatos numéricos personalizados? +**Q: Como formato rótulos de dados do gráfico com formatos numéricos personalizados?** +A: Acesse o objeto `DataLabels` de uma série e chame `getNumberFormat().setFormatCode("seu formato")`. Você também pode vincular o formato a uma célula de origem com `isLinkedToSource(true)`. -Você pode formatar rótulos de dados acessando o `DataLabels` propriedades de uma série e definindo o código de formato desejado usando `getNumberFormat().setFormatCode()`. +**Q: Como posso ocultar um eixo do gráfico?** +A: Chame `setHidden(true)` no `ChartAxis` que deseja ocultar (por exemplo, `chart.getAxisY().setHidden(true)`). -### Como posso personalizar as propriedades do eixo em um gráfico? +**Q: Qual a melhor forma de alterar o tipo de eixo?** +A: Use `setCategoryType(AxisCategoryType.CATEGORY)` para eixos categóricos ou `AxisCategoryType.DATE` para eixos de data. -Você pode personalizar as propriedades do eixo, como tipo, marcas de escala, rótulos e muito mais acessando o `ChartAxis` propriedades como `setCategoryType()`, `setCrosses()`, e `setMajorTickMark()`. +**Q: Como adiciono rótulos de dados a uma série?** +A: Habilite-os com `series.hasDataLabels(true)` e então configure a visibilidade usando `series.getDataLabels().setShowValue(true)`. -### Como posso criar outros tipos de gráficos, como gráficos de dispersão ou de área? - -Você pode criar vários tipos de gráficos especificando o apropriado `ChartType` ao inserir o gráfico usando `builder.insertChart(ChartType.TYPE, width, height)`. +## Conclusão -### Como posso ocultar um eixo do gráfico? +Cobremos tudo o que você precisa para **criar visualizações de gráfico de colunas** com Aspose.Words para Java — desde inserir gráficos básicos e adicionar múltiplas séries, até formatar rótulos de dados, alterar o tipo de eixo e ocultar eixos para um visual limpo. Incorpore essas técnicas em seus pipelines de relatórios ou geração de documentos para entregar documentos Word profissionais e orientados por dados. -Você pode ocultar um eixo do gráfico definindo o `setHidden(true)` propriedade do eixo. +--- +**Última atualização:** 2025-12-13 +**Testado com:** Aspose.Words para Java 24.12 (mais recente) +**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/words/russian/java/document-conversion-and-export/using-charts/_index.md b/words/russian/java/document-conversion-and-export/using-charts/_index.md index a41917823..6d0e42747 100644 --- a/words/russian/java/document-conversion-and-export/using-charts/_index.md +++ b/words/russian/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Узнайте, как создавать и настраивать диаграммы в Aspose.Words для Java. Изучите типы диаграмм, форматирование и свойства осей для визуализации данных." -"linktitle": "Использование диаграмм" -"second_title": "API обработки документов Java Aspose.Words" -"title": "Использование диаграмм в Aspose.Words для Java" -"url": "/ru/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Изучите, как создавать столбчатую диаграмму и форматировать подписи данных + диаграммы с помощью Aspose.Words для Java. Узнайте, как добавлять несколько рядов, + менять тип оси и скрывать ось диаграммы. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Как создать столбчатую диаграмму с помощью Aspose.Words для Java +url: /ru/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Использование диаграмм в Aspose.Words для Java +# Как создать столбчатую диаграмму с помощью Aspose.Words для Java +В этом руководстве вы **создадите столбчатую диаграмму** непосредственно в документах Word, используя Aspose.Words для Java. Мы пройдемся по созданию разных типов диаграмм, добавлению нескольких рядов, форматированию подписей данных, изменению типа оси и даже скрытию оси диаграммы, когда нужен более чистый вид. К концу вы получите надёжный, готовый к продакшну подход для встраивания богатых диаграмм в ваши документы. -## Введение в использование диаграмм в Aspose.Words для Java +## Быстрые ответы +- **Какой основной класс для построения диаграммы?** `DocumentBuilder` с методом `insertChart`. +- **Какой метод добавляет новый ряд?** `chart.getSeries().add(...)`. +- **Как отформатировать подписи данных диаграммы?** Используйте `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Можно ли скрыть ось?** Да, вызовите `setHidden(true)` у объекта оси. +- **Нужна ли лицензия для Aspose.Words?** Лицензия требуется для продакшн‑использования; доступна бесплатная trial‑версия. -В этом уроке мы рассмотрим, как работать с диаграммами с помощью Aspose.Words для Java. Вы узнаете, как создавать различные типы диаграмм, настраивать свойства осей, форматировать метки данных и многое другое. Давайте погрузимся! +## Что такое столбчатая диаграмма и зачем её использовать? -## Создание линейной диаграммы +Столбчатая диаграмма отображает категориальные данные в виде вертикальных столбцов, что делает её идеальной для сравнения значений между группами (продажи по регионам, ежемесячные расходы и т.д.). В Java‑приложениях генерация столбчатой диаграммы с помощью Aspose.Words позволяет встраивать эти визуалы напрямую в файлы Word / DOCX без необходимости использовать Excel или сторонние инструменты. -Для создания линейной диаграммы используйте следующий код: +## Как создать столбчатую диаграмму + +Ниже приведён простой пример, создающий базовую столбчатую диаграмму. Код полностью идентичен оригинальному фрагменту – мы лишь добавили поясняющие комментарии, чтобы было легче понять. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Добавление нескольких рядов + +Вы можете **добавлять несколько рядов** в столбчатую диаграмму, вызывая `chart.getSeries().add(...)` последовательно, как показано выше. Каждый ряд может иметь собственный набор категорий и значений, позволяя сравнивать несколько наборов данных бок‑о‑бок. + +## Как создать линейную диаграмму с пользовательскими подписями данных + +Если нужна линейная диаграмма вместо столбчатой, применяется тот же шаблон. Этот пример также демонстрирует **форматирование подписей данных** с различными числовыми форматами. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Удалить созданную по умолчанию серию. +// Delete default generated series. chart.getSeries().clear(); -// Добавление серии с данными и метками данных. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Или свяжите код формата с исходной ячейкой. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Создание других типов диаграмм +### Добавление подписей данных -Вы можете создавать различные типы диаграмм, такие как столбчатые, площадные, пузырьковые, точечные и другие, используя аналогичные методы. Вот пример вставки простой столбчатой диаграммы: +Вызов `series1.hasDataLabels(true)` **добавляет подписи данных** к ряду, а `setShowValue(true)` делает сами значения видимыми на диаграмме. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Удалить созданную по умолчанию серию. -chart.getSeries().clear(); - -// Создание категорий и добавление данных. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## Настройка свойств оси +## Как изменить тип оси и настроить свойства оси -Вы можете настроить свойства оси, например, изменить тип оси, установить деления, форматировать метки и т. д. Вот пример определения свойств оси XY: +Изменение типа оси (например, с даты на категорию) позволяет контролировать, как отображаются точки данных. Этот фрагмент также показывает, как **скрыть ось диаграммы**, если вы предпочитаете минималистичный дизайн. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Очистите серию по умолчанию и добавьте свои данные. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Измените ось X так, чтобы вместо даты отображалась категория. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Измеряется в единицах отображения оси Y (сотни). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Форматирование меток данных +### Изменение типа оси -Вы можете форматировать метки данных с помощью различных числовых форматов. Вот пример: +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **изменяет тип оси** с оси, основанной на датах, на категориальную, давая вам полный контроль над размещением меток. + +## Как форматировать подписи данных диаграммы (числовые форматы) + +Вы можете применять числовое форматирование непосредственно к оси или подписям данных. В этом примере числа оси Y форматируются с разделителем тысяч. ```java Document doc = new Document(); @@ -116,7 +142,7 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Очистите серию по умолчанию и добавьте свои данные. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); @@ -125,41 +151,39 @@ doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ## Дополнительные настройки диаграммы -Вы можете дополнительно настроить свои диаграммы, настроив границы, интервалы между метками, скрыв оси диаграммы и т. д. Изучите предоставленные фрагменты кода, чтобы узнать больше об этих параметрах. - -## Заключение - -В этом уроке мы изучили, как работать с диаграммами с помощью Aspose.Words для Java. Вы узнали, как создавать различные типы диаграмм, настраивать свойства осей, форматировать метки данных и многое другое. Aspose.Words для Java предоставляет мощные инструменты для добавления визуальных представлений данных в ваши документы, улучшая способ представления информации. +Помимо базовых возможностей, вы можете регулировать границы, задавать интервалы между метками, скрывать отдельные оси и многое другое. Обратитесь к документации Aspose.Words for Java API для полного списка свойств. ## Часто задаваемые вопросы -### Как добавить несколько рядов в диаграмму? - -Вы можете добавить несколько рядов в диаграмму с помощью `chart.getSeries().add()` метод. Обязательно укажите название серии, категории и значения данных. +**В: Как добавить несколько рядов к диаграмме?** +О: Используйте `chart.getSeries().add()` для каждого ряда, который хотите отобразить. Каждый вызов может принимать уникальное имя, массив категорий и массив значений. -### Как отформатировать метки данных с помощью пользовательских числовых форматов? +**В: Как отформатировать подписи данных диаграммы с пользовательскими числовыми форматами?** +О: Получите объект `DataLabels` у ряда и вызовите `getNumberFormat().setFormatCode("ваш формат")`. Также можно привязать формат к исходной ячейке с помощью `isLinkedToSource(true)`. -Вы можете форматировать метки данных, перейдя к `DataLabels` свойства серии и установка нужного формата кода с помощью `getNumberFormat().setFormatCode()`. +**В: Как скрыть ось диаграммы?** +О: Вызовите `setHidden(true)` у нужного `ChartAxis` (например, `chart.getAxisY().setHidden(true)`). -### Как настроить свойства осей на диаграмме? +**В: Как лучше изменить тип оси?** +О: Используйте `setCategoryType(AxisCategoryType.CATEGORY)` для категориальных осей или `AxisCategoryType.DATE` для датированных осей. -Вы можете настроить свойства осей, такие как тип, деления, метки и многое другое, перейдя к `ChartAxis` свойства, такие как `setCategoryType()`, `setCrosses()`, и `setMajorTickMark()`. +**В: Как добавить подписи данных к ряду?** +О: Включите их с помощью `series.hasDataLabels(true)`, а затем настройте отображение через `series.getDataLabels().setShowValue(true)`. -### Как создать другие типы диаграмм, например, точечные или площадные диаграммы? - -Вы можете создавать различные типы диаграмм, указав соответствующие `ChartType` при вставке диаграммы с помощью `builder.insertChart(ChartType.TYPE, width, height)`. +## Заключение -### Как скрыть ось диаграммы? +Мы рассмотрели всё, что нужно для **создания столбчатой диаграммы** с помощью Aspose.Words для Java — от вставки базовых диаграмм и добавления нескольких рядов до форматирования подписей данных, изменения типа оси и скрытия осей для чистого вида. Внедрите эти техники в свои отчёты или конвейеры генерации документов, чтобы предоставлять профессиональные, основанные на данных документы Word. -Вы можете скрыть ось диаграммы, установив `setHidden(true)` свойство оси. +--- +**Последнее обновление:** 2025-12-13 +**Тестировано с:** Aspose.Words for Java 24.12 (latest) +**Автор:** 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/words/spanish/java/document-conversion-and-export/using-charts/_index.md b/words/spanish/java/document-conversion-and-export/using-charts/_index.md index 161408581..2205afc36 100644 --- a/words/spanish/java/document-conversion-and-export/using-charts/_index.md +++ b/words/spanish/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Aprenda a crear y personalizar gráficos en Aspose.Words para Java. Explore los tipos de gráficos, el formato y las propiedades de los ejes para la visualización de datos." -"linktitle": "Uso de gráficos" -"second_title": "API de procesamiento de documentos Java de Aspose.Words" -"title": "Uso de gráficos en Aspose.Words para Java" -"url": "/es/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Aprenda a crear un gráfico de columnas y a dar formato a las etiquetas + de datos del gráfico con Aspose.Words para Java. Explore cómo agregar múltiples + series, cambiar el tipo de eje y ocultar el eje del gráfico. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Cómo crear un gráfico de columnas usando Aspose.Words para Java +url: /es/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Uso de gráficos en Aspose.Words para Java +# Cómo crear un gráfico de columnas usando Aspose.Words para Java +En este tutorial usted **creará un gráfico de columnas** visualizaciones directamente dentro de documentos Word usando Aspose.Words for Java. Recorreremos la creación de diferentes tipos de gráficos, la adición de múltiples series, el formato de etiquetas de datos del gráfico, el cambio del tipo de eje e incluso ocultar un eje del gráfico cuando necesite una apariencia más limpia. Al final tendrá un enfoque sólido y listo para producción para incrustar gráficos enriquecidos en sus documentos. -## Introducción al uso de gráficos en Aspose.Words para Java +## Respuestas rápidas +- **¿Cuál es la clase principal para crear un gráfico?** `DocumentBuilder` con `insertChart`. +- **¿Qué método agrega una nueva serie?** `chart.getSeries().add(...)`. +- **¿Cómo formateo las etiquetas de datos del gráfico?** Use `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **¿Puedo ocultar un eje?** Sí, llame a `setHidden(true)` en el objeto del eje. +- **¿Necesito una licencia para Aspose.Words?** Se requiere una licencia para uso en producción; hay una prueba gratuita disponible. -En este tutorial, exploraremos cómo trabajar con gráficos usando Aspose.Words para Java. Aprenderá a crear varios tipos de gráficos, personalizar las propiedades de los ejes, dar formato a las etiquetas de datos y mucho más. ¡Comencemos! +## Qué es un gráfico de columnas y por qué usarlo -## Creación de un gráfico de líneas +Un gráfico de columnas muestra datos categóricos como barras verticales, lo que lo hace ideal para comparar valores entre grupos (ventas por región, gastos mensuales, etc.). En aplicaciones Java, generar un gráfico de columnas con Aspose.Words le permite incrustar estas visualizaciones directamente en archivos Word / DOCX sin necesidad de Excel ni herramientas externas. -Para crear un gráfico de líneas, utilice el siguiente código: +## Cómo crear un gráfico de columnas + +A continuación se muestra un ejemplo sencillo que crea un gráfico de columnas simple. El código es idéntico al fragmento original; solo hemos añadido comentarios explicativos para facilitar su comprensión. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Añadir múltiples series + +Puede **añadir múltiples series** a un gráfico de columnas llamando a `chart.getSeries().add(...)` repetidamente, como se muestra arriba. Cada serie puede tener su propio conjunto de categorías y valores, lo que le permite comparar varios conjuntos de datos lado a lado. + +## Cómo crear un gráfico de líneas con etiquetas de datos personalizadas + +Si necesita un gráfico de líneas en lugar de un gráfico de columnas, se aplica el mismo patrón. Este ejemplo también demuestra **formatear las etiquetas de datos del gráfico** con diferentes formatos numéricos. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Eliminar serie generada por defecto. +// Delete default generated series. chart.getSeries().clear(); -// Agregar una serie con datos y etiquetas de datos. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// O vincular el código de formato a una celda de origen. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Creación de otros tipos de gráficos +### Añadir etiquetas de datos -Puedes crear diferentes tipos de gráficos, como de columnas, de áreas, de burbujas, de dispersión y más, utilizando técnicas similares. Aquí tienes un ejemplo de inserción de un gráfico de columnas simple: +La llamada `series1.hasDataLabels(true)` **añade etiquetas de datos** a la serie, mientras que `setShowValue(true)` hace que los valores reales sean visibles en el gráfico. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Eliminar serie generada por defecto. -chart.getSeries().clear(); - -// Creando categorías y agregando datos. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## Personalización de las propiedades del eje +## Cómo cambiar el tipo de eje y personalizar las propiedades del eje -Puede personalizar las propiedades de los ejes, como cambiar el tipo de eje, establecer marcas de graduación, formatear etiquetas y más. A continuación, se muestra un ejemplo de cómo definir las propiedades del eje XY: +Cambiar el tipo de eje (p. ej., de fecha a categoría) le permite controlar cómo se trazan los puntos de datos. Este fragmento también muestra cómo **ocultar el eje del gráfico** si prefiere un diseño minimalista. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Borre la serie predeterminada y agregue sus datos. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Cambie el eje X para que sea una categoría en lugar de una fecha. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Medido en unidades de visualización del eje Y (centenas). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Formato de etiquetas de datos +### Cambiar el tipo de eje -Puedes formatear las etiquetas de datos con diferentes formatos numéricos. A continuación, un ejemplo: +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **cambia el tipo de eje** de un eje basado en fechas a uno categórico, dándole control total sobre la ubicación de las etiquetas. + +## Cómo formatear las etiquetas de datos del gráfico (formatos numéricos) + +Puede aplicar formato numérico directamente al eje o a las etiquetas de datos. Este ejemplo formatea los números del eje Y con un separador de miles. ```java Document doc = new Document(); @@ -116,50 +142,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Borre la serie predeterminada y agregue sus datos. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## Personalizaciones adicionales de gráficos - -Puede personalizar aún más sus gráficos ajustando los límites, las unidades de intervalo entre las etiquetas, ocultando los ejes del gráfico y más. Explore los fragmentos de código proporcionados para obtener más información sobre estas opciones. +## Personalizaciones adicionales del gráfico -## Conclusión - -En este tutorial, hemos explorado cómo trabajar con gráficos usando Aspose.Words para Java. Ha aprendido a crear varios tipos de gráficos, personalizar las propiedades de los ejes, dar formato a las etiquetas de datos y mucho más. Aspose.Words para Java proporciona potentes herramientas para añadir representaciones visuales de datos a sus documentos, optimizando así la forma en que presenta la información. +Más allá de lo básico, puede ajustar los límites, establecer unidades de intervalo entre etiquetas, ocultar ejes específicos y más. Consulte la documentación de la API de Aspose.Words for Java para obtener una lista completa de propiedades. ## Preguntas frecuentes -### ¿Cómo puedo agregar varias series a un gráfico? - -Puede agregar varias series a un gráfico utilizando el `chart.getSeries().add()` método. Asegúrese de especificar el nombre de la serie, las categorías y los valores de los datos. +**Q: ¿Cómo puedo añadir múltiples series a un gráfico?** +**A:** Use `chart.getSeries().add()` para cada serie que desee mostrar. Cada llamada puede proporcionar un nombre único, una matriz de categorías y una matriz de valores. -### ¿Cómo puedo formatear etiquetas de datos con formatos de números personalizados? +**Q: ¿Cómo formateo las etiquetas de datos del gráfico con formatos numéricos personalizados?** +**A:** Acceda al objeto `DataLabels` de una serie y llame a `getNumberFormat().setFormatCode("su formato")`. También puede vincular el formato a una celda de origen con `isLinkedToSource(true)`. -Puede formatear las etiquetas de datos accediendo a `DataLabels` Propiedades de una serie y configuración del código de formato deseado mediante `getNumberFormat().setFormatCode()`. +**Q: ¿Cómo puedo ocultar un eje del gráfico?** +**A:** Llame a `setHidden(true)` en el `ChartAxis` que desea ocultar (p. ej., `chart.getAxisY().setHidden(true)`). -### ¿Cómo personalizo las propiedades del eje en un gráfico? +**Q: ¿Cuál es la mejor manera de cambiar el tipo de eje?** +**A:** Use `setCategoryType(AxisCategoryType.CATEGORY)` para ejes categóricos o `AxisCategoryType.DATE` para ejes de fecha. -Puede personalizar las propiedades del eje, como el tipo, las marcas de graduación, las etiquetas y más, accediendo a `ChartAxis` propiedades como `setCategoryType()`, `setCrosses()`, y `setMajorTickMark()`. +**Q: ¿Cómo añado etiquetas de datos a una serie?** +**A:** Habilítelas con `series.hasDataLabels(true)` y luego configure la visibilidad usando `series.getDataLabels().setShowValue(true)`. -### ¿Cómo puedo crear otros tipos de gráficos como gráficos de dispersión o de área? - -Puede crear varios tipos de gráficos especificando los elementos adecuados. `ChartType` al insertar el gráfico utilizando `builder.insertChart(ChartType.TYPE, width, height)`. +## Conclusión -### ¿Cómo puedo ocultar un eje de gráfico? +Hemos cubierto todo lo que necesita para **crear visualizaciones de gráficos de columnas** con Aspose.Words for Java, desde insertar gráficos básicos y añadir múltiples series, hasta formatear las etiquetas de datos del gráfico, cambiar el tipo de eje y ocultar ejes del gráfico para una apariencia limpia. Incorpore estas técnicas en sus flujos de trabajo de informes o generación de documentos para ofrecer documentos Word profesionales y basados en datos. -Puede ocultar un eje de gráfico configurando el `setHidden(true)` propiedad del eje. +--- +**Última actualización:** 2025-12-13 +**Probado con:** Aspose.Words for Java 24.12 (última) +**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/words/swedish/java/document-conversion-and-export/using-charts/_index.md b/words/swedish/java/document-conversion-and-export/using-charts/_index.md index d4766c15b..3e0cb44e6 100644 --- a/words/swedish/java/document-conversion-and-export/using-charts/_index.md +++ b/words/swedish/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Lär dig hur du skapar och anpassar diagram i Aspose.Words för Java. Utforska diagramtyper, formatering och axelegenskaper för datavisualisering." -"linktitle": "Använda diagram" -"second_title": "Aspose.Words Java-dokumentbehandlings-API" -"title": "Använda diagram i Aspose.Words för Java" -"url": "/sv/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Lär dig hur du skapar stapeldiagram och formaterar diagrammets datamärkningar + med Aspose.Words för Java. Utforska hur du lägger till flera serier, ändrar axeltyp + och döljer diagramaxeln. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Hur man skapar stapeldiagram med Aspose.Words för Java +url: /sv/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Använda diagram i Aspose.Words för Java +# Så skapar du stapeldiagram med Aspose.Words för Java +I den här handledningen kommer du **skapa stapeldiagram**‑visualiseringar direkt i Word‑dokument med Aspose.Words för Java. Vi går igenom hur du skapar olika diagramtyper, lägger till flera serier, formaterar diagrammets datalabels, ändrar axeltyp och även döljer en diagramaxel när du vill ha ett renare utseende. I slutet har du en solid, produktionsklar metod för att bädda in rika diagram i dina dokument. -## Introduktion till att använda diagram i Aspose.Words för Java +## Snabba svar +- **Vad är den primära klassen för att bygga ett diagram?** `DocumentBuilder` med `insertChart`. +- **Vilken metod lägger till en ny serie?** `chart.getSeries().add(...)`. +- **Hur formaterar jag diagrammets datalabels?** Använd `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Kan jag dölja en axel?** Ja, anropa `setHidden(true)` på axelobjektet. +- **Behöver jag en licens för Aspose.Words?** En licens krävs för produktionsanvändning; en gratis provversion finns tillgänglig. -I den här handledningen utforskar vi hur man arbetar med diagram med Aspose.Words för Java. Du lär dig hur du skapar olika typer av diagram, anpassar axelegenskaper, formaterar dataetiketter och mer. Nu kör vi! +## Vad är ett stapeldiagram och varför använda det? -## Skapa ett linjediagram +Ett stapeldiagram visar kategorisk data som vertikala staplar, vilket gör det idealiskt för att jämföra värden mellan grupper (försäljning per region, månatliga utgifter osv.). I Java‑applikationer gör generering av ett stapeldiagram med Aspose.Words det möjligt att bädda in dessa visualiseringar direkt i Word / DOCX‑filer utan att behöva Excel eller externa verktyg. -För att skapa ett linjediagram, använd följande kod: +## Så skapar du ett stapeldiagram + +Nedan följer ett enkelt exempel som skapar ett enkelt stapeldiagram. Koden är identisk med originalsnutten – vi har bara lagt till förklarande kommentarer för att göra den lättare att följa. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Lägg till flera serier + +Du kan **lägga till flera serier** i ett stapeldiagram genom att anropa `chart.getSeries().add(...)` upprepade gånger, som visas ovan. Varje serie kan ha sin egen uppsättning kategorier och värden, vilket gör att du kan jämföra flera dataset sida‑vid‑sida. + +## Så skapar du ett linjediagram med anpassade datalabels + +Om du behöver ett linjediagram istället för ett stapeldiagram gäller samma mönster. Detta exempel visar också hur du **formaterar diagrammets datalabels** med olika talformat. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Ta bort standardgenererade serier. +// Delete default generated series. chart.getSeries().clear(); -// Lägga till en serie med data och dataetiketter. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Eller länka formatkod till en källcell. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Skapa andra typer av diagram +### Lägg till datalabels -Du kan skapa olika typer av diagram som kolumndiagram, ytdiagram, bubbeldiagram, punktdiagram och mer med liknande tekniker. Här är ett exempel på hur du infogar ett enkelt kolumndiagram: +Anropet `series1.hasDataLabels(true)` **lägger till datalabels** till serien, medan `setShowValue(true)` gör de faktiska värdena synliga i diagrammet. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Ta bort standardgenererade serier. -chart.getSeries().clear(); - -// Skapa kategorier och lägga till data. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` - -## Anpassa axelegenskaper +## Så ändrar du axeltyp och anpassar axelns egenskaper -Du kan anpassa axelegenskaper, till exempel ändra axeltyp, ange skalmarkeringar, formatera etiketter med mera. Här är ett exempel på hur du definierar XY-axelegenskaper: +Att ändra axeltypen (t.ex. från datum till kategori) låter dig styra hur datapunkter plottas. Denna kodsnutt visar också hur du **döljer diagramaxeln** om du föredrar en minimalistisk design. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Rensa standardserien och lägg till dina data. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Ändra X-axeln till en kategori istället för ett datum. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Mätt i visningsenheter för Y-axeln (hundratal). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Formatera dataetiketter +### Ändra axeltyp -Du kan formatera dataetiketter med olika talformat. Här är ett exempel: +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **ändrar axeltypen** från en datumbaserad axel till en kategorisk, vilket ger dig full kontroll över placeringen av etiketter. + +## Så formaterar du diagrammets datalabels (talformat) + +Du kan applicera talformat direkt på axeln eller datalabels. Detta exempel formaterar Y‑axelns siffror med ett tusentalsavgränsare. ```java Document doc = new Document(); @@ -116,7 +142,7 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Rensa standardserien och lägg till dina data. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); @@ -125,41 +151,39 @@ doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ## Ytterligare diagramanpassningar -Du kan ytterligare anpassa dina diagram genom att justera gränser, intervallenheter mellan etiketter, dölja diagramaxlar och mer. Utforska de medföljande kodavsnitten för att lära dig mer om dessa alternativ. - -## Slutsats - -den här handledningen har vi utforskat hur man arbetar med diagram med Aspose.Words för Java. Du har lärt dig hur du skapar olika typer av diagram, anpassar axelegenskaper, formaterar dataetiketter och mer. Aspose.Words för Java tillhandahåller kraftfulla verktyg för att lägga till visuella representationer av data i dina dokument, vilket förbättrar hur du presenterar information. +Utöver grunderna kan du justera gränser, sätta intervallenheter mellan etiketter, dölja specifika axlar och mer. Se Aspose.Words för Java API‑dokumentationen för en fullständig lista över egenskaper. ## Vanliga frågor -### Hur kan jag lägga till flera serier i ett diagram? - -Du kan lägga till flera serier i ett diagram med hjälp av `chart.getSeries().add()` metod. Se till att ange serienamn, kategorier och datavärden. +**Q: Hur kan jag lägga till flera serier i ett diagram?** +A: Använd `chart.getSeries().add()` för varje serie du vill visa. Varje anrop kan ange ett unikt namn, en kategori‑array och en värde‑array. -### Hur kan jag formatera dataetiketter med anpassade nummerformat? +**Q: Hur formaterar jag diagrammets datalabels med anpassade talformat?** +A: Få åtkomst till en series `DataLabels`‑objekt och anropa `getNumberFormat().setFormatCode("your format")`. Du kan också länka formatet till en källcell med `isLinkedToSource(true)`. -Du kan formatera dataetiketter genom att öppna `DataLabels` egenskaper för en serie och inställning av önskad formatkod med hjälp av `getNumberFormat().setFormatCode()`. +**Q: Hur kan jag dölja en diagramaxel?** +A: Anropa `setHidden(true)` på den `ChartAxis` du vill dölja (t.ex. `chart.getAxisY().setHidden(true)`). -### Hur anpassar jag axelegenskaper i ett diagram? +**Q: Vad är det bästa sättet att ändra axeltyp?** +A: Använd `setCategoryType(AxisCategoryType.CATEGORY)` för kategoriska axlar eller `AxisCategoryType.DATE` för datumaxlar. -Du kan anpassa axelegenskaper som typ, skalmarkeringar, etiketter med mera genom att öppna `ChartAxis` egenskaper som `setCategoryType()`, `setCrosses()`och `setMajorTickMark()`. +**Q: Hur lägger jag till datalabels i en serie?** +A: Aktivera dem med `series.hasDataLabels(true)` och konfigurera sedan synligheten med `series.getDataLabels().setShowValue(true)`. -### Hur kan jag skapa andra typer av diagram, som punktdiagram eller ytdiagram? - -Du kan skapa olika diagramtyper genom att ange lämpliga `ChartType` när du infogar diagrammet med hjälp av `builder.insertChart(ChartType.TYPE, width, height)`. +## Slutsats -### Hur kan jag dölja en diagramaxel? +Vi har gått igenom allt du behöver för att **skapa stapeldiagram**‑visualiseringar med Aspose.Words för Java – från att infoga grundläggande diagram och lägga till flera serier, till att formatera diagrammets datalabels, ändra axeltyp och dölja diagramaxlar för ett rent utseende. Integrera dessa tekniker i dina rapporterings‑ eller dokumentgenereringsprocesser för att leverera professionella, datadrivna Word‑dokument. -Du kan dölja en diagramaxel genom att ställa in `setHidden(true)` axelns egenskap. +--- +**Senast uppdaterad:** 2025-12-13 +**Testad med:** Aspose.Words for Java 24.12 (senaste) +**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/words/thai/java/document-conversion-and-export/using-charts/_index.md b/words/thai/java/document-conversion-and-export/using-charts/_index.md index 0628cf59c..4f54a8131 100644 --- a/words/thai/java/document-conversion-and-export/using-charts/_index.md +++ b/words/thai/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,12 @@ --- -"description": "เรียนรู้วิธีการสร้างและปรับแต่งแผนภูมิใน Aspose.Words สำหรับ Java สำรวจประเภทแผนภูมิ การจัดรูปแบบ และคุณสมบัติของแกนสำหรับการแสดงภาพข้อมูล" -"linktitle": "การใช้แผนภูมิ" -"second_title": "API การประมวลผลเอกสาร Java ของ Aspose.Words" -"title": "การใช้แผนภูมิใน Aspose.Words สำหรับ Java" -"url": "/th/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: เรียนรู้วิธีสร้างแผนภูมิคอลัมน์และจัดรูปแบบป้ายข้อมูลของแผนภูมิด้วย Aspose.Words + for Java. สำรวจการเพิ่มหลายชุดข้อมูล, การเปลี่ยนประเภทแกน, และการซ่อนแกนของแผนภูมิ. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: วิธีสร้างแผนภูมิคอลัมน์โดยใช้ Aspose.Words สำหรับ Java +url: /th/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +15,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# การใช้แผนภูมิใน Aspose.Words สำหรับ Java +# วิธีสร้างแผนภูมิคอลัมน์โดยใช้ Aspose.Words สำหรับ Java +ในบทเรียนนี้คุณจะ **สร้างแผนภูมิคอลัมน์** ภายในเอกสาร Word โดยตรงด้วย Aspose.Words สำหรับ Java เราจะอธิบายการสร้างประเภทแผนภูมิต่าง ๆ การเพิ่มหลายซีรีส์ การจัดรูปแบบป้ายข้อมูลของแผนภูมิ การเปลี่ยนประเภทแกน และแม้กระทั่งการซ่อนแกนของแผนภูมิเมื่อคุณต้องการรูปลักษณ์ที่เรียบง่าย สุดท้ายคุณจะได้วิธีการที่พร้อมใช้งานในระดับผลิตภัณฑ์สำหรับฝังแผนภูมิที่มีความสมบูรณ์ในเอกสารของคุณ -## การแนะนำการใช้แผนภูมิใน Aspose.Words สำหรับ Java +## คำตอบสั้น +- **คลาสหลักที่ใช้สร้างแผนภูมิคืออะไร?** `DocumentBuilder` พร้อมเมธอด `insertChart` +- **เมธอดใดที่ใช้เพิ่มซีรีส์ใหม่?** `chart.getSeries().add(...)` +- **ฉันจะจัดรูปแบบป้ายข้อมูลของแผนภูมิได้อย่างไร?** ใช้ `getDataLabels().get(...).getNumberFormat().setFormatCode(...)` +- **ฉันสามารถซ่อนแกนได้หรือไม่?** ได้, เรียก `setHidden(true)` บนวัตถุแกน +- **ต้องมีลิขสิทธิ์สำหรับ Aspose.Words หรือไม่?** จำเป็นต้องมีลิขสิทธิ์สำหรับการใช้งานในระดับผลิตภัณฑ์; มีรุ่นทดลองฟรีให้ใช้ -ในบทช่วยสอนนี้ เราจะมาเรียนรู้วิธีการทำงานกับแผนภูมิโดยใช้ Aspose.Words สำหรับ Java คุณจะได้เรียนรู้วิธีการสร้างแผนภูมิประเภทต่างๆ ปรับแต่งคุณสมบัติแกน จัดรูปแบบป้ายข้อมูล และอื่นๆ อีกมากมาย มาเริ่มกันเลย! +## แผนภูมิคอลัมน์คืออะไรและทำไมต้องใช้? -## การสร้างแผนภูมิเส้น +แผนภูมิคอลัมน์แสดงข้อมูลเชิงหมวดหมู่เป็นแท่งแนวตั้ง ทำให้เหมาะสำหรับการเปรียบเทียบค่าระหว่างกลุ่ม (ยอดขายต่อภูมิภาค, ค่าใช้จ่ายรายเดือน ฯลฯ) ในแอปพลิเคชัน Java การสร้างแผนภูมิคอลัมน์ด้วย Aspose.Words ช่วยให้คุณฝังภาพเหล่านี้โดยตรงลงในไฟล์ Word / DOCX โดยไม่ต้องพึ่งพา Excel หรือเครื่องมือภายนอก -ในการสร้างแผนภูมิเส้น ให้ใช้โค้ดดังต่อไปนี้: +## วิธีสร้างแผนภูมิคอลัมน์ + +ด้านล่างเป็นตัวอย่างที่เรียบง่ายซึ่งสร้างแผนภูมิคอลัมน์พื้นฐาน โค้ดตรงกับส่วนที่ให้มาเดิม – เราเพียงเพิ่มคอมเมนต์อธิบายเพื่อให้ง่ายต่อการทำตาม + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### เพิ่มหลายซีรีส์ + +คุณสามารถ **เพิ่มหลายซีรีส์** ลงในแผนภูมิคอลัมน์ได้โดยเรียก `chart.getSeries().add(...)` ซ้ำ ๆ ตามที่แสดงด้านบน แต่ละซีรีส์สามารถมีชุดหมวดหมู่และค่าของตนเอง ทำให้คุณเปรียบเทียบหลายชุดข้อมูลได้พร้อมกัน + +## วิธีสร้างแผนภูมิเส้นพร้อมป้ายข้อมูลแบบกำหนดเอง + +หากคุณต้องการแผนภูมิเส้นแทนแผนภูมิคอลัมน์ รูปแบบเดียวกันก็ใช้ได้ ตัวอย่างนี้ยังแสดง **การจัดรูปแบบป้ายข้อมูลของแผนภูมิ** ด้วยรูปแบบตัวเลขที่ต่างกัน ```java Document doc = new Document(); @@ -31,10 +66,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// ลบซีรีย์ที่สร้างขึ้นตามค่าเริ่มต้น +// Delete default generated series. chart.getSeries().clear(); -// การเพิ่มชุดข้อมูลและป้ายข้อมูล +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +80,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// หรือเชื่อมโยงรูปแบบโค้ดไปยังเซลล์แหล่งที่มา +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## การสร้างแผนภูมิประเภทอื่น ๆ +### เพิ่มป้ายข้อมูล -คุณสามารถสร้างแผนภูมิประเภทต่างๆ เช่น แผนภูมิคอลัมน์ แผนภูมิพื้นที่ แผนภูมิฟอง แผนภูมิกระจาย และอื่นๆ โดยใช้เทคนิคที่คล้ายกัน ต่อไปนี้คือตัวอย่างการแทรกแผนภูมิคอลัมน์แบบง่าย: +การเรียก `series1.hasDataLabels(true)` **เพิ่มป้ายข้อมูล** ให้กับซีรีส์ ส่วน `setShowValue(true)` ทำให้ค่าจริงแสดงบนแผนภูมิ -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// ลบซีรีย์ที่สร้างขึ้นตามค่าเริ่มต้น -chart.getSeries().clear(); - -// การสร้างหมวดหมู่และการเพิ่มข้อมูล -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` +## วิธีเปลี่ยนประเภทแกนและปรับแต่งคุณสมบัติของแกน -## การปรับแต่งคุณสมบัติของแกน - -คุณสามารถปรับแต่งคุณสมบัติของแกนได้ เช่น การเปลี่ยนประเภทแกน การตั้งเครื่องหมาย การจัดรูปแบบป้ายกำกับ และอื่นๆ ต่อไปนี้คือตัวอย่างการกำหนดคุณสมบัติของแกน XY: +การเปลี่ยนประเภทแกน (เช่น จากวันที่เป็นหมวดหมู่) ช่วยให้คุณควบคุมวิธีการวางจุดข้อมูล ตัวอย่างนี้ยังแสดงวิธี **ซ่อนแกนของแผนภูมิ** หากคุณต้องการการออกแบบที่มินิมัล ```java Document doc = new Document(); @@ -82,20 +100,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// ล้างซีรีย์เริ่มต้นและเพิ่มข้อมูลของคุณ +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// เปลี่ยนแกน X ให้เป็นหมวดหมู่แทนวันที่ +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // วัดเป็นหน่วยแสดงผลของแกน Y (ร้อย) +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +127,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## การจัดรูปแบบฉลากข้อมูล +### เปลี่ยนประเภทแกน + +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **เปลี่ยนประเภทแกน** จากแกนที่อิงวันที่เป็นแกนประเภทหมวดหมู่ ให้คุณควบคุมตำแหน่งป้ายได้เต็มที่ -คุณสามารถจัดรูปแบบป้ายข้อมูลด้วยรูปแบบตัวเลขที่แตกต่างกันได้ ต่อไปนี้คือตัวอย่าง: +## วิธีจัดรูปแบบป้ายข้อมูลของแผนภูมิ (รูปแบบตัวเลข) + +คุณสามารถกำหนดรูปแบบตัวเลขให้กับแกนหรือป้ายข้อมูลโดยตรง ตัวอย่างนี้จัดรูปแบบตัวเลขของแกน Y ให้มีคั่นหลักพัน ```java Document doc = new Document(); @@ -116,7 +141,7 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// ล้างซีรีย์เริ่มต้นและเพิ่มข้อมูลของคุณ +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); @@ -125,41 +150,39 @@ doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ## การปรับแต่งแผนภูมิเพิ่มเติม -คุณสามารถปรับแต่งแผนภูมิของคุณเพิ่มเติมได้โดยการปรับขอบเขต หน่วยช่วงระหว่างป้ายกำกับ ซ่อนแกนแผนภูมิ และอื่นๆ อีกมากมาย สำรวจตัวอย่างโค้ดที่ให้มาเพื่อเรียนรู้เพิ่มเติมเกี่ยวกับตัวเลือกเหล่านี้ - -## บทสรุป - -ในบทช่วยสอนนี้ เราได้ศึกษาวิธีการทำงานกับแผนภูมิโดยใช้ Aspose.Words สำหรับ Java คุณได้เรียนรู้วิธีการสร้างแผนภูมิประเภทต่างๆ ปรับแต่งคุณสมบัติแกน จัดรูปแบบป้ายข้อมูล และอื่นๆ อีกมากมาย Aspose.Words สำหรับ Java มอบเครื่องมืออันทรงพลังสำหรับการเพิ่มการแสดงภาพข้อมูลลงในเอกสารของคุณ เพื่อปรับปรุงวิธีการนำเสนอข้อมูลของคุณ +นอกเหนือจากพื้นฐานแล้ว คุณสามารถปรับขอบเขต, ตั้งค่าหน่วยระยะห่างระหว่างป้าย, ซ่อนแกนเฉพาะส่วน, และอื่น ๆ อีกมากมาย ดูเอกสาร API ของ Aspose.Words สำหรับ Java เพื่อรับรายการคุณสมบัติทั้งหมด ## คำถามที่พบบ่อย -### ฉันจะเพิ่มซีรีส์หลายชุดลงในแผนภูมิได้อย่างไร +**ถาม: ฉันจะเพิ่มหลายซีรีส์ลงในแผนภูมิได้อย่างไร?** +ตอบ: ใช้ `chart.getSeries().add()` สำหรับแต่ละซีรีส์ที่ต้องการแสดง แต่ละการเรียกสามารถระบุชื่อ, อาเรย์หมวดหมู่, และอาเรย์ค่าได้เป็นเอกลักษณ์ -คุณสามารถเพิ่มซีรีส์หลายชุดลงในแผนภูมิได้โดยใช้ `chart.getSeries().add()` วิธีการนี้ โปรดระบุชื่อซีรีส์ หมวดหมู่ และค่าข้อมูล +**ถาม: ฉันจะจัดรูปแบบป้ายข้อมูลของแผนภูมิด้วยรูปแบบตัวเลขที่กำหนดเองได้อย่างไร?** +ตอบ: เข้าถึงอ็อบเจกต์ `DataLabels` ของซีรีส์และเรียก `getNumberFormat().setFormatCode("รูปแบบของคุณ")` คุณยังสามารถเชื่อมโยงรูปแบบกับเซลล์ต้นทางโดยใช้ `isLinkedToSource(true)` -### ฉันจะจัดรูปแบบป้ายข้อมูลด้วยรูปแบบตัวเลขแบบกำหนดเองได้อย่างไร +**ถาม: ฉันจะซ่อนแกนของแผนภูมิได้หรือไม่?** +ตอบ: เรียก `setHidden(true)` บน `ChartAxis` ที่ต้องการซ่อน (เช่น `chart.getAxisY().setHidden(true)`) -คุณสามารถจัดรูปแบบป้ายข้อมูลโดยการเข้าถึง `DataLabels` คุณสมบัติของซีรีส์และการตั้งค่ารหัสรูปแบบที่ต้องการโดยใช้ `getNumberFormat()-setFormatCode()`. +**ถาม: วิธีที่ดีที่สุดในการเปลี่ยนประเภทแกนคืออะไร?** +ตอบ: ใช้ `setCategoryType(AxisCategoryType.CATEGORY)` สำหรับแกนประเภทหมวดหมู่ หรือ `AxisCategoryType.DATE` สำหรับแกนประเภทวันที่ -### ฉันจะปรับแต่งคุณสมบัติแกนในแผนภูมิได้อย่างไร +**ถาม: ฉันจะเพิ่มป้ายข้อมูลให้กับซีรีส์ได้อย่างไร?** +ตอบ: เปิดใช้งานด้วย `series.hasDataLabels(true)` แล้วกำหนดการแสดงผลด้วย `series.getDataLabels().setShowValue(true)` -คุณสามารถปรับแต่งคุณสมบัติของแกน เช่น ประเภท เครื่องหมายถูก ป้ายกำกับ และอื่นๆ ได้โดยการเข้าถึง `ChartAxis` คุณสมบัติเช่น `setCategoryType()`- `setCrosses()`, และ `setMajorTickMark()`- +## สรุป -### ฉันจะสร้างแผนภูมิประเภทอื่น เช่น แผนภูมิกระจาย หรือแผนภูมิพื้นที่ ได้อย่างไร +เราได้ครอบคลุมทุกอย่างที่คุณต้องการเพื่อ **สร้างแผนภูมิคอลัมน์** ด้วย Aspose.Words สำหรับ Java – ตั้งแต่การแทรกแผนภูมิพื้นฐานและการเพิ่มหลายซีรีส์, การจัดรูปแบบป้ายข้อมูล, การเปลี่ยนประเภทแกน, จนถึงการซ่อนแกนเพื่อให้ได้ลุคที่สะอาดตา นำเทคนิคเหล่านี้ไปใช้ในกระบวนการสร้างรายงานหรือเอกสารอัตโนมัติของคุณ เพื่อมอบเอกสาร Word ที่เป็นมืออาชีพและขับเคลื่อนด้วยข้อมูล -คุณสามารถสร้างแผนภูมิประเภทต่างๆ ได้โดยระบุประเภทที่เหมาะสม `ChartType` เมื่อแทรกแผนภูมิโดยใช้ `builder-insertChart(ChartType.TYPE, width, height)`. - -### ฉันจะซ่อนแกนแผนภูมิได้อย่างไร - -คุณสามารถซ่อนแกนแผนภูมิได้โดยการตั้งค่า `setHidden(true)` คุณสมบัติของแกน +--- +**อัปเดตล่าสุด:** 2025-12-13 +**ทดสอบกับ:** Aspose.Words สำหรับ Java 24.12 (ล่าสุด) +**ผู้เขียน:** 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/words/turkish/java/document-conversion-and-export/using-charts/_index.md b/words/turkish/java/document-conversion-and-export/using-charts/_index.md index 0af1b3bef..20f789ad3 100644 --- a/words/turkish/java/document-conversion-and-export/using-charts/_index.md +++ b/words/turkish/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,13 @@ --- -"description": "Java için Aspose.Words'de grafiklerin nasıl oluşturulacağını ve özelleştirileceğini öğrenin. Veri görselleştirme için grafik türlerini, biçimlendirmeyi ve eksen özelliklerini keşfedin." -"linktitle": "Grafikleri Kullanma" -"second_title": "Aspose.Words Java Belge İşleme API'si" -"title": "Java için Aspose.Words'de Grafiklerin Kullanımı" -"url": "/tr/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Aspose.Words for Java ile sütun grafiği oluşturmayı ve grafik veri etiketlerini + biçimlendirmeyi öğrenin. Birden fazla seri eklemeyi, eksen tipini değiştirmeyi ve + grafik eksenini gizlemeyi keşfedin. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Aspose.Words for Java kullanarak sütun grafik nasıl oluşturulur +url: /tr/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +16,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Java için Aspose.Words'de Grafiklerin Kullanımı +# Aspose.Words for Java ile sütun grafik nasıl oluşturulur +Bu öğreticide **sütun grafik** görselleştirmelerini doğrudan Word belgelerinde Aspose.Words for Java kullanarak oluşturacaksınız. Farklı grafik tipleri oluşturma, birden fazla seri ekleme, grafik veri etiketlerini biçimlendirme, eksen tipini değiştirme ve daha temiz bir görünüm için bir ekseni gizleme konularını adım adım inceleyeceğiz. Sonunda belgelerinize zengin grafikler yerleştirmek için üretim‑hazır bir yaklaşıma sahip olacaksınız. -## Java için Aspose.Words'de Grafiklerin Kullanımına Giriş +## Hızlı Yanıtlar +- **Grafik oluşturmak için temel sınıf nedir?** `DocumentBuilder` ve `insertChart`. +- **Yeni bir seri ekleyen yöntem hangisidir?** `chart.getSeries().add(...)`. +- **Grafik veri etiketlerini nasıl biçimlendiririm?** `getDataLabels().get(...).getNumberFormat().setFormatCode(...)` kullanın. +- **Bir ekseni gizleyebilir miyim?** Evet, eksen nesnesinde `setHidden(true)` çağırın. +- **Aspose.Words için lisansa ihtiyacım var mı?** Üretim kullanımı için lisans gereklidir; ücretsiz deneme sürümü mevcuttur. -Bu eğitimde, Java için Aspose.Words kullanarak grafiklerle nasıl çalışılacağını keşfedeceğiz. Çeşitli grafik türleri oluşturmayı, eksen özelliklerini özelleştirmeyi, veri etiketlerini biçimlendirmeyi ve daha fazlasını öğreneceksiniz. Hadi başlayalım! +## Sütun grafik nedir ve neden kullanılır? -## Çizgi Grafiği Oluşturma +Sütun grafik, kategorik verileri dikey çubuklar halinde gösterir ve gruplar arasındaki değerleri karşılaştırmak için idealdir (bölge bazında satış, aylık harcamalar vb.). Java uygulamalarında Aspose.Words ile bir sütun grafik oluşturmak, bu görselleri Excel veya dış araçlar kullanmadan doğrudan Word / DOCX dosyalarına yerleştirmenizi sağlar. -Çizgi grafiği oluşturmak için aşağıdaki kodu kullanın: +## Sütun grafik nasıl oluşturulur + +Aşağıda basit bir sütun grafik oluşturan doğrudan örnek kod yer alıyor. Kod orijinal snippet ile aynı – sadece anlaşılmasını kolaylaştırmak için açıklayıcı yorumlar ekledik. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Birden fazla seri ekleme + +Yukarıda gösterildiği gibi `chart.getSeries().add(...)` metodunu tekrar tekrar çağırarak **birden fazla seri** ekleyebilirsiniz. Her seri kendi kategori ve değer setine sahip olabilir, bu da birden çok veri kümesini yan‑yana karşılaştırmanıza olanak tanır. + +## Özel veri etiketli çizgi grafik nasıl oluşturulur + +Sütun grafik yerine bir çizgi grafik ihtiyacınız varsa aynı desen geçerlidir. Bu örnek ayrıca **grafik veri etiketlerini** farklı sayı formatlarıyla biçimlendirmeyi de gösterir. ```java Document doc = new Document(); @@ -31,10 +67,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Varsayılan olarak oluşturulan seriyi sil. +// Delete default generated series. chart.getSeries().clear(); -// Veri ve veri etiketleriyle bir seri ekleme. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +81,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Veya biçim kodunu bir kaynak hücreye bağlayın. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Diğer Grafik Türlerinin Oluşturulması +### Veri etiketleri ekleme -Benzer teknikleri kullanarak sütun, alan, balon, dağılım ve daha fazlası gibi farklı grafik türleri oluşturabilirsiniz. İşte basit bir sütun grafiği eklemenin bir örneği: +`series1.hasDataLabels(true)` çağrısı **veri etiketlerini** seriye ekler, `setShowValue(true)` ise gerçek değerlerin grafikte görünür olmasını sağlar. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Varsayılan olarak oluşturulan seriyi sil. -chart.getSeries().clear(); - -// Kategori oluşturma ve veri ekleme. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` +## Eksen tipini değiştirme ve eksen özelliklerini özelleştirme -## Eksen Özelliklerini Özelleştirme - -Eksen türünü değiştirme, işaret çizgilerini ayarlama, etiketleri biçimlendirme ve daha fazlası gibi eksen özelliklerini özelleştirebilirsiniz. İşte XY eksen özelliklerini tanımlamanın bir örneği: +Eksen tipini (ör. tarih‑tabanlıdan kategori‑tabanlıya) değiştirmek, veri noktalarının nasıl çizileceğini kontrol etmenizi sağlar. Bu snippet ayrıca **grafik eksenini gizleme** yöntemini de gösterir. ```java Document doc = new Document(); @@ -82,20 +101,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Varsayılan seriyi temizleyin ve verilerinizi ekleyin. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// X eksenini tarih yerine kategori olarak değiştirin. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Y ekseninin (yüzlerce) gösterge birimleriyle ölçülmüştür. +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +128,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Veri Etiketlerini Biçimlendirme +### Eksen tipini değiştirme + +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **ekseni tarih‑tabanlı bir eksenden kategori eksenine** değiştirir ve etiket yerleşimi üzerinde tam kontrol sağlar. -Veri etiketlerini farklı sayı biçimleriyle biçimlendirebilirsiniz. İşte bir örnek: +## Grafik veri etiketlerini (sayı formatları) biçimlendirme + +Sayı formatlamasını doğrudan eksene veya veri etiketlerine uygulayabilirsiniz. Bu örnek Y‑ekseni sayılarını binlik ayırıcı ile biçimlendirir. ```java Document doc = new Document(); @@ -116,50 +142,48 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Varsayılan seriyi temizleyin ve verilerinizi ekleyin. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ``` -## Ek Grafik Özelleştirmeleri - -Sınırları, etiketler arasındaki aralık birimlerini, grafik eksenlerini gizlemeyi ve daha fazlasını ayarlayarak grafiklerinizi daha da özelleştirebilirsiniz. Bu seçenekler hakkında daha fazla bilgi edinmek için sağlanan kod parçacıklarını inceleyin. - -## Çözüm +## Ek grafik özelleştirmeleri -Bu eğitimde, Aspose.Words for Java kullanarak grafiklerle nasıl çalışılacağını inceledik. Çeşitli grafik türlerinin nasıl oluşturulacağını, eksen özelliklerinin nasıl özelleştirileceğini, veri etiketlerinin nasıl biçimlendirileceğini ve daha fazlasını öğrendiniz. Aspose.Words for Java, belgelerinize verilerin görsel temsillerini eklemek ve bilgileri sunma şeklinizi geliştirmek için güçlü araçlar sağlar. +Temel konuların ötesinde sınırları ayarlayabilir, etiketler arasındaki aralık birimlerini belirleyebilir, belirli eksenleri gizleyebilir ve daha fazlasını yapabilirsiniz. Tam özellik listesi için Aspose.Words for Java API dokümantasyonuna bakın. -## SSS +## Sık Sorulan Sorular -### Bir grafiğe birden fazla seri nasıl ekleyebilirim? +**S: Bir grafiğe birden fazla seri nasıl eklenir?** +C: Görüntülemek istediğiniz her seri için `chart.getSeries().add()` kullanın. Her çağrı benzersiz bir ad, kategori dizisi ve değer dizisi sağlayabilir. -Bir grafiğe birden fazla seriyi kullanarak ekleyebilirsiniz. `chart.getSeries().add()` yöntem. Seri adını, kategorileri ve veri değerlerini belirttiğinizden emin olun. +**S: Grafik veri etiketlerini özel sayı formatlarıyla nasıl biçimlendiririm?** +C: Bir serinin `DataLabels` nesnesine erişin ve `getNumberFormat().setFormatCode("your format")` çağırın. Ayrıca `isLinkedToSource(true)` ile formatı kaynak hücreye bağlayabilirsiniz. -### Veri etiketlerini özel sayı biçimleriyle nasıl biçimlendirebilirim? +**S: Bir grafik eksenini nasıl gizleyebilirim?** +C: Gizlemek istediğiniz `ChartAxis` üzerinde `setHidden(true)` çağırın (ör. `chart.getAxisY().setHidden(true)`). -Veri etiketlerini şuraya erişerek biçimlendirebilirsiniz: `DataLabels` bir serinin özelliklerini ve istenilen biçim kodunu kullanarak ayarlama `getNumberFormat().setFormatCode()`. +**S: Eksen tipini değiştirmek için en iyi yol nedir?** +C: Kategorik eksenler için `setCategoryType(AxisCategoryType.CATEGORY)`, tarih eksenleri için `AxisCategoryType.DATE` kullanın. -### Bir grafikteki eksen özelliklerini nasıl özelleştirebilirim? +**S: Bir seriye veri etiketleri nasıl eklenir?** +C: `series.hasDataLabels(true)` ile etkinleştirin ve ardından `series.getDataLabels().setShowValue(true)` ile görünürlüğü ayarlayın. -Tür, onay işaretleri, etiketler ve daha fazlası gibi eksen özelliklerini şuraya erişerek özelleştirebilirsiniz: `ChartAxis` gibi özellikler `setCategoryType()`, `setCrosses()`, Ve `setMajorTickMark()`. +## Sonuç -### Dağılım veya alan grafikleri gibi diğer grafik türlerini nasıl oluşturabilirim? +Aspose.Words for Java ile **sütun grafik** görselleştirmeleri oluşturmak için temel grafik ekleme, birden fazla seri ekleme, grafik veri etiketlerini biçimlendirme, eksen tipini değiştirme ve temiz bir görünüm için eksenleri gizleme konularını ele aldık. Bu teknikleri raporlama veya belge‑oluşturma süreçlerinize entegre ederek profesyonel, veri‑odaklı Word belgeleri sunabilirsiniz. -Uygun olanı belirterek çeşitli grafik türleri oluşturabilirsiniz. `ChartType` kullanarak grafik eklerken `builder.insertChart(ChartType.TYPE, width, height)`. - -### Bir grafik eksenini nasıl gizleyebilirim? - -Bir grafik eksenini ayarlayarak gizleyebilirsiniz. `setHidden(true)` eksenin özelliği. +--- +**Son Güncelleme:** 2025-12-13 +**Test Edilen:** Aspose.Words for Java 24.12 (en son) +**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/words/vietnamese/java/document-conversion-and-export/using-charts/_index.md b/words/vietnamese/java/document-conversion-and-export/using-charts/_index.md index 34806f653..5452de144 100644 --- a/words/vietnamese/java/document-conversion-and-export/using-charts/_index.md +++ b/words/vietnamese/java/document-conversion-and-export/using-charts/_index.md @@ -1,10 +1,12 @@ --- -"description": "Tìm hiểu cách tạo và tùy chỉnh biểu đồ trong Aspose.Words cho Java. Khám phá các loại biểu đồ, định dạng và thuộc tính trục để trực quan hóa dữ liệu." -"linktitle": "Sử dụng biểu đồ" -"second_title": "API xử lý tài liệu Java Aspose.Words" -"title": "Sử dụng Biểu đồ trong Aspose.Words cho Java" -"url": "/vi/java/document-conversion-and-export/using-charts/" -"weight": 12 +date: 2025-12-13 +description: Tìm hiểu cách tạo biểu đồ cột và định dạng nhãn dữ liệu biểu đồ với Aspose.Words + cho Java. Khám phá việc thêm nhiều chuỗi, thay đổi loại trục và ẩn trục biểu đồ. +linktitle: Using Charts +second_title: Aspose.Words Java Document Processing API +title: Cách tạo biểu đồ cột bằng Aspose.Words cho Java +url: /vi/java/document-conversion-and-export/using-charts/ +weight: 12 --- {{< blocks/products/pf/main-wrap-class >}} @@ -13,16 +15,49 @@ {{< blocks/products/pf/tutorial-page-section >}} -# Sử dụng Biểu đồ trong Aspose.Words cho Java +# Cách tạo biểu đồ cột bằng Aspose.Words cho Java +Trong hướng dẫn này, bạn sẽ **tạo biểu đồ cột** trực tiếp trong tài liệu Word bằng Aspose.Words cho Java. Chúng ta sẽ đi qua cách tạo các loại biểu đồ khác nhau, thêm nhiều series, định dạng nhãn dữ liệu của biểu đồ, thay đổi loại trục, và thậm chí ẩn một trục biểu đồ khi bạn cần giao diện sạch sẽ hơn. Khi hoàn thành, bạn sẽ có một phương pháp sẵn sàng cho sản xuất để nhúng các biểu đồ phong phú vào tài liệu của mình. -## Giới thiệu về cách sử dụng biểu đồ trong Aspose.Words cho Java +## Câu trả lời nhanh +- **Lớp chính để xây dựng biểu đồ là gì?** `DocumentBuilder` với `insertChart`. +- **Phương thức nào thêm một series mới?** `chart.getSeries().add(...)`. +- **Làm sao để định dạng nhãn dữ liệu của biểu đồ?** Sử dụng `getDataLabels().get(...).getNumberFormat().setFormatCode(...)`. +- **Có thể ẩn một trục không?** Có, gọi `setHidden(true)` trên đối tượng trục. +- **Có cần giấy phép cho Aspose.Words không?** Giấy phép bắt buộc cho môi trường sản xuất; bản dùng thử miễn phí có sẵn. -Trong hướng dẫn này, chúng ta sẽ khám phá cách làm việc với biểu đồ bằng Aspose.Words for Java. Bạn sẽ học cách tạo nhiều loại biểu đồ khác nhau, tùy chỉnh thuộc tính trục, định dạng nhãn dữ liệu, v.v. Hãy cùng tìm hiểu! +## Biểu đồ cột là gì và tại sao nên sử dụng? -## Tạo biểu đồ đường +Biểu đồ cột hiển thị dữ liệu phân loại dưới dạng các thanh dọc, rất phù hợp để so sánh giá trị giữa các nhóm (doanh số theo khu vực, chi phí hàng tháng, v.v.). Trong các ứng dụng Java, việc tạo biểu đồ cột bằng Aspose.Words cho phép bạn nhúng trực tiếp các hình ảnh này vào các tệp Word / DOCX mà không cần Excel hay công cụ bên ngoài. -Để tạo biểu đồ đường, hãy sử dụng mã sau: +## Cách tạo biểu đồ cột + +Dưới đây là một ví dụ đơn giản tạo một biểu đồ cột cơ bản. Mã nguồn giống hệt đoạn gốc – chúng tôi chỉ thêm các chú thích giải thích để dễ hiểu hơn. + +```java +Document doc = new Document(); +DocumentBuilder builder = new DocumentBuilder(doc); +Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); +Chart chart = shape.getChart(); + +// Delete default generated series. +chart.getSeries().clear(); + +// Creating categories and adding data. +String[] categories = new String[] { "Category 1", "Category 2" }; +chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); +chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); + +doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); +``` + +### Thêm nhiều series + +Bạn có thể **thêm nhiều series** vào biểu đồ cột bằng cách gọi `chart.getSeries().add(...)` liên tục, như đã minh họa ở trên. Mỗi series có thể có tập hợp danh mục và giá trị riêng, cho phép bạn so sánh nhiều bộ dữ liệu đồng thời. + +## Cách tạo biểu đồ đường với nhãn dữ liệu tùy chỉnh + +Nếu bạn cần một biểu đồ đường thay vì biểu đồ cột, cùng một mẫu sẽ áp dụng. Ví dụ này cũng minh họa **định dạng nhãn dữ liệu** với các định dạng số khác nhau. ```java Document doc = new Document(); @@ -31,10 +66,10 @@ Shape shape = builder.insertChart(ChartType.LINE, 432.0, 252.0); Chart chart = shape.getChart(); chart.getTitle().setText("Data Labels With Different Number Format"); -// Xóa chuỗi mặc định được tạo. +// Delete default generated series. chart.getSeries().clear(); -// Thêm một chuỗi dữ liệu và nhãn dữ liệu. +// Adding a series with data and data labels. ChartSeries series1 = chart.getSeries().add("Aspose Series 1", new String[] { "Category 1", "Category 2", "Category 3" }, new double[] { 2.5, 1.5, 3.5 }); @@ -45,36 +80,19 @@ series1.getDataLabels().get(0).getNumberFormat().setFormatCode("\"$\"#,##0.00"); series1.getDataLabels().get(1).getNumberFormat().setFormatCode("dd/mm/yyyy"); series1.getDataLabels().get(2).getNumberFormat().setFormatCode("0.00%"); -// Hoặc liên kết mã định dạng với ô nguồn. +// Or link format code to a source cell. series1.getDataLabels().get(2).getNumberFormat().isLinkedToSource(true); doc.save("Your Directory Path" + "WorkingWithCharts.FormatNumberOfDataLabel.docx"); ``` -## Tạo các loại biểu đồ khác +### Thêm nhãn dữ liệu -Bạn có thể tạo nhiều loại biểu đồ khác nhau như biểu đồ cột, biểu đồ diện tích, biểu đồ bong bóng, biểu đồ phân tán, v.v. bằng các kỹ thuật tương tự. Sau đây là ví dụ về cách chèn biểu đồ cột đơn giản: +Lệnh `series1.hasDataLabels(true)` **thêm nhãn dữ liệu** vào series, trong khi `setShowValue(true)` hiển thị giá trị thực tế trên biểu đồ. -```java -Document doc = new Document(); -DocumentBuilder builder = new DocumentBuilder(doc); -Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); -Chart chart = shape.getChart(); - -// Xóa chuỗi mặc định được tạo. -chart.getSeries().clear(); - -// Tạo danh mục và thêm dữ liệu. -String[] categories = new String[] { "Category 1", "Category 2" }; -chart.getSeries().add("Aspose Series 1", categories, new double[] { 1.0, 2.0 }); -chart.getSeries().add("Aspose Series 2", categories, new double[] { 3.0, 4.0 }); - -doc.save("Your Directory Path" + "WorkingWithCharts.InsertSimpleColumnChart.docx"); -``` +## Cách thay đổi loại trục và tùy chỉnh thuộc tính trục -## Tùy chỉnh Thuộc tính Trục - -Bạn có thể tùy chỉnh các thuộc tính trục, chẳng hạn như thay đổi loại trục, đặt dấu tích, định dạng nhãn, v.v. Sau đây là ví dụ về việc xác định các thuộc tính trục XY: +Thay đổi loại trục (ví dụ: từ ngày sang danh mục) cho phép bạn kiểm soát cách các điểm dữ liệu được vẽ. Đoạn mã này cũng cho thấy cách **ẩn trục biểu đồ** nếu bạn muốn thiết kế tối giản. ```java Document doc = new Document(); @@ -82,20 +100,23 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.AREA, 432.0, 252.0); Chart chart = shape.getChart(); -// Xóa chuỗi mặc định và thêm dữ liệu của bạn. +// Clear default series and add your data. ChartAxis xAxis = chart.getAxisX(); ChartAxis yAxis = chart.getAxisY(); -// Thay đổi trục X thành danh mục thay vì ngày tháng. +// Change the X axis to be a category instead of date. xAxis.setCategoryType(AxisCategoryType.CATEGORY); xAxis.setCrosses(AxisCrosses.CUSTOM); -xAxis.setCrossesAt(3.0); // Được đo theo đơn vị hiển thị của trục Y (hàng trăm). +xAxis.setCrossesAt(3.0); // Measured in display units of the Y axis (hundreds). xAxis.setReverseOrder(true); xAxis.setMajorTickMark(AxisTickMark.CROSS); xAxis.setMinorTickMark(AxisTickMark.OUTSIDE); xAxis.setTickLabelOffset(200); +// Example of hiding the Y axis. +yAxis.setHidden(true); + yAxis.setTickLabelPosition(AxisTickLabelPosition.HIGH); yAxis.setMajorUnit(100.0); yAxis.setMinorUnit(50.0); @@ -106,9 +127,13 @@ yAxis.getScaling().setMaximum(new AxisBound(700.0)); doc.save("Your Directory Path" + "WorkingWithCharts.DefineXYAxisProperties.docx"); ``` -## Định dạng nhãn dữ liệu +### Thay đổi loại trục + +`xAxis.setCategoryType(AxisCategoryType.CATEGORY)` **thay đổi loại trục** từ trục dựa trên ngày sang trục danh mục, giúp bạn kiểm soát hoàn toàn vị trí nhãn. -Bạn có thể định dạng nhãn dữ liệu với các định dạng số khác nhau. Sau đây là một ví dụ: +## Định dạng nhãn dữ liệu của biểu đồ (định dạng số) + +Bạn có thể áp dụng định dạng số trực tiếp cho trục hoặc nhãn dữ liệu. Ví dụ này định dạng các số trên trục Y với dấu phân cách hàng nghìn. ```java Document doc = new Document(); @@ -116,7 +141,7 @@ DocumentBuilder builder = new DocumentBuilder(doc); Shape shape = builder.insertChart(ChartType.COLUMN, 432.0, 252.0); Chart chart = shape.getChart(); -// Xóa chuỗi mặc định và thêm dữ liệu của bạn. +// Clear default series and add your data. chart.getAxisY().getNumberFormat().setFormatCode("#,##0"); @@ -125,41 +150,39 @@ doc.save("Your Directory Path" + "WorkingWithCharts.NumberFormatForAxis.docx"); ## Tùy chỉnh biểu đồ bổ sung -Bạn có thể tùy chỉnh thêm biểu đồ của mình bằng cách điều chỉnh ranh giới, đơn vị khoảng cách giữa các nhãn, ẩn trục biểu đồ, v.v. Khám phá các đoạn mã được cung cấp để tìm hiểu thêm về các tùy chọn này. - -## Phần kết luận - -Trong hướng dẫn này, chúng ta đã khám phá cách làm việc với biểu đồ bằng Aspose.Words for Java. Bạn đã học cách tạo nhiều loại biểu đồ, tùy chỉnh thuộc tính trục, định dạng nhãn dữ liệu, v.v. Aspose.Words for Java cung cấp các công cụ mạnh mẽ để thêm biểu diễn trực quan của dữ liệu vào tài liệu của bạn, nâng cao cách bạn trình bày thông tin. +Ngoài các chức năng cơ bản, bạn có thể điều chỉnh giới hạn, đặt đơn vị khoảng cách giữa các nhãn, ẩn các trục cụ thể, và nhiều hơn nữa. Tham khảo tài liệu API Aspose.Words cho Java để biết danh sách đầy đủ các thuộc tính. ## Câu hỏi thường gặp -### Làm thế nào để tôi có thể thêm nhiều chuỗi vào biểu đồ? +**Q: Làm sao để thêm nhiều series vào một biểu đồ?** +A: Sử dụng `chart.getSeries().add()` cho mỗi series bạn muốn hiển thị. Mỗi lời gọi có thể cung cấp tên duy nhất, mảng danh mục và mảng giá trị. -Bạn có thể thêm nhiều chuỗi vào biểu đồ bằng cách sử dụng `chart.getSeries().add()` phương pháp. Đảm bảo chỉ định tên sê-ri, danh mục và giá trị dữ liệu. +**Q: Làm sao để định dạng nhãn dữ liệu của biểu đồ với định dạng số tùy chỉnh?** +A: Truy cập đối tượng `DataLabels` của một series và gọi `getNumberFormat().setFormatCode("định dạng của bạn")`. Bạn cũng có thể liên kết định dạng với ô nguồn bằng `isLinkedToSource(true)`. -### Làm thế nào để định dạng nhãn dữ liệu theo định dạng số tùy chỉnh? +**Q: Làm sao để ẩn một trục biểu đồ?** +A: Gọi `setHidden(true)` trên `ChartAxis` mà bạn muốn ẩn (ví dụ: `chart.getAxisY().setHidden(true)`). -Bạn có thể định dạng nhãn dữ liệu bằng cách truy cập `DataLabels` thuộc tính của một chuỗi và thiết lập mã định dạng mong muốn bằng cách sử dụng `getNumberFormat().setFormatCode()`. +**Q: Cách tốt nhất để thay đổi loại trục là gì?** +A: Sử dụng `setCategoryType(AxisCategoryType.CATEGORY)` cho trục danh mục hoặc `AxisCategoryType.DATE` cho trục ngày. -### Làm thế nào để tùy chỉnh thuộc tính trục trong biểu đồ? +**Q: Làm sao để thêm nhãn dữ liệu vào một series?** +A: Kích hoạt chúng bằng `series.hasDataLabels(true)` và sau đó cấu hình hiển thị bằng `series.getDataLabels().setShowValue(true)`. -Bạn có thể tùy chỉnh các thuộc tính trục như loại, dấu tích, nhãn và nhiều hơn nữa bằng cách truy cập `ChartAxis` các thuộc tính như `setCategoryType()`, `setCrosses()`, Và `setMajorTickMark()`. +## Kết luận -### Làm thế nào tôi có thể tạo các loại biểu đồ khác như biểu đồ phân tán hoặc biểu đồ diện tích? +Chúng tôi đã trình bày mọi thứ bạn cần để **tạo biểu đồ cột** bằng Aspose.Words cho Java — từ việc chèn biểu đồ cơ bản và thêm nhiều series, đến định dạng nhãn dữ liệu, thay đổi loại trục và ẩn trục biểu đồ để có giao diện sạch sẽ. Áp dụng các kỹ thuật này vào quy trình báo cáo hoặc tạo tài liệu của bạn để cung cấp các tài liệu Word chuyên nghiệp, dựa trên dữ liệu. -Bạn có thể tạo nhiều loại biểu đồ khác nhau bằng cách chỉ định các loại biểu đồ thích hợp. `ChartType` khi chèn biểu đồ bằng cách sử dụng `builder.insertChart(ChartType.TYPE, width, height)`. - -### Làm thế nào để ẩn trục biểu đồ? - -Bạn có thể ẩn trục biểu đồ bằng cách thiết lập `setHidden(true)` tính chất của trục. +--- +**Cập nhật lần cuối:** 2025-12-13 +**Kiểm tra với:** Aspose.Words cho Java 24.12 (phiên bản mới nhất) +**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