Class ScatterChartBuilder

ScatterChartBuilder

سازنده نمودارهای پراکندگی. برای جزئیات بیشتر، به مستندات نمودارهای Google مراجعه کنید.

در اینجا مثالی آورده شده است که نحوه ساخت نمودار پراکندگی را نشان می دهد. داده‌ها از صفحه‌گسترده Google وارد می‌شوند .

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

var chartBuilder = Charts.newScatterChart()
    .setTitle('Adjusted GDP & U.S. Population')
    .setXAxisTitle('U.S. Population (millions)')
    .setYAxisTitle('Adjusted GDP ($ billions)')
    .setDimensions(600, 500)
    .setLegendPosition(Charts.Position.NONE)
    .setDataSourceUrl(dataSourceUrl);

var chart = chartBuilder.build();

مواد و روش ها

روش نوع برگشت توضیح مختصر
build() Chart نمودار را می سازد.
setBackgroundColor(cssValue) ScatterChartBuilder رنگ پس زمینه نمودار را تنظیم می کند.
setColors(cssValues) ScatterChartBuilder رنگ ها را برای خطوط در نمودار تنظیم می کند.
setDataSourceUrl(url) ScatterChartBuilder URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند Google Sheets استفاده می شود.
setDataTable(tableBuilder) ScatterChartBuilder جدول داده را برای استفاده برای نمودار با استفاده از DataTableBuilder تنظیم می کند.
setDataTable(table) ScatterChartBuilder جدول داده ای را که شامل خطوط نمودار و همچنین برچسب های محور X است را تنظیم می کند.
setDataViewDefinition(dataViewDefinition) ScatterChartBuilder تعریف نمای داده را برای استفاده برای نمودار تنظیم می کند.
setDimensions(width, height) ScatterChartBuilder ابعاد نمودار را تعیین می کند.
setLegendPosition(position) ScatterChartBuilder موقعیت افسانه را با توجه به نمودار تنظیم می کند.
setLegendTextStyle(textStyle) ScatterChartBuilder سبک متن افسانه نمودار را تنظیم می کند.
setOption(option, value) ScatterChartBuilder گزینه های پیشرفته را برای این نمودار تنظیم می کند.
setPointStyle(style) ScatterChartBuilder استایل را برای نقاط در خط تنظیم می کند.
setTitle(chartTitle) ScatterChartBuilder عنوان نمودار را تعیین می کند.
setTitleTextStyle(textStyle) ScatterChartBuilder سبک متن عنوان نمودار را تنظیم می کند.
setXAxisLogScale() ScatterChartBuilder محور افقی را به یک مقیاس لگاریتمی تبدیل می کند (نیاز به مثبت بودن همه مقادیر دارد).
setXAxisRange(start, end) ScatterChartBuilder محدوده را برای محور افقی نمودار تنظیم می کند.
setXAxisTextStyle(textStyle) ScatterChartBuilder سبک متن محور افقی را تنظیم می کند.
setXAxisTitle(title) ScatterChartBuilder عنوانی را به محور افقی اضافه می کند.
setXAxisTitleTextStyle(textStyle) ScatterChartBuilder سبک متن عنوان محور افقی را تنظیم می کند.
setYAxisLogScale() ScatterChartBuilder محور عمودی را به یک مقیاس لگاریتمی تبدیل می کند (نیاز به مثبت بودن همه مقادیر دارد).
setYAxisRange(start, end) ScatterChartBuilder محدوده را برای محور عمودی نمودار تنظیم می کند.
setYAxisTextStyle(textStyle) ScatterChartBuilder سبک متن محور عمودی را تنظیم می کند.
setYAxisTitle(title) ScatterChartBuilder عنوانی را به محور عمودی اضافه می کند.
setYAxisTitleTextStyle(textStyle) ScatterChartBuilder سبک متن عنوان محور عمودی را تنظیم می کند.

مستندات دقیق

build()

نمودار را می سازد.

برگشت

Chart - یک شی نمودار، که می تواند در اسناد، عناصر رابط کاربری جاسازی شود یا به عنوان یک تصویر ثابت استفاده شود.

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

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

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 ام در نمودار است.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setDataSourceUrl(url)

URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند Google Sheets استفاده می شود. اگر یک URL منبع داده و یک DataTable ارائه شود، URL منبع داده نادیده گرفته می شود.

برای اطلاعات بیشتر در مورد جستجوی منابع داده، اسناد Google Charts را بررسی کنید.

مولفه های

نام تایپ کنید شرح
url String نشانی وب منبع داده، از جمله هر پارامتر پرس و جو.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setDataTable(tableBuilder)

