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

Class TableChartBuilder

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

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

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

var chartBuilder = Charts.newTableChart()
    .setDimensions(600, 500)
    .enablePaging(20)
    .setDataSourceUrl(dataSourceUrl);

var chart = chartBuilder.build();

مواد و روش ها

روش	نوع برگشت	توضیح مختصر
`build()`	`Chart`	نمودار را می سازد.
`enablePaging(enablePaging)`	`TableChartBuilder`	تنظیم می‌کند صفحه‌بندی از طریق داده‌ها فعال شود یا خیر.
`enablePaging(pageSize)`	`TableChartBuilder`	صفحه بندی را فعال می کند و تعداد ردیف ها را در هر صفحه تنظیم می کند.
`enablePaging(pageSize, startPage)`	`TableChartBuilder`	صفحه‌بندی را فعال می‌کند، تعداد ردیف‌های هر صفحه و اولین صفحه جدول را برای نمایش تنظیم می‌کند (تعداد صفحات بر اساس صفر هستند).
`enableRtlTable(rtlEnabled)`	`TableChartBuilder`	با معکوس کردن ترتیب ستون های جدول، پشتیبانی اولیه را برای زبان های راست به چپ (مانند عربی یا عبری) اضافه می کند، به طوری که ستون صفر سمت راست ترین ستون و آخرین ستون سمت چپ ترین ستون باشد.
`enableSorting(enableSorting)`	`TableChartBuilder`	تنظیم می کند که آیا وقتی کاربر روی عنوان ستون کلیک می کند، ستون ها مرتب شوند یا خیر.
`setDataSourceUrl(url)`	`TableChartBuilder`	URL منبع داده را تنظیم می کند که برای وارد کردن داده ها از یک منبع خارجی مانند Google Sheets استفاده می شود.
`setDataTable(tableBuilder)`	`TableChartBuilder`	جدول داده را برای استفاده برای نمودار با استفاده از DataTableBuilder تنظیم می کند.
`setDataTable(table)`	`TableChartBuilder`	جدول داده ای را که شامل خطوط نمودار و همچنین برچسب های محور X است را تنظیم می کند.
`setDataViewDefinition(dataViewDefinition)`	`TableChartBuilder`	تعریف نمای داده را برای استفاده برای نمودار تنظیم می کند.
`setDimensions(width, height)`	`TableChartBuilder`	ابعاد نمودار را تعیین می کند.
`setFirstRowNumber(number)`	`TableChartBuilder`	شماره ردیف را برای ردیف اول در جدول داده ها تنظیم می کند.
`setInitialSortingAscending(column)`	`TableChartBuilder`	شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (صعودی) را تنظیم می کند.
`setInitialSortingDescending(column)`	`TableChartBuilder`	شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (نزولی) را تنظیم می کند.
`setOption(option, value)`	`TableChartBuilder`	گزینه های پیشرفته را برای این نمودار تنظیم می کند.
`showRowNumberColumn(showRowNumber)`	`TableChartBuilder`	تعیین می کند که آیا شماره ردیف به عنوان اولین ستون جدول نشان داده شود.
`useAlternatingRowStyle(alternate)`	`TableChartBuilder`	تعیین می کند که آیا سبک رنگ متناوب به ردیف های زوج و فرد از نمودار جدول اختصاص داده شود.

مستندات دقیق

`build()`

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

برگشت

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

`enablePaging(enablePaging)`

تنظیم می‌کند صفحه‌بندی از طریق داده‌ها فعال شود یا خیر.

رفتار پیش‌فرض صفحه‌بندی غیرفعال است. اگر صفحه‌بندی فعال باشد، اندازه صفحه پیش‌فرض 10 است.

مولفه های

نام	تایپ کنید	شرح
`enablePaging`	`Boolean`	`true` اگر صفحه بندی باید فعال باشد، در غیر این صورت `false` .

برگشت

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

`enablePaging(pageSize)`

صفحه بندی را فعال می کند و تعداد ردیف ها را در هر صفحه تنظیم می کند.

اندازه پیش فرض صفحه 10 است.

// Creates a table chart builder and enables paging with page size of 5.
var builder = Charts.newTableChart();
builder.enablePaging(5);

مولفه های

نام	تایپ کنید	شرح
`pageSize`	`Integer`	تعداد سطرها در هر صفحه از جدول.

برگشت

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

`enablePaging(pageSize, startPage)`

صفحه‌بندی را فعال می‌کند، تعداد ردیف‌های هر صفحه و اولین صفحه جدول را برای نمایش تنظیم می‌کند (تعداد صفحات بر اساس صفر هستند).

اندازه صفحه پیش فرض 10 و صفحه شروع پیش فرض 0 است.

// Creates a table chart builder and enables paging with page size of 5 and displays page 2
// first.
var builder = Charts.newTableChart();
builder.enablePaging(5, 2);

مولفه های

نام	تایپ کنید	شرح
`pageSize`	`Integer`	تعداد سطرها در هر صفحه از جدول.
`startPage`	`Integer`	اولین صفحه جدولی که نمایش داده می شود (اعداد صفحات بر اساس صفر هستند).

