Class LineChartBuilder

LineChartBuilder

أداة إنشاء الرسوم البيانية الخطية لمزيد من التفاصيل، اطّلع على مستندات "مخططات Google".

فيما يلي مثال يوضح كيفية إنشاء مخطط خطي. يتم استيراد البيانات من جدول بيانات Google.

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

  var chartBuilder = Charts.newLineChart()
      .setTitle('Yearly Rainfall')
      .setXAxisTitle('Month')
      .setYAxisTitle('Rainfall (in)')
      .setDimensions(600, 500)
      .setCurveStyle(Charts.CurveStyle.SMOOTH)
      .setPointStyle(Charts.PointStyle.MEDIUM)
      .setDataSourceUrl(dataSourceUrl);

  var chart = chartBuilder.build();

الطُرق

الطريقةنوع الإرجاعوصف قصير
build()Chartيبني المخطط.
reverseCategories()LineChartBuilderلعكس رسم السلسلة في محور النطاق.
setBackgroundColor(cssValue)LineChartBuilderلضبط لون خلفية الرسم البياني.
setColors(cssValues)LineChartBuilderلتعيين ألوان الخطوط في الرسم البياني.
setCurveStyle(style)LineChartBuilderلضبط النمط المراد استخدامه للمنحنيات في الرسم البياني.
setDataSourceUrl(url)LineChartBuilderلضبط عنوان URL لمصدر البيانات المُستخدَم لسحب البيانات من مصدر خارجي، مثل Google Google".
setDataTable(tableBuilder)LineChartBuilderتحدد هذه السمة جدول البيانات لاستخدامه في الرسم البياني باستخدام DataTableBuilder.
setDataTable(table)LineChartBuilderلتعيين جدول البيانات الذي يحتوي على خطوط المخطط، وكذلك تسميات المحور س.
setDataViewDefinition(dataViewDefinition)LineChartBuilderإعداد تعريف عرض البيانات لاستخدامه في الرسم البياني.
setDimensions(width, height)LineChartBuilderتعين سمات الرسم البياني.
setLegendPosition(position)LineChartBuilderلتعيين موضع وسيلة الإيضاح بالنسبة إلى الرسم البياني.
setLegendTextStyle(textStyle)LineChartBuilderلتعيين نمط نص وسيلة إيضاح الرسم البياني.
setOption(option, value)LineChartBuilderلضبط الخيارات المتقدمة لهذا الرسم البياني.
setPointStyle(style)LineChartBuilderلتعيين نمط النقاط في الخط.
setRange(start, end)LineChartBuilderتعين نطاق الرسم البياني.
setTitle(chartTitle)LineChartBuilderلتعيين عنوان الرسم البياني.
setTitleTextStyle(textStyle)LineChartBuilderلضبط نمط نص عنوان الرسم البياني.
setXAxisTextStyle(textStyle)LineChartBuilderلضبط نمط نص المحور الأفقي.
setXAxisTitle(title)LineChartBuilderلإضافة عنوان إلى المحور الأفقي.
setXAxisTitleTextStyle(textStyle)LineChartBuilderلضبط نمط نص عنوان المحور الأفقي.
setYAxisTextStyle(textStyle)LineChartBuilderلضبط نمط نص المحور الرأسي.
setYAxisTitle(title)LineChartBuilderلإضافة عنوان إلى المحور الرأسي.
setYAxisTitleTextStyle(textStyle)LineChartBuilderلضبط نمط نص عنوان المحور الرأسي.
useLogScale()LineChartBuilderتحويل محور النطاق إلى مقياس لوغاريتمي (يتطلب أن تكون جميع القيم موجبة).

الوثائق التفصيلية

build()

يبني المخطط.

الإرجاع

Chart — كائن رسم بياني يمكن تضمينه في مستندات أو عناصر في واجهة المستخدم أو استخدامه كعنصر ثابت .


reverseCategories()

لعكس رسم السلسلة في محور النطاق. بالنسبة للمخططات الرأسية (مثل المخططات الخطية المخططات المساحية أو العمودية)، فهذا يعني أن المحور الأفقي رسمه من اليمين إلى اليسار. بالنسبة المخططات الأفقية (مثل المخططات الشريطية)، هذا يعني أن المحور الرأسي مرسوم من أعلى إلى إلى الأسفل. بالنسبة إلى المخططات الدائرية، هذا يعني أن الشرائح مرسومة عكس عقارب الساعة.

// Creates a pie chart builder and sets drawing of the slices in a counter-clockwise manner.
var builder = Charts.newPieChart();
builder.reverseCategories();

الإرجاع

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


setBackgroundColor(cssValue)

لضبط لون خلفية الرسم البياني.

// Creates a line chart builder and sets the background color to gray
var builder = Charts.newLineChart();
builder.setBackgroundColor("gray");

المعلمات

الاسمالنوعالوصف
cssValueStringقيمة CSS للون (مثل "blue" أو "#00f").

الإرجاع

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


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"]);

المعلمات

الاسمالنوعالوصف
cssValuesString[]مصفوفة من قيم CSS للألوان، مثل ["red", "#acf"]. العنصر n في الصفيفة لون الخط nth في المخطط.

الإرجاع

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


setCurveStyle(style)

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

