Class TimePicker

TimePicker

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

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

var 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"));

الطُرق

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

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

setFieldName(fieldName)

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

المعلمات

الاسمالنوعالوصف
fieldNameStringالاسم المراد تعيينه لمدخل الإدخال هذا.

الإرجاع

TimePicker — أداة الاختيار هذه، للسلسلة.


setHours(hours)

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

المعلمات

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

الإرجاع

TimePicker — أداة الاختيار هذه، للسلسلة.


setMinutes(minutes)

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

المعلمات

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

الإرجاع

TimePicker — أداة الاختيار هذه، للسلسلة.


setOnChangeAction(action)

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

المعلمات

الاسمالنوعالوصف
actionActionالإجراء المطلوب اتخاذه.

الإرجاع

TimePicker — أداة الاختيار هذه، للسلسلة.


setTitle(title)

لضبط العنوان المعروض أعلى حقل الإدخال.

المعلمات

الاسمالنوعالوصف
titleStringعنوان حقل الإدخال.

الإرجاع

TimePicker — أداة الاختيار هذه، للسلسلة.