Text

TextContent

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

تمثيل JSON 
{
  "textElements": [
    {
      object (TextElement)
    }
  ],
  "lists": {
    string: {
      object (List)
    },
    ...
  }
}
الحقول
textElements[]

object (TextElement)

محتوى النص مقسّمًا إلى أجزائه المكونة، بما في ذلك معلومات الأنماط هذا الحقل للقراءة فقط.

lists

map (key: string, value: object ( List))

القوائم النقطية المضمّنة في هذا النص، مرتبطة برقم تعريف القائمة.

TextElement

يصف TextElement محتوى نطاق من الفهارس في المحتوى النصي لشكل أو TableCell.

تمثيل JSON 
{
  "startIndex": integer,
  "endIndex": integer,

  // Union field kind can be only one of the following:
  "paragraphMarker": {
    object (ParagraphMarker)
  },
  "textRun": {
    object (TextRun)
  },
  "autoText": {
    object (AutoText)
  }
  // End of list of possible types for union field kind.
}
الحقول
startIndex

integer

فهرس البدء بالاستناد إلى الصفر لعنصر النص هذا، بوحدات ترميز يونيكود

endIndex

integer

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

حقل الاتحاد kind نوع النص الذي يمثّله هذا العنصر kind يمكن أن تكون إحدى القيم التالية فقط:
paragraphMarker

object (ParagraphMarker)

علامة تمثل بداية فقرة جديدة.

يمثّل العنصران startIndex و endIndex من TextElement هذا نطاق الفقرة. يتم اعتبار العناصر النصية الأخرى التي لها نطاق فهرس داخل نطاق هذه الفقرة جزءًا من هذه الفقرة. لن يتداخل نطاق الفهارس المؤلفة من فقرتين منفصلتين أبدًا.

textRun

object (TextRun)

عنصر TextElement يمثل سلسلة من النصوص التي تكون فيها جميع الأحرف في مسار التشغيل متطابقة TextStyle

تشير رسالة الأشكال البيانية startIndex أو endIndex سيتم دائمًا تضمين من TextRuns بالكامل في نطاق فهرس paragraphMarker TextElement. بمعنى آخر، لن يمتد TextRun أبدًا على فقرات متعددة.

autoText

object (AutoText)

عنصر نص يمثّل موضعًا في النص يتم استبداله ديناميكيًا بمحتوى يمكن أن يتغيّر بمرور الوقت.

ParagraphMarker

نوع عنصر نص يمثّل بداية فقرة جديدة.

تمثيل JSON 
{
  "style": {
    object (ParagraphStyle)
  },
  "bullet": {
    object (Bullet)
  }
}
الحقول
style

object (ParagraphStyle)

نمط الفقرة

bullet

object (Bullet)

علامة نقطية لهذه الفقرة في حال عدم توفّر الفقرة، لا تنتمي الفقرة إلى قائمة.

ParagraphStyle

الأنماط التي تنطبق على فقرة كاملة

إذا كان هذا النص مُضمّنًا في شكل مع عنصر رئيسي placeholder، في هذه الحالة قد يتم اكتساب أنماط الفقرة هذه من العنصر الرئيسي. تعتمد أنماط الفقرات المكتسَبة على مستوى تداخل القوائم:

  • ستكتسب الفقرة التي ليست في قائمة نمط الفقرة من الفقرة في مستوى التعشيش 0 للقائمة داخل العنصر النائب الرئيسي.
  • ستكتسب الفقرة في القائمة نمط الفقرة من الفقرة في مستوى التداخل المقابل للقائمة داخل العنصر النائب الرئيسي.

يتم تمثيل أنماط الفقرات المكتسَبة كحقول غير محددة في هذه الرسالة.

تمثيل JSON 
{
  "lineSpacing": number,
  "alignment": enum (Alignment),
  "indentStart": {
    object (Dimension)
  },
  "indentEnd": {
    object (Dimension)
  },
  "spaceAbove": {
    object (Dimension)
  },
  "spaceBelow": {
    object (Dimension)
  },
  "indentFirstLine": {
    object (Dimension)
  },
  "direction": enum (TextDirection),
  "spacingMode": enum (SpacingMode)
}
الحقول
lineSpacing

number

مقدار المساحة بين السطور، كنسبة مئوية من القيمة العادية، حيث يتم تمثيل القيمة العادية على النحو 100.0. في حال عدم ضبط القيمة، يتم اكتسابها من العنصر الرئيسي.

