Working with Charts

עבודה עם תרשימים

Aspose.Cells FOSS for Java preserves embedded charts when loading and saving XLSX workbooks. You can inspect existing charts, query their type and position, and add new standard-type charts programmatically. ChartEx types such as Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, and Map are preserved on round-trip but cannot be created through the API.

סקירה

תוצאות העבודה במדריך מנוהלות באמצעות ChartCollection גישה דרך Worksheet.getCharts().כל אחד Chart המאמר מפרט את שמו, סוג הדפוס שלו., והיא ממוקמת במצב של שני תאים.הדפוס החדש מופיע עם ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn), זה מחזיר את האינדקס של תרשים שנוצר לאחרונה.

The ChartType enum מזהה את הבורא של התרשים (בר, קו, פאי וכו ‘). שיטות עוזרות ChartCollection.parseChartType(string) ו ChartCollection.chartTypeToString(ChartType) הפוך בין ה- Enum ו הדפסה של המקור למקרים של שימוש בסריאליזציה.

מחלקות מפתח

שיעור	תיאור
`Chart`	מייצג תרשים מוטבע בדף עבודה.קרא גישה לשם, סוג, ותחום תא.
`ChartCollection`	אוסף של כל התרשים על לוח עבודה תומך בספירה, גישה לאינדקס, הוספת ועוזרי ההמרה סוג תרשים.
`ChartType`	Enum מזהה את הבורא של התרשים (בר, עמוד, קו, פאי, scatter, וכו ‘).
`ChartModel`	מודל סיריאליזציה פנימי עבור תרשים.חשיפה שדות XML ירוקים המשמשים במהלך העומס / ההצלה.

גישה לציור על לוח עבודה

להחזיר את ChartCollection מכל אחד Worksheet אובייקט דרך Worksheet.getCharts().שימוש ChartCollection.getCount() כדי לקבוע כמה תרשימים נוכחים.רשימות אישיות ניתן לגשת באמצעות אינדיקטור מבוסס אפס דרך ChartCollection.get(index).

ברגע שאתה מחזיק א Chart רשימה שאתם יכולים לקרוא:

Chart.getName() - שורת השם הפנימית של הדפוס.
Chart.getChartType() • The ChartType ערך של Enum.
Chart.getUpperLeftRow() / Chart.getUpperLeftColumn() הגלגל השמאלי העליון של האנקור.
Chart.getLowerRightRow() / Chart.getLowerRightColumn() תאי האנקור הימנית התחתונה.
Chart.getExtentCx() / Chart.getExtentCy() - התוכנית מתרחבת ב- EMUs.

להוסיף תרשים חדש

שימוש ChartCollection.add(type, dataRange, upperLeftRow, upperLeftColumn, lowerRightRow, lowerRightColumn) כדי להזין תרשים חדש.השיטה מחזירה את האינדקס הכולל של התרשים בתוך תגית: מספק א ChartType ערך עבור type תגיות ותא רצועת שורה (לדוגמה, A1:B5• עבור dataRange.

הערה: סוגים של משפחת ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) נשמרים בעת העלאת קבצי XLSX אך אינם נוצרים בתכנית באמצעות API זה.

סיכום התייחסות API

תרשים

שיטת	סוג החזרה	תיאור
`getName()`	`String`	שם פנימי של המפה.
`getChartType()`	`ChartType`	ערך האופנה הוא ערכים.
`getUpperLeftRow()`	`int`	מדד השורה של האנקור העליון-שמאל.
`getUpperLeftColumn()`	`int`	אינדיקטור עמוד של האנקורה השמאלית העליונה.
`getLowerRightRow()`	`int`	מדד שורה של האנקור הימני התחתון.
`getLowerRightColumn()`	`int`	אינדיקטור עמודי של האנקורה הימנית התחתונה.
`getExtentCx()`	`long`	צלחת רחב ב- EMUs.
`getExtentCy()`	`long`	גובה הדפוס ב- EMUs.

ChartCollection

שיטת	סוג החזרה	תיאור
`getCount()`	`int`	מספר המאמרים על לוח העבודה.
`get(index)`	`Chart`	החזיר את התרשים לנקודת אפס.
`add(type, dataRange, ...)`	`int`	הוסיף תרשים חדש; מחזיר את האינדקס שלו.
`parseChartType(string)`	`ChartType`	להפוך את שם הקו ל- A `ChartType` ערך של Enum.
`chartTypeToString(type)`	`String`	להפוך A `ChartType` ערך ה-enum לשם המזרן שלה.

הגבלות

סוגים של ChartEx (Waterfall, Treemap, Sunburst, Histogram, Box and Whisker, Funnel, Map) הם סביב-שורה verbatim אבל לא ניתן ליצור באמצעות API.
קבצי סדרת נתונים תרשים אינם ניתן לשנות בגרסה זו; רמזים תרשימים מבוססים על טווח הנתונים המקורי המסופק בזמן יצירה.

ראה גם

Aspose.Cells for Java — Enterprise Documentation