تمت ترجمة هذه الصفحة بواسطة 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 Google".
`setDataTable(tableBuilder)`	`TableChartBuilder`	تحدد هذه السمة جدول البيانات لاستخدامه في الرسم البياني باستخدام DataTableBuilder.
`setDataTable(table)`	`TableChartBuilder`	لتعيين جدول البيانات الذي يحتوي على خطوط المخطط، وكذلك تسميات المحور س.
`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) مع العرض المرئي في الجدول. مع هذا الخيار. يتم تجاهل هذا الخيار في حالة تفعيل التنقل بين الصفحات (باستخدام خيار الصفحة)، أو إذا يحتوي الجدول على أشرطة تمرير لأنك حددت خيارات ارتفاع وعرض أصغر من حجم الجدول المطلوب. ويكون السلوك التلقائي هو إيقاف دعم الوضع "مراسلة نصية في الوقت الفعلي".

المعلمات

الاسم	النوع	الوصف
`rtlEnabled`	`Boolean`	`true` في حال تفعيل الدعم من اليمين إلى اليسار، `false` وإلا.

الإرجاع

TableChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`enableSorting(enableSorting)`

لضبط ما إذا كان سيتم ترتيب الأعمدة عندما ينقر المستخدم على عنوان عمود.

في حال تفعيل الترتيب، يتم تلقائيًا عندما ينقر المستخدمون على عنوان العمود. مرتبة. الإعداد التلقائي هو تفعيل الترتيب.

المعلمات

الاسم	النوع	الوصف
`enableSorting`	`Boolean`	`true` لتفعيل الترتيب من خلال النقر على عناوين الأعمدة، أو `false` بخلاف ذلك.

الإرجاع

TableChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`setDataSourceUrl(url)`

لضبط عنوان URL لمصدر البيانات المُستخدَم لسحب البيانات من مصدر خارجي، مثل Google Google". في حال توفير عنوان URL لمصدر بيانات وDataTable، يتم تجاهل عنوان URL لمصدر البيانات.

لمزيد من المعلومات حول طلبات البحث عن مصادر البيانات، يمكنك الاطّلاع على مستندات "مخطّطات Google".

المعلمات

الاسم	النوع	الوصف
`url`	`String`	عنوان URL لمصدر البيانات، بما في ذلك أيّ مَعلمات طلب بحث.

الإرجاع

TableChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`setDataTable(tableBuilder)`

تحدد هذه السمة جدول البيانات لاستخدامه في الرسم البياني باستخدام DataTableBuilder. هذه طريقة ملائمة لإعداد جدول البيانات بدون الحاجة إلى استدعاء build().

المعلمات

الاسم	النوع	الوصف
`tableBuilder`	`DataTableBuilder`	أداة إنشاء جداول البيانات. يتم إنشاء جدول بيانات جديد فورًا كجزء من هذا النموذج لذلك لن تظهر أي تحديثات أخرى يتم إجراؤها على أداة الإنشاء في الرسم البياني.

الإرجاع

TableChartBuilder — أداة الإنشاء هذه مفيدة للسلاسل.

`setDataTable(table)`

لتعيين جدول البيانات الذي يحتوي على خطوط المخطط، وكذلك تسميات المحور س. تشير رسالة الأشكال البيانية يجب أن يكون العمود الأول سلسلة، وأن يحتوي على تسميات المحور الأفقي. أي عدد من الأعمدة يمكن متابعتها، يجب أن تكون جميعها رقمية. يتم عرض كل عمود كخط منفصل.

المعلمات

الاسم	النوع	الوصف
`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)`

ضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (ترتيب تصاعدي)

تم ترتيب العمود تصاعديًا وتم تمييزه بسهم صغير يشير إلى ذلك.

// 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)`

ضبط فهرس العمود الذي يجب ترتيب الجدول وفقًا له في البداية (ترتيب تنازلي)

تم ترتيب العمود تنازليًا وتم تمييزه بسهم صغير يشير إلى ذلك.

// 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 — أداة الإنشاء هذه مفيدة للسلاسل.