alignment

enum (Alignment)

محاذاة النص لهذه الفقرة

indentStart

object (Dimension)

مقدار المسافة البادئة للفقرة على الجانب المقابل لبداية النص، بناءً على اتجاه النص الحالي. في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي.

indentEnd

object (Dimension)

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

spaceAbove

object (Dimension)

مقدار المساحة الإضافية فوق الفقرة في حال ترك السياسة بدون ضبط، يتم اكتساب القيمة من العنصر الرئيسي.

spaceBelow

object (Dimension)

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

indentFirstLine

object (Dimension)

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

direction

enum (TextDirection)

اتجاه نص هذه الفقرة. في حال ترك السياسة بدون ضبط، سيتم تلقائيًا ضبط القيمة على LEFT_TO_RIGHT لأنّ اتجاه النص غير مكتسب.

spacingMode

enum (SpacingMode)

وضع التباعد للفقرة.

محاذاة

أنواع محاذاة النص لفقرة

عمليات التعداد
ALIGNMENT_UNSPECIFIED محاذاة الفقرة مكتسبة من العنصر الرئيسي.
START تتم محاذاة الفقرة مع بداية السطر. تتم محاذاة النص من اليسار إلى اليمين للغة التي تُقرأ من اليسار إلى اليمين، وتتم محاذاة النص من اليمين إلى اليسار في الحالات الأخرى.
CENTER الفقرة في المنتصف
END يتم محاذاة الفقرة مع نهاية السطر. تمت المحاذاة لليمين مع نص LTR، والمحاذاة لليسار.
JUSTIFIED الفقرة مُعدَّة للعرض على يمين الصفحة.

TextDirection

يمكن أن يتدفق نص الاتجاهات.

عمليات التعداد
TEXT_DIRECTION_UNSPECIFIED يتم اكتساب اتجاه النص من العنصر الرئيسي.
LEFT_TO_RIGHT ينتقل النص من اليسار إلى اليمين.
RIGHT_TO_LEFT يظهر النص من اليمين إلى اليسار.

SpacingMode

الأوضاع المختلفة لتباعد الفقرات.

عمليات التعداد
SPACING_MODE_UNSPECIFIED وضع التباعد مكتسَب من المؤسسة الرئيسية.
NEVER_COLLAPSE يتم عرض تباعد الفقرات دائمًا.
COLLAPSE_LISTS يتم حذف مسافات الفقرات بين عناصر القائمة.

تعداد نقطي

يصف النقطة في فقرة.

تمثيل JSON 
{
  "listId": string,
  "nestingLevel": integer,
  "glyph": string,
  "bulletStyle": {
    object (TextStyle)
  }
}
الحقول
listId

string

رقم تعريف القائمة التي تنتمي إليها هذه الفقرة.

nestingLevel

integer

مستوى التداخل لهذه الفقرة في القائمة.

glyph

string

الحرف الرسومي للرمز النقطي المعروض لهذه الفقرة.

bulletStyle

object (TextStyle)

نمط النص الخاص بالفقرة الذي تم تطبيقه على هذا التعداد النقطي.

نمط النص

يمثّل التصميم الذي يمكن تطبيقه على TextRun.

إذا كان هذا النص مضمّنًا في شكل يتضمّن عنصرًا رئيسيًا placeholder، قد يتم اكتساب أنماط النص هذه من العنصر الرئيسي. تعتمد أنماط النصوص المُكتسَبة على مستوى تداخل القوائم:

  • سيرث نص في فقرة ليست في قائمة نمط النص من حرف سطر جديد في الفقرة عند مستوى التداخل 0 للقائمة داخل العنصر النائب الرئيسي.
  • سيكتسِب نص في فقرة ضمن قائمة نمط النص من حرف سطر جديد في الفقرة على مستوى التداخل المقابل للقائمة داخل العنصر النائب الرئيسي.

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

تمثيل JSON 
{
  "backgroundColor": {
    object (OptionalColor)
  },
  "foregroundColor": {
    object (OptionalColor)
  },
  "bold": boolean,
  "italic": boolean,
  "fontFamily": string,
  "fontSize": {
    object (Dimension)
  },
  "link": {
    object (Link)
  },
  "baselineOffset": enum (BaselineOffset),
  "smallCaps": boolean,
  "strikethrough": boolean,
  "underline": boolean,
  "weightedFontFamily": {
    object (WeightedFontFamily)
  }
}
الحقول
backgroundColor

