این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Class ScatterChartBuilder

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

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

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

const 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);

const chart = chartBuilder.build();

روش ها

روش	نوع برگشت	شرح مختصر
`build()`	`Chart`	نمودار را می سازد.
`set Background Color(cssValue)`	`Scatter Chart Builder`	رنگ پس زمینه نمودار را تنظیم می کند.
`set Colors(cssValues)`	`Scatter Chart Builder`	رنگ ها را برای خطوط در نمودار تنظیم می کند.
`set Data Source Url(url)`	`Scatter Chart Builder`	URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند Google Sheets استفاده می شود.
`set Data Table(tableBuilder)`	`Scatter Chart Builder`	جدول داده را برای استفاده برای نمودار با استفاده از DataTableBuilder تنظیم می کند.
`set Data Table(table)`	`Scatter Chart Builder`	جدول داده ای را که شامل خطوط نمودار و همچنین برچسب های محور X است را تنظیم می کند.
`set Data View Definition(dataViewDefinition)`	`Scatter Chart Builder`	تعریف نمای داده را برای استفاده برای نمودار تنظیم می کند.
`set Dimensions(width, height)`	`Scatter Chart Builder`	ابعاد نمودار را تعیین می کند.
`set Legend Position(position)`	`Scatter Chart Builder`	موقعیت افسانه را با توجه به نمودار تنظیم می کند.
`set Legend Text Style(textStyle)`	`Scatter Chart Builder`	سبک متن افسانه نمودار را تنظیم می کند.
`set Option(option, value)`	`Scatter Chart Builder`	گزینه های پیشرفته را برای این نمودار تنظیم می کند.
`set Point Style(style)`	`Scatter Chart Builder`	استایل را برای نقاط در خط تنظیم می کند.
`set Title(chartTitle)`	`Scatter Chart Builder`	عنوان نمودار را تعیین می کند.
`set Title Text Style(textStyle)`	`Scatter Chart Builder`	سبک متن عنوان نمودار را تنظیم می کند.
`set XAxis Log Scale()`	`Scatter Chart Builder`	محور افقی را به یک مقیاس لگاریتمی تبدیل می کند (نیاز به مثبت بودن همه مقادیر دارد).
`set XAxis Range(start, end)`	`Scatter Chart Builder`	محدوده را برای محور افقی نمودار تنظیم می کند.
`set XAxis Text Style(textStyle)`	`Scatter Chart Builder`	سبک متن محور افقی را تنظیم می کند.
`set XAxis Title(title)`	`Scatter Chart Builder`	عنوانی را به محور افقی اضافه می کند.
`set XAxis Title Text Style(textStyle)`	`Scatter Chart Builder`	سبک متن عنوان محور افقی را تنظیم می کند.
`set YAxis Log Scale()`	`Scatter Chart Builder`	محور عمودی را به یک مقیاس لگاریتمی تبدیل می کند (نیاز به مثبت بودن همه مقادیر دارد).
`set YAxis Range(start, end)`	`Scatter Chart Builder`	محدوده را برای محور عمودی نمودار تنظیم می کند.
`set YAxis Text Style(textStyle)`	`Scatter Chart Builder`	سبک متن محور عمودی را تنظیم می کند.
`set YAxis Title(title)`	`Scatter Chart Builder`	عنوانی را به محور عمودی اضافه می کند.
`set YAxis Title Text Style(textStyle)`	`Scatter Chart Builder`	سبک متن عنوان محور عمودی را تنظیم می کند.

مستندات دقیق

`build()`

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

بازگشت

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

`set Background Color(cssValue)`

رنگ پس زمینه نمودار را تنظیم می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
`css Value`	`String`	مقدار CSS برای رنگ (مانند `"blue"` یا `"#00f"` ).

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Colors(cssValues)`

رنگ ها را برای خطوط در نمودار تنظیم می کند.

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

پارامترها

نام	تایپ کنید	توضیحات
`css Values`	`String[]`	آرایه ای از مقادیر رنگی CSS، مانند `["red", "#acf"]` . عنصر n در آرایه نشان دهنده رنگ خط n ام در نمودار است.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Data Source Url(url)`

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

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

پارامترها

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

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Data Table(tableBuilder)`

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

پارامترها

نام	تایپ کنید	توضیحات
`table Builder`	`Data Table Builder`	سازنده جدول داده ها یک جدول داده جدید فوراً به عنوان بخشی از این تماس ایجاد می‌شود، بنابراین هرگونه به‌روزرسانی بیشتر برای سازنده در نمودار منعکس نمی‌شود.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Data Table(table)`

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

