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

الإرجاع

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

`setDataSourceUrl(url)`

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

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

المعلمات

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

الإرجاع

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

`setDataTable(tableBuilder)`

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

المعلمات

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

الإرجاع

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

`setDataTable(table)`

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

المعلمات

الاسم	النوع	الوصف
`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`	نمط النص المطلوب استخدامه لعنوان الرسم البياني. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

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`	نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

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`	عنوان المحور س.

الإرجاع

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`	نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

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`	نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

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`	نمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن `TextStyleBuilder` من خلال استدعاء `Charts.newTextStyle()`.

الإرجاع

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