דף זה תורגם על ידי Cloud Translation API.

Class PieChartBuilder

כלי ליצירת תרשימי עוגה. מידע נוסף זמין במסמכי התיעוד של Google Charts.

הדוגמה הבאה מראה איך ליצור תרשים עוגה. הנתונים מיובאים מגיליון אלקטרוני של Google.

  // Get sample data from a spreadsheet.
  var dataSourceUrl = 'https://docs.google.com/spreadsheet/tq?range=A1%3AB8' +
      '&key=0Aq4s9w_HxMs7dHpfX05JdmVSb1FpT21sbXd4NVE3UEE&gid=3&headers=-1';

  var chartBuilder = Charts.newPieChart()
      .setTitle('World Population by Continent')
      .setDimensions(600, 500)
      .set3D()
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`build()`	`Chart`	יצירת התרשים.
`reverseCategories()`	`PieChartBuilder`	הופך את השרטוט של הסדרות בציר הדומיין.
`set3D()`	`PieChartBuilder`	הגדרת התרשים לתלת-ממדי.
`setBackgroundColor(cssValue)`	`PieChartBuilder`	הגדרת צבע הרקע של התרשים.
`setColors(cssValues)`	`PieChartBuilder`	הגדרת הצבעים של הקווים בתרשים.
`setDataSourceUrl(url)`	`PieChartBuilder`	מגדיר את כתובת ה-URL של מקור הנתונים שמשמש לשליפת נתונים ממקור חיצוני, כמו Google גיליונות
`setDataTable(tableBuilder)`	`PieChartBuilder`	מגדירה את טבלת הנתונים שתשמש את התרשים באמצעות DataTableBuilder.
`setDataTable(table)`	`PieChartBuilder`	מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים, ואת התוויות של ציר ה-X.
`setDataViewDefinition(dataViewDefinition)`	`PieChartBuilder`	מגדיר את ההגדרה של תצוגת הנתונים שתשמש את התרשים.
`setDimensions(width, height)`	`PieChartBuilder`	מגדיר את המימדים של התרשים.
`setLegendPosition(position)`	`PieChartBuilder`	מגדיר את המיקום של המקרא ביחס לתרשים.
`setLegendTextStyle(textStyle)`	`PieChartBuilder`	מגדיר את סגנון הטקסט של מקרא התרשים.
`setOption(option, value)`	`PieChartBuilder`	מגדיר אפשרויות מתקדמות לתרשים הזה.
`setTitle(chartTitle)`	`PieChartBuilder`	מגדיר את שם התרשים.
`setTitleTextStyle(textStyle)`	`PieChartBuilder`	מגדיר את סגנון הטקסט של כותרת התרשים.

מסמכי תיעוד מפורטים

`build()`

יצירת התרשים.

חזרה

Chart - אובייקט תרשים שאפשר להטמיע במסמכים, ברכיבי ממשק משתמש או להשתמש בו כאובייקט סטטי תמונה.

`reverseCategories()`

הופך את השרטוט של הסדרות בציר הדומיין. בתרשימים מטווח אנכי (כמו קו, תרשימי שטח או תרשימי עמודות אנכיים), כלומר הציר האופקי משורטט מימין לשמאל. עבור תרשימי טווח אופקיים (כמו תרשימי עמודות), כלומר הציר האנכי נמשך מלמעלה למטה למטה. בתרשימי עוגה, המשמעות היא שהפרוסות משורטטות נגד כיוון השעון.

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`set3D()`

הגדרת התרשים לתלת-ממדי.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setBackgroundColor(cssValue)`

הגדרת צבע הרקע של התרשים.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

פרמטרים

שם	סוג	תיאור
`cssValue`	`String`	ערך ה-CSS של הצבע (למשל `"blue"` או `"#00f"`).

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setColors(cssValues)`

הגדרת הצבעים של הקווים בתרשים.

// Creates a line chart builder and sets the first two lines to be drawn in green and red,
// respectively.
var builder = Charts.newLineChart();
builder.setColors(["green", "red"]);

פרמטרים

