Class EmbeddedAreaChartBuilder

EmbeddedAreaChartBuilder

Builder לתרשימי שטח. לפרטים נוספים, ראו Gviz תיעוד.

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
addRange(range)	EmbeddedChartBuilder	הפונקציה מוסיפה טווח לתרשים שה-builder משנה.
asAreaChart()	EmbeddedAreaChartBuilder	הפונקציה מגדירה את סוג התרשים ל-RegionChart ומחזירה את הערך EmbeddedAreaChartBuilder.
asBarChart()	EmbeddedBarChartBuilder	הפונקציה מגדירה את סוג התרשים ל-BarChart ומחזירה את הערך EmbeddedBarChartBuilder.
asColumnChart()	EmbeddedColumnChartBuilder	הפונקציה מגדירה את סוג התרשים ל-ColumnChart ומחזירה את הערך EmbeddedColumnChartBuilder.
asComboChart()	EmbeddedComboChartBuilder	הפונקציה מגדירה את סוג התרשים ל-ComboChart ומחזירה את הערך EmbeddedComboChartBuilder.
asHistogramChart()	EmbeddedHistogramChartBuilder	הפונקציה מגדירה את סוג התרשים ל-HistogramChart ומחזירה את הערך EmbeddedHistogramChartBuilder.
asLineChart()	EmbeddedLineChartBuilder	הפונקציה מגדירה את סוג התרשים ל-LineChart ומחזירה את הערך EmbeddedLineChartBuilder.
asPieChart()	EmbeddedPieChartBuilder	הפונקציה מגדירה את סוג התרשים ל-PieChart ומחזירה את הערך EmbeddedPieChartBuilder.
asScatterChart()	EmbeddedScatterChartBuilder	הפונקציה מגדירה את סוג התרשים ל-ScatterChart ומחזירה את הערך EmbeddedScatterChartBuilder.
asTableChart()	EmbeddedTableChartBuilder	הפונקציה מגדירה את סוג התרשים ל-TableChart ומחזירה את הערך EmbeddedTableChartBuilder.
build()	EmbeddedChart	יצירת התרשים כך שישקף את כל השינויים שבוצעו בו.
clearRanges()	EmbeddedChartBuilder	כל הטווחים יוסרו מהתרשים שה-builder הזה משנה.
getChartType()	ChartType	מחזירה את סוג התרשים הנוכחי.
getContainer()	ContainerInfo	מחזירה את התרשים ContainerInfo, שכולל את המיקום שבו מופיע התרשים גיליון.
getRanges()	Range[]	מחזירה עותק של רשימת הטווחים שמספקים כרגע נתונים לתרשים הזה.
removeRange(range)	EmbeddedChartBuilder	הפונקציה מסירה את הטווח שצוין מהתרשים שה-builder משנה.
reverseCategories()	EmbeddedAreaChartBuilder	הופך את השרטוט של הסדרות בציר הדומיין.
setBackgroundColor(cssValue)	EmbeddedAreaChartBuilder	הגדרת צבע הרקע של התרשים.
setChartType(type)	EmbeddedChartBuilder	שינוי סוג התרשים.
setColors(cssValues)	EmbeddedAreaChartBuilder	הגדרת הצבעים של הקווים בתרשים.
setHiddenDimensionStrategy(strategy)	EmbeddedChartBuilder	מגדיר את האסטרטגיה שתשמש לשורות ולעמודות מוסתרות.
setLegendPosition(position)	EmbeddedAreaChartBuilder	מגדיר את המיקום של המקרא ביחס לתרשים.
setLegendTextStyle(textStyle)	EmbeddedAreaChartBuilder	מגדיר את סגנון הטקסט של מקרא התרשים.
setMergeStrategy(mergeStrategy)	EmbeddedChartBuilder	הגדרה של אסטרטגיית המיזוג לשימוש במקרים שבהם קיים יותר מטווח אחד.
setNumHeaders(headers)	EmbeddedChartBuilder	מגדירה את מספר השורות או העמודות בטווח שיש להתייחס אליהן ככותרות.
setOption(option, value)	EmbeddedChartBuilder	מגדיר אפשרויות מתקדמות לתרשים הזה.
setPointStyle(style)	EmbeddedAreaChartBuilder	מגדיר את הסגנון של נקודות בקו.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	EmbeddedChartBuilder	מגדיר את המיקום בגיליון ומשנה את המיקום שבו מופיע התרשים.
setRange(start, end)	EmbeddedAreaChartBuilder	מגדיר את הטווח של התרשים.
setStacked()	EmbeddedAreaChartBuilder	שימוש בקווים מוערמים, כלומר ערכי הקווים והעמודות מוערמים (נצברים).
setTitle(chartTitle)	EmbeddedAreaChartBuilder	מגדיר את שם התרשים.
setTitleTextStyle(textStyle)	EmbeddedAreaChartBuilder	מגדיר את סגנון הטקסט של כותרת התרשים.
setTransposeRowsAndColumns(transpose)	EmbeddedChartBuilder	המדיניות קובעת אם השורות והעמודות בתרשים יעברו טרנספורמציה.
setXAxisTextStyle(textStyle)	EmbeddedAreaChartBuilder	מגדיר את סגנון הטקסט של הציר האופקי.
setXAxisTitle(title)	EmbeddedAreaChartBuilder	הוספת כותרת לציר האופקי.
setXAxisTitleTextStyle(textStyle)	EmbeddedAreaChartBuilder	מגדיר את סגנון הטקסט של הכותרת של הציר האופקי.
setYAxisTextStyle(textStyle)	EmbeddedAreaChartBuilder	הגדרת סגנון הטקסט של הציר האנכי.
setYAxisTitle(title)	EmbeddedAreaChartBuilder	הוספת כותרת לציר האנכי.
setYAxisTitleTextStyle(textStyle)	EmbeddedAreaChartBuilder	הגדרת סגנון הטקסט של הכותרת של הציר האנכי.
useLogScale()	EmbeddedAreaChartBuilder	הופך את ציר הטווח לסולם לוגריתמי (כל הערכים צריכים להיות חיוביים).

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