جدول داده را برای استفاده برای نمودار با استفاده از DataTableBuilder تنظیم می کند. این یک روش راحت برای تنظیم جدول داده ها بدون نیاز به فراخوانی build() است.

مولفه های

نام تایپ کنید شرح
tableBuilder DataTableBuilder سازنده جدول داده ها یک جدول داده جدید فوراً به عنوان بخشی از این تماس ایجاد می‌شود، بنابراین هرگونه به‌روزرسانی بیشتر برای سازنده در نمودار منعکس نمی‌شود.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setDataTable(table)

جدول داده ای را که شامل خطوط نمودار و همچنین برچسب های محور X است را تنظیم می کند. ستون اول باید یک رشته باشد و حاوی برچسب های محور افقی باشد. هر تعداد ستون می تواند دنبال شود، همه باید عددی باشند. هر ستون به صورت یک خط جداگانه نمایش داده می شود.

مولفه های

نام تایپ کنید شرح
table DataTableSource جدول داده برای استفاده برای نمودار.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setDataViewDefinition(dataViewDefinition)

تعریف نمای داده را برای استفاده برای نمودار تنظیم می کند.

مولفه های

نام تایپ کنید شرح
dataViewDefinition DataViewDefinition یک شی تعریف نمای داده که نمایه ای را که باید از منبع داده داده شده برای ترسیم نمودار مشتق شود، تعریف می کند.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setDimensions(width, height)

ابعاد نمودار را تعیین می کند.

مولفه های

نام تایپ کنید شرح
width Integer عرض نمودار، بر حسب پیکسل.
height Integer ارتفاع نمودار، بر حسب پیکسل.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

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 موقعیت افسانه.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

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 سبک متن برای استفاده برای افسانه نمودار.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setOption(option, value)

گزینه های پیشرفته را برای این نمودار تنظیم می کند. گزینه های موجود برای این نمودار را ببینید. اگر گزینه داده شده نامعتبر باشد، این روش تاثیری ندارد.

// Build a scatter chart with a 1-second animation duration.
var builder = Charts.newScatterChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

مولفه های

نام تایپ کنید شرح
option String گزینه تنظیم.
value Object مقدار برای تنظیم

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setPointStyle(style)

استایل را برای نقاط در خط تنظیم می کند. به طور پیش فرض، نقاط هیچ سبک خاصی ندارند و فقط خط قابل مشاهده است.

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

مولفه های

نام تایپ کنید شرح
style PointStyle سبک مورد استفاده برای نقاط در خط.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

همچنین ببینید

setTitle(chartTitle)

عنوان نمودار را تعیین می کند. عنوان در مرکز بالای نمودار نمایش داده می شود.

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

مولفه های

نام تایپ کنید شرح
chartTitle String عنوان نمودار

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

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 سبک متنی که برای عنوان نمودار استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setXAxisLogScale()

محور افقی را به یک مقیاس لگاریتمی تبدیل می کند (نیاز به مثبت بودن همه مقادیر دارد).

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setXAxisRange(start, end)

محدوده را برای محور افقی نمودار تنظیم می کند.

اگر هر یک از نقاط داده خارج از محدوده باشد، محدوده برای شامل آن نقاط داده گسترش می یابد.

// Creates a scatter chart builder and sets the X-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setXAxisRange(0, 100);

مولفه های

نام تایپ کنید شرح
start Number مقدار برای پایین ترین خط شبکه محور افقی.
end Number مقدار بالاترین خط شبکه محور افقی.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

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 سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

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.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

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 سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setYAxisLogScale()

محور عمودی را به یک مقیاس لگاریتمی تبدیل می کند (نیاز به مثبت بودن همه مقادیر دارد).

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

setYAxisRange(start, end)

محدوده را برای محور عمودی نمودار تنظیم می کند. اگر هر یک از نقاط داده خارج از محدوده باشد، محدوده برای شامل آن نقاط داده گسترش می یابد.

// Creates a scatter chart builder and sets the Y-axis range to be 0 to 100.
var builder = Charts.newTableChart();
builder.setYAxisRange(0, 100);

مولفه های

نام تایپ کنید شرح
start Number مقدار برای پایین ترین خط شبکه محور عمودی.
end Number مقدار بالاترین خط شبکه محور عمودی.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

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 سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

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.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.

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 سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی Charts.newTextStyle() یک شی TextStyleBuilder ایجاد کنید.

برگشت

ScatterChartBuilder - این سازنده، برای زنجیره‌بندی مفید است.