object (OptionalColor)

لون خلفية النص إذا تم ضبطه، يكون اللون إما معتمًا أو شفافًا، وذلك بناءً على ما إذا تم ضبط الحقل opaqueColor فيه.

foregroundColor

object (OptionalColor)

لون النص نفسه إذا تم ضبط اللون، يكون إما معتمًا أو شفافًا، وذلك بناءً على ما إذا تم ضبط الحقل opaqueColor فيه.

bold

boolean

ما إذا كان سيتم عرض النص بخط غامق أم لا

italic

boolean

ما إذا كان النص مائلًا أم لا

fontFamily

string

مجموعة الخطوط للنص

يمكن أن تكون مجموعة الخطوط أي خط من قائمة "الخط" في "العروض التقديمية من Google" أو من Google Fonts. إذا لم يكن اسم الخط معروفًا، فسيتم عرض النص في Arial

يمكن أن تؤثر بعض الخطوط في وزن النص. في حال تحديد طلب تحديث قيمًا لكليهما fontFamily أو bold، الذي تم تعيينه بشكل صريح bold استخدام القيمة.

fontSize

object (Dimension)

حجم خط النص عند القراءة، سيتم تحديد fontSize بالنقاط.

baselineOffset

enum (BaselineOffset)

الإزاحة العمودية للنص عن موضعه العادي

يتم تلقائيًا عرض النص الذي يتضمّن علامات SUPERSCRIPT أو SUBSCRIPT للإزاحة من خط الأساس بحجم خط أصغر، ويتم احتسابه استنادًا إلى حقل fontSize . لا تتأثر fontSize نفسها بالتغييرات في هذا الحقل.

smallCaps

boolean

ما إذا كان النص مكتوبًا بأحرف كبيرة صغيرة أم لا.

strikethrough

boolean

ما إذا كان النص مشطوبًا أم لا

underline

boolean

ما إذا كان النص مسطرًا أم لا

weightedFontFamily

object (WeightedFontFamily)

مجموعة الخطوط وحجم النص المعروض

هذا الحقل هو امتداد fontFamily هو دعم سُمك الخطوط الصريحة بدون الإخلال بالتوافق مع الأنظمة القديمة. وبناءً على ذلك، عند قراءة نمط نطاق من النصوص، تكون قيمة weightedFontFamily#fontFamily مساوية دائمًا لقيمة fontFamily ومع ذلك، عند الكتابة، إذا تم تضمين كلا الحقلين في قناع الحقل (إما بشكل صريح أو من خلال العلامة النائبة "*")، تتم مطابقة قيمهما على النحو التالي:

  • إذا تم ضبط fontFamily ولم يتم ضبط weightedFontFamily ، يتم تطبيق قيمة fontFamily باستخدام الوزن 400 ("عادي").
  • وإذا تم تعيين كلا الحقلين، تكون قيمة fontFamily يجب أن يتطابق مع weightedFontFamily#fontFamily إذا كان الأمر كذلك، فإن عائلة الخط وسُمك weightedFontFamily تطبيق التصميم. وبخلاف ذلك، سيتم عرض رسالة الخطأ 400 الخاصة بالطلب غير الصحيح.
  • إذا تم ضبط weightedFontFamily ولم يتم ضبط fontFamily ، يتم تطبيق عائلة الخط ووزنه weightedFontFamily .
  • في حال عدم ضبط أيّ من الحقلين، يتم اكتساب عائلة الخط ووزن النص من العنصر الرئيسي. تجدر الإشارة إلى أنّ هذه السمات لا يمكن أن تكتسبها العناصر بشكل منفصل عن بعضها.

إذا حدّد طلب التعديل قيمًا لكل من weightedFontFamily و bold، يتم تطبيق weightedFontFamily أولاً، ثم bold.

في حال حذف weightedFontFamily#weight لم يتم تعيينه، يتم تعيينه افتراضيًا على 400

في حال حذف weightedFontFamily البيانات، ثم weightedFontFamily#fontFamily يجب أيضًا ضبطه على قيمة غير فارغة. وبخلاف ذلك، سيتم عرض رسالة الخطأ 400 الخاصة بالطلب غير الصحيح.

