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

Class 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 - این سازنده، برای زنجیره‌بندی مفید است.

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

PointStyle

`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 - این سازنده، برای زنجیره‌بندی مفید است.