برگشت

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

`enableRtlTable(rtlEnabled)`

با معکوس کردن ترتیب ستون های جدول، پشتیبانی اولیه را برای زبان های راست به چپ (مانند عربی یا عبری) اضافه می کند، به طوری که ستون صفر سمت راست ترین ستون و آخرین ستون سمت چپ ترین ستون باشد.

این بر شاخص ستون در داده‌های زیربنایی تأثیر نمی‌گذارد، فقط ترتیب نمایش را تحت تأثیر قرار می‌دهد. نمایش زبان کامل دو جهته (BiDi) توسط تجسم جدول حتی با این گزینه پشتیبانی نمی شود. اگر صفحه‌بندی را فعال کنید (با استفاده از گزینه صفحه)، یا اگر جدول دارای نوارهای پیمایش باشد، این گزینه نادیده گرفته می‌شود زیرا گزینه‌های ارتفاع و عرض کوچک‌تر از اندازه جدول مورد نیاز را مشخص کرده‌اید. رفتار پیش‌فرض پشتیبانی RTL غیرفعال است.

مولفه های

نام	تایپ کنید	شرح
`rtlEnabled`	`Boolean`	`true` اگر پشتیبانی از راست به چپ باید فعال شود، در غیر این صورت `false` .

برگشت

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

`enableSorting(enableSorting)`

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

اگر مرتب سازی فعال باشد، وقتی کاربران روی سرصفحه ستون کلیک می کنند، ردیف ها به طور خودکار مرتب می شوند. رفتار پیش‌فرض مرتب‌سازی فعال است.

مولفه های

نام	تایپ کنید	شرح
`enableSorting`	`Boolean`	`true` تا مرتب‌سازی را با کلیک کردن روی سرصفحه‌های ستون فعال کنید، در غیر این صورت `false` .

برگشت

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

`setDataSourceUrl(url)`

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

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

مولفه های

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

برگشت

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

`setDataTable(tableBuilder)`

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

مولفه های

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

برگشت

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

`setDataTable(table)`

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

مولفه های

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

برگشت

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

`setDataViewDefinition(dataViewDefinition)`

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

مولفه های

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

برگشت

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

`setDimensions(width, height)`

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

مولفه های

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

برگشت

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

`setFirstRowNumber(number)`

شماره ردیف را برای ردیف اول در جدول داده ها تنظیم می کند.

شماره ردیف پیش فرض ردیف اول 1 است.

// Creates a table chart builder and sets the first row to be 2.
var builder = Charts.newTableChart();
builder.setFirstRowNumber(2);

مولفه های

نام	تایپ کنید	شرح
`number`	`Integer`	شماره ردیف برای ردیف اول در جدول داده ها.

برگشت

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

`setInitialSortingAscending(column)`

شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (صعودی) را تنظیم می کند.

ستون OS به ترتیب صعودی مرتب شده و با یک فلش کوچک نشان داده شده است.

// Creates a table chart builder and sorts it by the second column (ascending).
var builder = Charts.newTableChart();
builder.setInitialSortingAscending(2);

مولفه های

نام	تایپ کنید	شرح
`column`	`Integer`	شماره ستونی که جدول ابتدا باید بر اساس آن مرتب شود.

برگشت

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

`setInitialSortingDescending(column)`

شاخص ستونی را که جدول بر اساس آن ابتدا باید مرتب شود (نزولی) را تنظیم می کند.

ستون OS به ترتیب نزولی مرتب شده است و با یک فلش کوچک نشان داده شده است.

// Creates a table chart builder and sorts it by the second column (descending).
var builder = Charts.newTableChart();
builder.setInitialSortingDescending(2);

مولفه های

نام	تایپ کنید	شرح
`column`	`Integer`	شماره ستونی که جدول ابتدا باید بر اساس آن مرتب شود.

برگشت

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

`setOption(option, value)`

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

// Build a table chart which renders HTML.
var builder = Charts.newTableChart();
builder.setOption('allowHtml', {@code true});
var chart = builder.build();

مولفه های

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

برگشت

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

`showRowNumberColumn(showRowNumber)`

تعیین می کند که آیا شماره ردیف به عنوان اولین ستون جدول نشان داده شود.

رفتار پیش‌فرض اعداد ردیف را نشان نمی‌دهد.

مولفه های

نام	تایپ کنید	شرح
`showRowNumber`	`Boolean`	`true` اگر ستون اول جدول باید شماره ردیف را نشان دهد، در غیر این صورت `false` .

برگشت

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

`useAlternatingRowStyle(alternate)`

تعیین می کند که آیا سبک رنگ متناوب به ردیف های زوج و فرد از نمودار جدول اختصاص داده شود.

رفتار پیش‌فرض ردیف‌هایی است که سبک رنگ متناوب دارند.

مولفه های

نام	تایپ کنید	شرح
`alternate`	`Boolean`	`true` اگر سبک رنگ باید متناوب باشد، در غیر این صورت `false` .

برگشت

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