כלי לבניית תרשימי היסטוגרמה. לפרטים נוספים, עיינו ב מסמכי התיעוד של Gviz.
שיטות
תיעוד מפורט
addRange(range)
מוסיף טווח לתרשים שהכלי הזה משנה אותו. אי אפשר להוסיף את הטווח אם הוא כבר נוסף לתרשים.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var chart = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(sheet.getRange("A1:B8"))
.setPosition(5, 5, 0, 0)
.build();
sheet.insertChart(chart);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
range | Range | הטווח שיש להוסיף. |
החזרות
EmbeddedChartBuilder – הכלי הזה ליצירת שרשורים
asAreaChart()
מגדירה את סוג התרשים כ-AreaChart ומחזירה EmbeddedAreaChartBuilder.
החזרות
EmbeddedAreaChartBuilder – כלי לבניית תרשים שטח
asBarChart()
מגדירה את סוג התרשים ל-BarChart ומחזירה EmbeddedBarChartBuilder.
החזרות
EmbeddedBarChartBuilder – כלי לבניית תרשים עמודות
asColumnChart()
מגדירה את סוג התרשים ל-ColumnChart ומחזירה EmbeddedColumnChartBuilder.
החזרות
EmbeddedColumnChartBuilder – כלי לבניית תרשים עמודות אנכי
asComboChart()
סוג התרשים מגדיר את סוג התרשים כ-ComboChart ומחזיר EmbeddedComboChartBuilder.
החזרות
EmbeddedComboChartBuilder – כלי לבניית תרשים משולב
asHistogramChart()
מגדירה את סוג התרשים ל-HistogramChart ומחזירה EmbeddedHistogramChartBuilder.
החזרות
EmbeddedHistogramChartBuilder – כלי לבניית תרשים היסטוגרמה
asLineChart()
מגדירה את סוג התרשים ל-LineChart ומחזירה EmbeddedLineChartBuilder.
החזרות
EmbeddedLineChartBuilder – כלי לבניית תרשים קו
asPieChart()
מגדירה את סוג התרשים ל-PieChart ומחזירה EmbeddedPieChartBuilder.
החזרות
EmbeddedPieChartBuilder – כלי לבניית תרשים עוגה
asScatterChart()
מגדירה את סוג התרשים ל-ScatterChart ומחזירה EmbeddedScatterChartBuilder.
החזרות
EmbeddedScatterChartBuilder – כלי לבניית תרשים פיזור
asTableChart()
מגדירה את סוג התרשים ל-TableChart ומחזירה EmbeddedTableChartBuilder.
החזרות
EmbeddedTableChartBuilder – כלי לבניית תרשים טבלה
build()
יוצר את התרשים כך שישקף את כל השינויים שבוצעו בו.
שיטה זו לא משרטטת באופן אוטומטי את התרשים על גבי הגיליון האלקטרוני. הוספת תרשים חדש צריכה להתבצע דרך sheet.insertChart(chart), ותרשים קיים צריך להתעדכן דרך sheet.updateChart(chart).
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(range)
.setPosition(5, 5, 0, 0)
.build();
sheet.insertChart(chart);
החזרות
EmbeddedChart - התרשים שנוצר, שעדיין יש להוסיף לגיליון האלקטרוני
clearRanges()
מסיר את כל הטווחים מהתרשים שהכלי הזה משנה.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// This code updates the chart to use only the new ranges while preserving the existing
// formatting of the chart.
var chart = sheet.getCharts()[0];
var newChart = chart
.modify()
.clearRanges()
.addRange(sheet.getRange("A1:A5"))
.addRange(sheet.getRange("B1:B5"))
.build();
sheet.updateChart(newChart);
החזרות
EmbeddedChartBuilder – הכלי הזה ליצירת שרשורים
getChartType()
getContainer()
מחזירים את התרשים ContainerInfo, שכולל את המיקום שבו מופיע התרשים בגיליון.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var chartBuilder = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(sheet.getRange("A1:B8"))
.setPosition(5, 5, 0, 0);
// This method returns the exact same data as Chart#getContainerInfo()
var containerInfo = chartBuilder.getContainer();
// Logs the values we used in setPosition()
Logger.log("Anchor Column: %s\r\nAnchor Row %s\r\nOffset X %s\r\nOffset Y %s",
containerInfo.getAnchorColumn(),
containerInfo.getAnchorRow(),
containerInfo.getOffsetX(),
containerInfo.getOffsetY());
החזרות
ContainerInfo – אובייקט שמכיל את המיקום של מאגר התגים בתרשים
getRanges()
מחזירה עותק של רשימת הטווחים שמספקים כרגע נתונים לתרשים הזה. יש להשתמש ב-addRange(range) וב-removeRange(range) כדי לשנות את הרשימה הזו.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var chartBuilder = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(sheet.getRange("A1:B8"))
.setPosition(5, 5, 0, 0);
var ranges = chartBuilder.getRanges();
// There's only one range as a data source for this chart,
// so this logs "A1:B8"
for (var i in ranges) {
var range = ranges[i];
Logger.log(range.getA1Notation());
}
החזרות
Range[] – מערך של טווחים שמשמשים כמקור הנתונים של התרשים לבנייה
removeRange(range)
מסיר את הטווח שצוין מהתרשים שהכלי הזה משנה. לא מופיעה הודעת שגיאה אם הטווח לא נמצא בתרשים הזה.
הטווח שהוסר חייב להתאים לטווח שנוסף דרך addRange(range), אחרת לא יבוצע שינוי בתרשים. לא ניתן להשתמש בשיטה הזו כדי להסיר
ערכים באופן חלקי מטווח.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var firstRange = sheet.getRange("A1:B5");
var secondRange = sheet.getRange("A6:B8");
var chartBuilder = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(firstRange)
// This range will render in a different color
.addRange(secondRange)
.setPosition(5, 5, 0, 0);
// Note that you can use either of these two formats, but the range
// MUST match up with a range that was added via addRange(), or it
// will not be removed, and will not throw an exception
chartBuilder.removeRange(firstRange);
chartBuilder.removeRange(sheet.getRange("A6:B8"));
var chart = chartBuilder.build();
sheet.insertChart(chart);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
range | Range | הטווח שיש להסיר. |
החזרות
EmbeddedChartBuilder – הכלי הזה ליצירת שרשורים
reverseCategories()
הופכת את ציור הסדרות בציר הדומיין. בתרשימים של טווח אנכי (כמו תרשימי קו, תרשימי שטח או עמודות), המשמעות היא שהציר האופקי משורטט מימין לשמאל. בתרשימים בטווח אופקי (כמו תרשימי עמודות), הציר האנכי משורטט מלמעלה למטה. בתרשימי עוגה, המשמעות היא שהפרוסות משורטטות נגד כיוון השעון.
// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner. var builder = Charts.newPieChart(); builder.reverseCategories();
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
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"). |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setChartType(type)
שינוי סוג התרשים. לא כל סוגי התרשימים המוטמעים נתמכים בשלב זה. ChartType.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(range)
.setPosition(5, 5, 0, 0)
.build();
sheet.insertChart(chart);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
type | ChartType | הסוג שאליו רוצים לשנות את התרשים. |
החזרות
EmbeddedChartBuilder – הכלי הזה ליצירת שרשורים
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 בתרשים. |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setHiddenDimensionStrategy(strategy)
מגדיר את האסטרטגיה לשימוש עבור שורות ועמודות מוסתרות. ברירת המחדל היא IGNORE_ROWS.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(range)
.setHiddenDimensionStrategy(Charts.ChartHiddenDimensionStrategy.IGNORE_COLUMNS)
.setPosition(5, 5, 0, 0)
.build();
sheet.insertChart(chart);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
strategy | ChartHiddenDimensionStrategy | האסטרטגיה לשימוש עבור שורות ועמודות מוסתרות. |
החזרות
EmbeddedChartBuilder – הכלי הזה ליצירת שרשורים
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 | המיקום של המקרא. |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
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 | סגנון הטקסט לשימוש במקרא של התרשים. |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setMergeStrategy(mergeStrategy)
מגדיר את אסטרטגיית המיזוג לשימוש כאשר קיים יותר מטווח אחד. במקרה של MERGE_ROWS השורות ממוזגות, ואם הערך הוא MERGE_COLUMNS, העמודות ממוזגות. ברירת המחדל היא MERGE_COLUMNS.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B10");
var range2 = sheet.getRange("C:C10");
var chart = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(range)
.addRange(range2)
.setMergeStrategy(Charts.ChartMergeStrategy.MERGE_ROWS)
.setPosition(5, 5, 0, 0)
.build();
sheet.insertChart(chart);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
mergeStrategy | ChartMergeStrategy | אסטרטגיית המיזוג לשימוש. |
החזרות
EmbeddedChartBuilder – הכלי הזה ליצירת שרשורים
setNumHeaders(headers)
המדיניות מגדירה את מספר השורות או העמודות בטווח שיש להתייחס אליהן ככותרות.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(range)
.setNumHeaders(1)
.setPosition(5, 5, 0, 0)
.build();
sheet.insertChart(chart);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
headers | Integer | מספר השורות או העמודות שיש להתייחס אליהן ככותרות. ערכים שליליים גורמים לזיהוי אוטומטי של כותרות. |
החזרות
EmbeddedChartBuilder – הכלי הזה ליצירת שרשורים
setOption(option, value)
מגדיר אפשרויות מתקדמות לתרשים הזה. במאמר אפשרויות הגדרה שלChart תוכלו לראות רשימה של האפשרויות הזמינות.
השיטה הזו לא מאמתת שהאפשרות שציינתם חוקית לסוג התרשים הזה, וגם לא כאשר הערך הוא בפורמט או במבנה הנכונים.
בדוגמה הזו מוסבר איך לשנות את הכותרת ולהגדיר מקרא.
builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
option | String | שם האפשרות. |
value | Object | הערך של האפשרות. |
החזרות
EmbeddedChartBuilder – הכלי הזה – לשרשורים.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)
הגדרת המיקום תוך שינוי המיקום של התרשים בגיליון. anchorRowPos ו-anchorColPos נוספו לאינדקס אחד.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(range)
.setPosition(5, 5, 0, 0)
.build();
sheet.insertChart(chart);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
anchorRowPos | Integer | הצד העליון של התרשים מעוגן בשורה זו. |
anchorColPos | Integer | הצד הימני של התרשים מעוגן בעמודה זו. |
offsetX | Integer | מספר הפיקסלים הזה משתנה לפי הפינה השמאלית העליונה של התרשים. |
offsetY | Integer | מספר הפיקסלים הזה משתנה לפי הפינה השמאלית התחתונה של התרשים. |
החזרות
EmbeddedChartBuilder – הכלי הזה ליצירת שרשורים
setRange(start, end)
הגדרת הטווח של התרשים.
אם נקודות נתונים כלשהן נמצאות מחוץ לטווח, הטווח מורחב כך שיכלול את הנקודות האלה.
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
start | Number | הערך של קו הרשת הנמוך ביותר של ציר הטווח. |
end | Number | הערך של קו הרשת הגבוה ביותר בציר הטווח. |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setStacked()
הפונקציה משתמשת בקווים מוערם, כלומר שערכי הקו והעמודות מוערם (נצברים). כברירת מחדל, אין מקבצים.
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setTitle(chartTitle)
הגדרת כותרת התרשים. הכותרת מוצגת במרכז התרשים.
// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
chartTitle | String | את כותרת התרשים. |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
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(). |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setTransposeRowsAndColumns(transpose)
המדיניות הזו קובעת אם השורות והעמודות בתרשים יוצגו בשקפים. אם הערך הוא true, השורות והעמודות מתחלפות. ברירת המחדל היא false.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B5");
var chart = sheet.newChart()
.setChartType(Charts.ChartType.BAR)
.addRange(range)
.setTransposeRowsAndColumns(true)
.setPosition(5, 5, 0, 0)
.build();
sheet.insertChart(chart);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
transpose | Boolean | אם הערך הוא true, השורות והעמודות שמשמשות לבניית התרשים משתנות. |
החזרות
EmbeddedChartBuilder – הכלי הזה ליצירת שרשורים
setXAxisTextStyle(textStyle)
מגדיר את סגנון הטקסט של הציר האופקי.
// Creates a line chart builder and sets the X-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
textStyle | TextStyle | סגנון הטקסט לשימוש בכותרת של הציר האופקי. ניתן ליצור אובייקט TextStyleBuilder על ידי קריאה ל-Charts.newTextStyle(). |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setXAxisTitle(title)
הוספת כותרת לציר האופקי. הכותרת ממורכזת ומופיעה מתחת לתוויות הערך של הציר.
// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
title | String | הכותרת של ציר ה-X. |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setXAxisTitleTextStyle(textStyle)
מגדיר את סגנון הטקסט של הכותרת בציר האופקי.
// Creates a line chart builder and sets the X-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
textStyle | TextStyle | סגנון הטקסט לשימוש בכותרת של הציר האופקי. ניתן ליצור אובייקט TextStyleBuilder על ידי קריאה ל-Charts.newTextStyle(). |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setYAxisTextStyle(textStyle)
מגדיר את סגנון הטקסט של הציר האנכי.
// Creates a line chart builder and sets the Y-axis text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
textStyle | TextStyle | סגנון הטקסט לשימוש בכותרת של הציר האופקי. ניתן ליצור אובייקט TextStyleBuilder על ידי קריאה ל-Charts.newTextStyle(). |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setYAxisTitle(title)
הוספת כותרת לציר האנכי. הכותרת ממורכזת ומופיעה מימין לתוויות הערכים.
// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
title | String | הכותרת של ציר ה-Y. |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
setYAxisTitleTextStyle(textStyle)
מגדיר את סגנון הטקסט של הכותרת בציר האנכי.
// Creates a line chart builder and sets the Y-axis title text style to blue, 18-point font.
var textStyle = Charts.newTextStyle().setColor('blue').setFontSize(18).build();
var builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);
פרמטרים
| שם | תיאור | התיאור |
|---|---|---|
textStyle | TextStyle | סגנון הטקסט לשימוש בכותרת של הציר האופקי. ניתן ליצור אובייקט TextStyleBuilder על ידי קריאה ל-Charts.newTextStyle(). |
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.
useLogScale()
הופכת את ציר הטווח לקנה מידה לוגריתמי (מחייב שכל הערכים יהיו חיוביים). ציר הטווח הוא הציר האנכי בתרשימים אנכיים (כמו קו, שטח או עמודה) והציר האופקי לתרשימים אופקיים (כמו עמודות).
החזרות
EmbeddedHistogramChartBuilder – הכלי הזה – שימושי ליצירת שרשורים.