پارامترها

نام	تایپ کنید	توضیحات
`table`	`Data Table Source`	جدول داده برای استفاده برای نمودار.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Data View Definition(dataViewDefinition)`

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

پارامترها

نام	تایپ کنید	توضیحات
`data View Definition`	`Data View Definition`	یک شی تعریف نمای داده که نمایه ای را که باید از منبع داده داده شده برای ترسیم نمودار مشتق شود، تعریف می کند.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Dimensions(width, height)`

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

پارامترها

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

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Legend Position(position)`

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

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

پارامترها

نام	تایپ کنید	توضیحات
`position`	`Position`	موقعیت افسانه.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Legend Text Style(textStyle)`

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

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

پارامترها

نام	تایپ کنید	توضیحات
`text Style`	`Text Style`	سبک متن برای استفاده برای افسانه نمودار.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Option(option, value)`

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

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

پارامترها

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

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Point Style(style)`

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

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

پارامترها

نام	تایپ کنید	توضیحات
`style`	`Point Style`	سبک مورد استفاده برای نقاط در خط.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

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

Point Style

`set Title(chartTitle)`

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

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

پارامترها

نام	تایپ کنید	توضیحات
`chart Title`	`String`	عنوان نمودار

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set Title Text Style(textStyle)`

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

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

پارامترها

نام	تایپ کنید	توضیحات
`text Style`	`Text Style`	سبک متنی که برای عنوان نمودار استفاده می شود. می توانید با فراخوانی `Charts.newTextStyle()` یک شی `Text Style Builder` ایجاد کنید.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set XAxis Log Scale()`

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

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set XAxis Range(start, end)`

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

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

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

پارامترها

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

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set XAxis Text Style(textStyle)`

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

// Creates a line chart builder and sets the X-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTextStyle(textStyle);

پارامترها

نام	تایپ کنید	توضیحات
`text Style`	`Text Style`	سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی `Charts.newTextStyle()` یک شی `Text Style Builder` ایجاد کنید.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set XAxis Title(title)`

عنوانی را به محور افقی اضافه می کند. عنوان در مرکز قرار دارد و در زیر برچسب های مقدار محور ظاهر می شود.

// Creates a line chart builder and sets the X-axis title.
const builder = Charts.newLineChart();
builder.setTitle('X-axis Title');

پارامترها

نام	تایپ کنید	توضیحات
`title`	`String`	عنوان برای محور X.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set XAxis Title Text Style(textStyle)`

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

// Creates a line chart builder and sets the X-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setXAxisTitleTextStyle(textStyle);

پارامترها

نام	تایپ کنید	توضیحات
`text Style`	`Text Style`	سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی `Charts.newTextStyle()` یک شی `Text Style Builder` ایجاد کنید.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set YAxis Log Scale()`

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

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set YAxis Range(start, end)`

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

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

پارامترها

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

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set YAxis Text Style(textStyle)`

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

// Creates a line chart builder and sets the Y-axis text style to blue, 18-point
// font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTextStyle(textStyle);

پارامترها

نام	تایپ کنید	توضیحات
`text Style`	`Text Style`	سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی `Charts.newTextStyle()` یک شی `Text Style Builder` ایجاد کنید.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set YAxis Title(title)`

عنوانی را به محور عمودی اضافه می کند. عنوان در مرکز قرار دارد و در سمت چپ برچسب های مقدار ظاهر می شود.

// Creates a line chart builder and sets the Y-axis title.
const builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title');

پارامترها

نام	تایپ کنید	توضیحات
`title`	`String`	عنوان برای محور Y.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.

`set YAxis Title Text Style(textStyle)`

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

// Creates a line chart builder and sets the Y-axis title text style to blue,
// 18-point font.
const textStyle =
    Charts.newTextStyle().setColor('blue').setFontSize(18).build();
const builder = Charts.newLineChart();
builder.setYAxisTitleTextStyle(textStyle);

پارامترها

نام	تایپ کنید	توضیحات
`text Style`	`Text Style`	سبک متنی که برای عنوان محور افقی استفاده می شود. می توانید با فراخوانی `Charts.newTextStyle()` یک شی `Text Style Builder` ایجاد کنید.

بازگشت

Scatter Chart Builder - این سازنده، برای زنجیر کردن مفید است.