שם	סוג	תיאור
`cssValues`	`String[]`	מערך של ערכי CSS של צבעים, כמו `["red", "#acf"]`. רכיב ה-n במערך מייצג את הצבע של קו ה-n בתרשים.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setDataSourceUrl(url)`

מגדיר את כתובת ה-URL של מקור הנתונים שמשמש לשליפת נתונים ממקור חיצוני, כמו Google גיליונות אם סופקו כתובת URL של מקור נתונים ו-DataTable, המערכת מתעלמת מכתובת ה-URL של מקור הנתונים.

מידע נוסף על שליחת שאילתות למקורות נתונים זמין במסמכי התיעוד של Google Charts.

פרמטרים

שם	סוג	תיאור
`url`	`String`	כתובת ה-URL של מקור הנתונים, כולל הפרמטרים של השאילתה.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setDataTable(tableBuilder)`

מגדירה את טבלת הנתונים שתשמש את התרשים באמצעות DataTableBuilder. זוהי שיטה נוחה להגדרת טבלת הנתונים בלי שתצטרכו לקרוא ל-build().

פרמטרים

שם	סוג	תיאור
`tableBuilder`	`DataTableBuilder`	כלי לבניית טבלאות נתונים טבלת נתונים חדשה נוצרת באופן מיידי כחלק כך שעדכונים נוספים ב-builder לא יבואו לידי ביטוי בתרשים.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setDataTable(table)`

מגדיר את טבלת הנתונים שמכילה את הקווים של התרשים, ואת התוויות של ציר ה-X. העמודה הראשונה צריכה להיות מחרוזת ולהכיל את התוויות של הציר האופקי. כל מספר של עמודות יכולים לעקוב, וכולם חייבים להיות מספריים. כל עמודה מוצגת כשורה נפרדת.

פרמטרים

שם	סוג	תיאור
`table`	`DataTableSource`	טבלת הנתונים שבה ייעשה שימוש עבור התרשים.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setDataViewDefinition(dataViewDefinition)`

מגדיר את ההגדרה של תצוגת הנתונים שתשמש את התרשים.

פרמטרים

שם	סוג	תיאור
`dataViewDefinition`	`DataViewDefinition`	אובייקט של הגדרה של תצוגת נתונים שמגדיר את התצוגה שאמורה להיות נגזר ממקור הנתונים הנתון של שרטוט התרשים.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setDimensions(width, height)`

מגדיר את המימדים של התרשים.

פרמטרים

שם	סוג	תיאור
`width`	`Integer`	רוחב התרשים, בפיקסלים.
`height`	`Integer`	גובה התרשים, בפיקסלים.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setLegendPosition(position)`

מגדיר את המיקום של המקרא ביחס לתרשים. כברירת מחדל, אין מקרא.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

פרמטרים

שם	סוג	תיאור
`position`	`Position`	המיקום של המקרא.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setLegendTextStyle(textStyle)`

מגדיר את סגנון הטקסט של מקרא התרשים.

// Creates a line chart builder and sets it up for a  blue, 26-point legend.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setLegendTextStyle(style);

פרמטרים

שם	סוג	תיאור
`textStyle`	`TextStyle`	סגנון הטקסט לשימוש במקרא של התרשים.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setOption(option, value)`

מגדיר אפשרויות מתקדמות לתרשים הזה. אלה האפשרויות הזמינות עבור מהתרשים הזה. לשיטה הזו אין השפעה אם האפשרות הנתונה לא חוקית.

// Build a pie chart with a pretty legend.
var builder = Charts.newPieChart();
builder.setOption('legend', {textStyle: {color: 'blue', fontSize: 16}});
var chart = builder.build();

פרמטרים

שם	סוג	תיאור
`option`	`String`	האפשרות להגדיר.
`value`	`Object`	הערך שיש להגדיר.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setTitle(chartTitle)`

מגדיר את שם התרשים. הכותרת מוצגת במרכז מעל התרשים.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

פרמטרים

שם	סוג	תיאור
`chartTitle`	`String`	כותרת התרשים.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.

`setTitleTextStyle(textStyle)`

מגדיר את סגנון הטקסט של כותרת התרשים.

// Creates a line chart builder and sets it up for a  blue, 26-point title.
var textStyleBuilder = Charts.newTextStyle().setColor('#0000FF').setFontSize(26);
var style = textStyleBuilder.build();
var builder = Charts.newLineChart();
builder.setTitleTextStyle(style);

פרמטרים

שם	סוג	תיאור
`textStyle`	`TextStyle`	סגנון הטקסט שיופיע בכותרת התרשים. אפשר ליצור אובייקט `TextStyleBuilder` באמצעות קריאה ל-`Charts.newTextStyle()`.

חזרה

PieChartBuilder – ה-builder הזה, שימושי ליצירת שרשורים.