addRange(range)

הפונקציה מוסיפה טווח לתרשים שה-builder משנה. לא מוסיפה את הטווח אם הוא כבר נוספו לתרשים.

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 – ה-builder הזה, ליצירת שרשורים

---

asAreaChart()

הפונקציה מגדירה את סוג התרשים ל-RegionChart ומחזירה את הערך 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()

כל הטווחים יוסרו מהתרשים שה-builder הזה משנה.

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 – ה-builder הזה, ליצירת שרשורים

---

getChartType()

מחזירה את סוג התרשים הנוכחי.

חזרה

ChartType – סוג התרשים

---

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)

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

הטווח שהוסר חייב להתאים לטווח שנוסף דרך 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 – ה-builder הזה, ליצירת שרשורים

---

reverseCategories()

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

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

חזרה

EmbeddedAreaChartBuilder – ה-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").

חזרה

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

---

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 – ה-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 בתרשים.

חזרה

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

---

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 – ה-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	המיקום של המקרא.

חזרה

EmbeddedAreaChartBuilder – ה-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	סגנון הטקסט לשימוש במקרא של התרשים.

חזרה

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

---

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 – ה-builder הזה, ליצירת שרשורים

---

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 – ה-builder הזה, ליצירת שרשורים

---

setOption(option, value)

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

השיטה הזו לא מאמתת שהאפשרות שציינתם תקפה לסוג התרשים הזה וגם לא אם הוא בפורמט/מבנה הנכונים.

בדוגמה הזו אפשר לראות איך לשנות את הכותרת ולהגדיר מקרא.

builder.setOption('title', 'Earnings projections');
builder.setOption('legend', {position: 'top', textStyle: {color: 'blue', fontSize: 16}});

פרמטרים

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

חזרה

EmbeddedChartBuilder – ה-builder הזה, לשרשורים.

---

setPointStyle(style)

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

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

פרמטרים

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

חזרה

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

ראה גם

• PointStyle

---

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 – ה-builder הזה, ליצירת שרשורים

---

setRange(start, end)

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

אם יש נקודות נתונים שנמצאות מחוץ לטווח, הטווח יורחב כך שיכלול את הנתונים האלה נקודות.

פרמטרים

שם	סוג	תיאור
start	Number	הערך של קו הרשת הנמוך ביותר של ציר הטווח.
end	Number	הערך של קו הרשת הגבוה ביותר בציר הטווח.

חזרה

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

---

setStacked()

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

חזרה

EmbeddedAreaChartBuilder – ה-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	כותרת התרשים.

חזרה

EmbeddedAreaChartBuilder – ה-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().

חזרה

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

---

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 – ה-builder הזה, ליצירת שרשורים

---

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().

חזרה

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

---

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.

חזרה

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

---

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().

חזרה

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

---

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().

חזרה

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

---

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.

חזרה

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

---

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().

חזרה

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

---

useLogScale()

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

חזרה

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