OptionalColor

لون يمكن أن يكون معتمًا بالكامل أو شفافًا بالكامل

تمثيل JSON 
{
  "opaqueColor": {
    object (OpaqueColor)
  }
}
الحقول
opaqueColor

object (OpaqueColor)

في حال ضبط هذا الخيار، سيتم استخدامه كلون غير شفاف. وفي حال عدم ضبطها، يشير ذلك إلى لون شفاف.

BaselineOffset

الطرق التي يمكن بها إزاحة النص عموديًا عن موضعه العادي.

عمليات التعداد
BASELINE_OFFSET_UNSPECIFIED يتم اكتساب قيمة الإزاحة من خط الأساس للنص من العنصر الرئيسي.
NONE لا تتم إزاحة النص عموديًا.
SUPERSCRIPT يتم وضع النص بشكل مائل للأعلى (نص مرتفع).
SUBSCRIPT النص مُعدَّل عموديًا للأسفل (نص منخفض).

WeightedFontFamily

يمثّل مجموعة خطوط وكثافة الخط المستخدَمة لتنسيق TextRun.

تمثيل JSON 
{
  "fontFamily": string,
  "weight": integer
}
الحقول
fontFamily

string

مجموعة خطوط النص

يمكن أن تكون مجموعة الخطوط أي خط من قائمة "الخط" في "العروض التقديمية من Google" أو من Google Fonts. إذا لم يتم التعرّف على اسم الخط، يتم عرض النص بخط Arial.

weight

integer

كثافة النص المعروضة يمكن أن يحتوي هذا الحقل على أي قيمة من مضاعفات 100 بين 100 أو 900 بشكل شامل. ويتوافق هذا النطاق مع القيم الرقمية الموضحة في مواصفات CSS 2.1، القسم 15.6، مع عدم السماح بالقيم غير الرقمية. تُعتبر الأوزان التي تزيد عن أو تساوي 700 غامقة، والأوزان التي تقل عن 700 ليست غامقة. القيمة الافتراضية هي 400 ("عادي").

TextRun

نوع TextElement يمثّل سلسلة نصية لها النمط نفسه.

تمثيل JSON 
{
  "content": string,
  "style": {
    object (TextStyle)
  }
}
الحقول
content

string

نص عملية التشغيل هذه.

style

object (TextStyle)

النمط المطبَّق على تمرين الجري هذا.

النص التلقائي

نوع TextElement يمثّل نصًا تلقائيًا

تمثيل JSON 
{
  "type": enum (Type),
  "content": string,
  "style": {
    object (TextStyle)
  }
}
الحقول
type

enum (Type)

نوع هذا النص التلقائي.

content

string

تمثّل هذه السمة المحتوى المعروض لهذا النص التلقائي، إذا كان متاحًا.

style

object (TextStyle)

التصميم الذي تم تطبيقه على هذا النص التلقائي

النوع

أنواع النص التلقائي

عمليات التعداد
TYPE_UNSPECIFIED نوع نص تلقائي غير محدَّد
SLIDE_NUMBER اكتب النص التلقائي الذي يمثل رقم الشريحة الحالية.

قائمة

تصف القائمة مظهر علامات النقاط المرجعية وأسلوبها في الفقرات المرتبطة بقائمة. تشتمل الفقرة التي هي جزء من قائمة على مرجع ضمني إلى رقم تعريف هذه القائمة.

تمثيل JSON 
{
  "listId": string,
  "nestingLevel": {
    integer: {
      object (NestingLevel)
    },
    ...
  }
}
الحقول
listId

string

رقم تعريف القائمة.

nestingLevel

map (key: integer, value: object ( NestingLevel))

خريطة لمستويات التداخل مع خصائص الرموز النقطية على المستوى المرتبط. تحتوي القائمة على تسعة مستويات كحد أقصى من التداخل، لذا فإنّ القيم المحتملة لمفاتيح هذه الخريطة هي من 0 إلى 8، بما في ذلك.

NestingLevel

يحتوي على خصائص تصف شكل ومظهر القائمة النقطية للقائمة على مستوى معين من التداخل.

تمثيل JSON 
{
  "bulletStyle": {
    object (TextStyle)
  }
}
الحقول
bulletStyle

object (TextStyle)

نمط النقطة في هذا المستوى من التداخل.