تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class TextOutput

يشير ذلك المصطلح إلى كائن "إخراج النص" الذي يمكن عرضه من نص برمجي.

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

يمكنك عرض محتوى نصي مثل هذا:

function doGet() {
  return ContentService.createTextOutput("hello world!");
}

هناك أيضًا طرق لعرض JSON وRSS وXML كمخرجات نصية، ويمكنك الاطّلاع على الطُرق المناسبة في ContentService.

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
`append(addedContent)`	`TextOutput`	لإلحاق المحتوى الجديد بالمحتوى الذي سيتم عرضه.
`clear()`	`TextOutput`	يؤدي ذلك إلى محو المحتوى الحالي.
`downloadAsFile(filename)`	`TextOutput`	تطلب هذه الميزة من المتصفحات تنزيل هذا المحتوى بدلاً من عرضه.
`getContent()`	`String`	الحصول على المحتوى الذي سيتم عرضه.
`getFileName()`	`String`	تعرض اسم الملف لتنزيل هذا الملف بتنسيق، أو قيمة فارغة إذا كان يجب عرضه بدلاً من تنزيله.
`getMimeType()`	`MimeType`	احصل على نوع MIME الذي سيتم عرض هذا المحتوى معه.
`setContent(content)`	`TextOutput`	ضبط المحتوى الذي سيتم عرضه.
`setMimeType(mimeType)`	`TextOutput`	تحدِّد هذه السياسة نوع MIME للمحتوى الذي سيتم عرضه.

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

`append(addedContent)`

لإلحاق المحتوى الجديد بالمحتوى الذي سيتم عرضه.

المَعلمات

الاسم	Type	الوصف
`addedContent`	`String`	المحتوى لإلحاقه

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

TextOutput - نتيجة النص هذه نفسها، وهي مفيدة للتسلسل

`clear()`

يؤدي ذلك إلى محو المحتوى الحالي.

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

TextOutput - نتيجة النص هذه نفسها، وهي مفيدة للتسلسل

`downloadAsFile(filename)`

تطلب هذه الميزة من المتصفحات تنزيل هذا المحتوى بدلاً من عرضه.

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

المَعلمات

الاسم	Type	الوصف
`filename`	`String`	اسم الملف لإخبار المتصفح باستخدام

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

TextOutput: كائن الإخراج النصي، وهو مفيد للتسلسل

الرميات

Error: إذا كان اسم الملف يحتوي على أحرف غير مقبولة

`getContent()`

الحصول على المحتوى الذي سيتم عرضه.

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

String — المحتوى الذي سيتم عرضه

`getFileName()`

تعرض اسم الملف لتنزيل هذا الملف بتنسيق، أو قيمة فارغة إذا كان يجب عرضه بدلاً من تنزيله.

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

String - اسم الملف

`getMimeType()`

احصل على نوع MIME الذي سيتم عرض هذا المحتوى معه.

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

MimeType - نوع MIME الذي سيتم العرض معه

`setContent(content)`

ضبط المحتوى الذي سيتم عرضه.

المَعلمات

الاسم	Type	الوصف
`content`	`String`	المحتوى للعرض

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

TextOutput - نتيجة النص هذه نفسها، وهي مفيدة للتسلسل

`setMimeType(mimeType)`

تحدِّد هذه السياسة نوع MIME للمحتوى الذي سيتم عرضه. الإعداد الافتراضي هو النص العادي.

المَعلمات

الاسم	Type	الوصف
`mimeType`	`MimeType`	نوع MIME

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

TextOutput - نتيجة النص هذه نفسها، وهي مفيدة للتسلسل