Class TableChartBuilder

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