تمت ترجمة هذه الصفحة بواسطة 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".
`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 صفحات.

المَعلمات

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

المَعلمات

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

المَعلمات

الاسم	Type	الوصف
`pageSize`	`Integer`	عدد الصفوف في كل صفحة من الجدول.
`startPage`	`Integer`	صفحة الجدول الأولى المطلوب عرضها (أرقام الصفحات تستند إلى صفر).

استرجاع الكرة

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

`enableRtlTable(rtlEnabled)`

لإضافة دعم أساسي للغات التي تُكتب من اليمين إلى اليسار (مثل العربية أو العبرية) عن طريق عكس ترتيب الأعمدة في الجدول، بحيث يكون العمود صفر هو العمود في أقصى اليمين، والعمود الأخير هو العمود الموجود في أقصى اليسار.

لا يؤثر هذا في فهرس العمود في البيانات الأساسية، بل يؤثر فقط في ترتيب العرض. لا يتوفّر عرض اللغة الكامل ثنائي الاتجاه (BiDi) من خلال مؤثرات عرض الجدول حتى مع هذا الخيار. يتم تجاهل هذا الخيار في حال تفعيل التقسيم على صفحات (باستخدام خيار الصفحة)، أو إذا كان الجدول يحتوي على أشرطة تمرير بسبب تحديد خيارات للارتفاع والعرض، والتي تكون أصغر من حجم الجدول المطلوب. ويكون السلوك التلقائي هو إيقاف RTL.

المَعلمات

الاسم	Type	الوصف
`rtlEnabled`	`Boolean`	`true` إذا كان يجب تفعيل الدعم من اليمين إلى اليسار، `false` وإلا.

استرجاع الكرة

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

`enableSorting(enableSorting)`

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

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

المَعلمات

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

استرجاع الكرة

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

`setDataSourceUrl(url)`

تحدِّد عنوان URL لمصدر البيانات المستخدَم لسحب البيانات من مصدر خارجي مثل "جداول بيانات Google". في حال تقديم عنوان URL لمصدر البيانات وجدول بيانات، سيتم تجاهل عنوان URL لمصدر البيانات.

للتعرُّف على المزيد من المعلومات عن تنفيذ طلبات بحث في مصادر البيانات، راجِع مستندات مخططات Google.

المَعلمات

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

استرجاع الكرة

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

`setDataTable(tableBuilder)`

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

المَعلمات

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

استرجاع الكرة

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

`setDataTable(table)`

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

المَعلمات

الاسم	Type	الوصف
`table`	`DataTableSource`	جدول البيانات المطلوب استخدامه في الرسم البياني

استرجاع الكرة

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

`setDataViewDefinition(dataViewDefinition)`

لتعيين تعريف عرض البيانات لاستخدامه مع الرسم البياني.

المَعلمات

الاسم	Type	الوصف
`dataViewDefinition`	`DataViewDefinition`	تمثّل هذه السمة عنصر تعريف عرض البيانات الذي يحدّد العرض الذي يجب اشتقاقه من مصدر البيانات المحدّد لرسم الرسم البياني.

استرجاع الكرة

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

`setDimensions(width, height)`

لضبط الأبعاد للرسم البياني.

المَعلمات

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

المَعلمات

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

المَعلمات

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

المَعلمات

الاسم	Type	الوصف
`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();

المَعلمات

الاسم	Type	الوصف
`option`	`String`	خيار التعيين.
`value`	`Object`	القيمة المطلوب ضبطها.

استرجاع الكرة

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

`showRowNumberColumn(showRowNumber)`

لتحديد ما إذا كان سيتم عرض رقم الصف كأول عمود في الجدول.

السلوك التلقائي هو عدم عرض أرقام الصفوف.

المَعلمات

الاسم	Type	الوصف
`showRowNumber`	`Boolean`	`true` إذا كان العمود الأول من الجدول يجب أن يعرض رقم الصف، وبخلاف ذلك، يتم عرض `false`.

استرجاع الكرة

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

`useAlternatingRowStyle(alternate)`

تحدِّد هذه السياسة ما إذا كان سيتم تخصيص نمط الألوان البديل إلى صفوف فردية وزوجية من الرسم البياني الجدولي.

السلوك الافتراضي هو الصفوف التي تحتوي على نمط ألوان بديل.

المَعلمات

الاسم	Type	الوصف
`alternate`	`Boolean`	`true` إذا كان يجب أن تكون أنماط الألوان متبادلة، أو `false` في الحالات الأخرى.

استرجاع الكرة

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