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

Class TextOutput

عنصر 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)`

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

المعلمات

الاسم	النوع	الوصف
`addedContent`	`String`	المحتوى الذي تريد إلحاقه

الإرجاع

TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل

`clear()`

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

الإرجاع

TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل

`downloadAsFile(filename)`

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

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

المعلمات

الاسم	النوع	الوصف
`filename`	`String`	اسم الملف الذي تريد إبلاغ المتصفّح باستخدامه

الإرجاع

TextOutput - عنصر TextOutput، وهو مفيد لإنشاء سلاسل

عمليات الرمي

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

`getContent()`

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

الإرجاع

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

`getFileName()`

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

الإرجاع

String: اسم الملف

`getMimeType()`

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

الإرجاع

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

`setContent(content)`

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

المعلمات

الاسم	النوع	الوصف
`content`	`String`	المحتوى المطلوب عرضه

الإرجاع

TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل

`setMimeType(mimeType)`

لضبط نوع MIME للمحتوى الذي سيتم عرضه. الإعداد التلقائي هو النص العادي.

المعلمات

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

الإرجاع

TextOutput - عنصر TextOutput نفسه، وهو مفيد لإنشاء سلاسل