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

Class CardHeader

عنوان Card.

يتوفّر هذا الخيار لإضافات Google Workspace وتطبيقات Google Chat.

var cardHeader = CardService.newCardHeader()
    .setTitle("Card header title")
    .setSubtitle("Card header subtitle")
    .setImageStyle(CardService.ImageStyle.CIRCLE)
    .setImageUrl("https://image.png");

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`setImageAltText(imageAltText)`	`CardHeader`	لضبط النص البديل لصورة العنوان.
`setImageStyle(imageStyle)`	`CardHeader`	لضبط اقتصاص الرمز في عنوان البطاقة
`setImageUrl(imageUrl)`	`CardHeader`	لضبط الصورة لاستخدامها في العنوان من خلال تقديم عنوان URL الخاص بها أو سلسلة البيانات
`setSubtitle(subtitle)`	`CardHeader`	لضبط العنوان الفرعي لرأس البطاقة
`setTitle(title)`	`CardHeader`	لضبط عنوان رأس البطاقة

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

`setImageAltText(imageAltText)`

لضبط النص البديل لصورة العنوان.

المعلمات

الاسم	النوع	الوصف
`imageAltText`	`String`	النص البديل لصورة العنوان.

الإرجاع

CardHeader — هذا العنصر، للتسلسل.

`setImageStyle(imageStyle)`

لضبط اقتصاص الرمز في عنوان البطاقة يتم ضبط الخيار التلقائي على "بدون اقتصاص". اختياريّ.

المعلمات

الاسم	النوع	الوصف
`imageStyle`	`ImageStyle`	إعداد النمط.

الإرجاع

CardHeader — هذا العنصر، للتسلسل.

`setImageUrl(imageUrl)`

لضبط الصورة لاستخدامها في العنوان من خلال تقديم عنوان URL الخاص بها أو سلسلة البيانات

يمكن أن يكون عنوان URL المقدَّم عنوان URL متاحًا للجميع أو سلسلة صورة بترميز base64. للحصول على العلامة الثانية، يمكنك استخدام التعليمة البرمجية التالية لإنشاء سلسلة صورة مشفرة من صورة في Google Drive، ثم تخزين هذه السلسلة لاستخدامها لاحقًا مع setImageUrl(imageUrl). تمنع هذه الطريقة الحاجة إلى وصول الإضافة إلى قائمة عنوان URL للصورة المتاحة:

// The following assumes you have the image to use in Google Drive and have its ID.
var imageBytes = DriveApp.getFileById(imageID).getBlob().getBytes();
var encodedImageURL = "data:image/jpeg;base64," + Utilities.base64Encode(imageBytes);

// You can store encodeImageURL and use it as a parameter to CardHeader.setImageUrl(imageUrl).

المعلمات

الاسم	النوع	الوصف
`imageUrl`	`String`	عنوان URL لصورة مستضافة لاستخدامها، أو سلسلة صورة مشفّرة.

الإرجاع

CardHeader — هذا الكائن يمكن استخدامه في التسلسل.

`setSubtitle(subtitle)`

لضبط العنوان الفرعي لرأس البطاقة اختياريّ.

المعلمات

الاسم	النوع	الوصف
`subtitle`	`String`	نص العنوان الفرعي في العنوان.

الإرجاع

CardHeader — هذا العنصر، للتسلسل.

`setTitle(title)`

لضبط عنوان رأس البطاقة مطلوب.

المعلمات

الاسم	النوع	الوصف
`title`	`String`	نص العنوان.

الإرجاع

CardHeader — هذا العنصر، للتسلسل.