Class TimePicker

TimePicker

حقل إدخال يتيح للمستخدمين إدخال وقت.

متاحة لإضافات Google Workspace وتطبيقات Google Chat.

const dateTimePicker =
    CardService.newTimePicker()
        .setTitle('Enter the time.')
        .setFieldName('time_field')
        // Set default value as 3:30 AM.
        .setHours(3)
        .setMinutes(30)
        .setOnChangeAction(
            CardService.newAction().setFunctionName('handleDateTimeChange'),
        );

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
addEventAction(eventAction)	Widget	تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.
setFieldName(fieldName)	TimePicker	تضبط هذه السمة اسم الحقل الذي يحدّد أداة الاختيار هذه في عنصر الحدث الذي يتم إنشاؤه عند حدوث تفاعل مع واجهة المستخدم.
setHours(hours)	TimePicker	تضبط هذه السمة قيمة الساعات التي تمّ ملؤها مسبقًا والمطلوب ضبطها في حقل الإدخال.
setId(id)	Widget	يضبط هذا الإجراء المعرّف الفريد الذي تمّ تعيينه والذي يُستخدَم لتحديد الأداة التي سيتمّ تغييرها.
setMinutes(minutes)	TimePicker	تضبط هذه السمة قيمة الدقائق التي تمّت تعبئتها مسبقًا والمطلوب ضبطها في حقل الإدخال.
setOnChangeAction(action)	TimePicker	يضبط Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار.
setTitle(title)	TimePicker	تضبط هذه السمة العنوان المعروض أعلى حقل الإدخال.
setVisibility(visibility)	Widget	تضبط هذه السمة مستوى ظهور الأداة.

مستندات تفصيلية

addEventAction(eventAction)

تضيف هذه السمة إجراء الحدث الذي يمكن تنفيذه على التطبيق المصغّر.

المَعلمات

الاسم	النوع	الوصف
eventAction	EventAction	تمثّل هذه السمة EventAction المطلوب إضافتها.

الإرجاع

Widget — العنصر، للتسلسل

---

setFieldName(fieldName)

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

المَعلمات

الاسم	النوع	الوصف
fieldName	String	اسم مصدر الإدخال هذا

الإرجاع

‫TimePicker: أداة الاختيار هذه تُستخدم لربط الفيديوهات ببعضها.

---

setHours(hours)

تضبط هذه السمة قيمة الساعات التي تمّ ملؤها مسبقًا والمطلوب ضبطها في حقل الإدخال.

المَعلمات

الاسم	النوع	الوصف
hours	Integer	قيمة الساعة التلقائية التي يتم وضعها في حقل الإدخال، وتتراوح من 0 إلى 23. ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال الخاصة بالنموذج.

الإرجاع

‫TimePicker: أداة الاختيار هذه تُستخدم لربط الفيديوهات ببعضها.

---

setId(id)

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

المَعلمات

الاسم	النوع	الوصف
id	String	معرّف الأداة، ويمكن أن يتضمّن 64 حرفًا بحدّ أقصى وبالتنسيق `[a-zA-Z0-9-]+`.

الإرجاع

Widget: هذا العنصر، للتسلسل

---

setMinutes(minutes)

تضبط هذه السمة قيمة الدقائق التي تمّت تعبئتها مسبقًا والمطلوب ضبطها في حقل الإدخال.

المَعلمات

الاسم	النوع	الوصف
minutes	Integer	قيمة الدقائق التلقائية التي يتم وضعها في الإدخال، وتتراوح من 0 إلى 59 ويتم تمثيله دائمًا كسلسلة في مَعلمات معاودة الاتصال الخاصة بالنموذج.

الإرجاع

‫TimePicker: أداة الاختيار هذه تُستخدم لربط الفيديوهات ببعضها.

---

setOnChangeAction(action)

يضبط Action ينفّذه النص البرمجي كلما تغيّرت قيمة أداة الاختيار.

المَعلمات

الاسم	النوع	الوصف
action	Action	الإجراء المطلوب اتّخاذه

الإرجاع

‫TimePicker: أداة الاختيار هذه تُستخدم لربط الفيديوهات ببعضها.

---

setTitle(title)

تضبط هذه السمة العنوان المعروض أعلى حقل الإدخال.

المَعلمات

الاسم	النوع	الوصف
title	String	تمثّل هذه السمة عنوان حقل الإدخال.

الإرجاع

‫TimePicker: أداة الاختيار هذه تُستخدم لربط الفيديوهات ببعضها.

---

setVisibility(visibility)

تضبط هذه السمة مستوى ظهور الأداة. القيمة التلقائية هي `VISIBLE`.

المَعلمات

الاسم	النوع	الوصف
visibility	Visibility	Visibility الأداة

الإرجاع

Widget — العنصر، للتسلسل