// Creates a line chart builder and curves the lines in the chart.
var builder = Charts.newLineChart();
builder.setCurveStyle(Charts.CurveStyle.SMOOTH)

المعلمات

الاسمالنوعالوصف
styleCurveStyleنمط المنحنيات في الرسم البياني

الإرجاع

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

انظر أيضًا


setDataSourceUrl(url)

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

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

المعلمات

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

الإرجاع

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


setDataTable(tableBuilder)

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

المعلمات

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

الإرجاع

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


setDataTable(table)

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

المعلمات

الاسمالنوعالوصف
tableDataTableSourceجدول البيانات المطلوب استخدامه للرسم البياني.

الإرجاع

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


setDataViewDefinition(dataViewDefinition)

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

المعلمات

الاسمالنوعالوصف
dataViewDefinitionDataViewDefinitionكائن تعريف عرض بيانات يحدد الملف الشخصي الذي ينبغي من مصدر البيانات المحدد لرسم المخطط.

الإرجاع

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


setDimensions(width, height)

تعين سمات الرسم البياني.

المعلمات

الاسمالنوعالوصف
widthIntegerعرض الرسم البياني بالبكسل.
heightIntegerتمثّل هذه السمة ارتفاع الرسم البياني بالبكسل.

الإرجاع

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


setLegendPosition(position)

لتعيين موضع وسيلة الإيضاح بالنسبة إلى الرسم البياني. وبشكل افتراضي، لا توجد وسيلة إيضاح.

// Creates a line chart builder and sets the legend position to right.
var builder = Charts.newLineChart();
builder.setLegendPosition(Charts.Position.RIGHT);

المعلمات

الاسمالنوعالوصف
positionPositionموضع وسيلة الإيضاح.

الإرجاع

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


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);

المعلمات

الاسمالنوعالوصف
textStyleTextStyleنمط النص المستخدم في وسيلة إيضاح الرسم البياني.

الإرجاع

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


setOption(option, value)

لضبط الخيارات المتقدمة لهذا الرسم البياني. الخيارات المتاحة هذا المخطط. ليس لهذه الطريقة أي تأثير إذا كان الخيار المحدد غير صالح.

// Build a line chart with a 1-second animation duration.
var builder = Charts.newLineChart();
builder.setOption('animation.duration', 1000);
var chart = builder.build();

المعلمات

الاسمالنوعالوصف
optionStringخيار الضبط.
valueObjectالقيمة المطلوب ضبطها.

الإرجاع

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


setPointStyle(style)

لتعيين نمط النقاط في الخط. ولا تكون للنقاط بشكل افتراضي أنماط معينة، الخط مرئي.

// Creates a line chart builder and sets large point style.
var builder = Charts.newLineChart();
builder.setPointStyle(Charts.PointStyle.LARGE);

المعلمات

الاسمالنوعالوصف
stylePointStyleالنمط المستخدم للنقاط في الخط.

الإرجاع

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

انظر أيضًا


setRange(start, end)

تعين نطاق الرسم البياني.

إذا كانت أي نقاط بيانات تقع خارج النطاق، يتم توسيع النطاق ليشمل تلك البيانات. نقاط.

المعلمات

الاسمالنوعالوصف
startNumberقيمة أدنى خط شبكة في محور النطاق.
endNumberقيمة أعلى خط شبكة في محور النطاق.

الإرجاع

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


setTitle(chartTitle)

لتعيين عنوان الرسم البياني. يتم عرض العنوان في وسط أعلى الرسم البياني.

// Creates a line chart builder and title to 'My Line Chart'.
var builder = Charts.newLineChart();
builder.setTitle('My Line Chart')

المعلمات

الاسمالنوعالوصف
chartTitleStringعنوان المخطط.

الإرجاع

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


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);

المعلمات

الاسمالنوعالوصف
textStyleTextStyleنمط النص المطلوب استخدامه لعنوان الرسم البياني. يمكنك إنشاء كائن TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

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


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);

المعلمات

الاسمالنوعالوصف
textStyleTextStyleنمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

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


setXAxisTitle(title)

لإضافة عنوان إلى المحور الأفقي. يتم توسيط العنوان ويظهر أسفل قيمة المحور الفعلية.

// Creates a line chart builder and sets the X-axis title.
var builder = Charts.newLineChart();
builder.setTitle('X-axis Title')

المعلمات

الاسمالنوعالوصف
titleStringعنوان المحور س.

الإرجاع

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


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);

المعلمات

الاسمالنوعالوصف
textStyleTextStyleنمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

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


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);

المعلمات

الاسمالنوعالوصف
textStyleTextStyleنمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

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


setYAxisTitle(title)

لإضافة عنوان إلى المحور الرأسي. يظهر العنوان في الوسط ويظهر على يسار القيمة. الفعلية.

// Creates a line chart builder and sets the Y-axis title.
var builder = Charts.newLineChart();
builder.setYAxisTitle('Y-axis Title')

المعلمات

الاسمالنوعالوصف
titleStringعنوان المحور Y.

الإرجاع

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


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);

المعلمات

الاسمالنوعالوصف
textStyleTextStyleنمط النص المطلوب استخدامه لعنوان المحور الأفقي. يمكنك إنشاء كائن TextStyleBuilder من خلال استدعاء Charts.newTextStyle().

الإرجاع

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


useLogScale()

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

الإرجاع

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