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

Class TextValidationBuilder

أداة DataValidationBuilder لـ TextValidation.

// Add a text item to a form and require it to be a number within a range.
var textItem = form.addTextItem().setTitle('Pick a number between 1 and 100?');
var textValidation = FormApp.createTextValidation()
  .setHelpText('Input was not a number between 1 and 100.')
  .requireNumberBetween(1, 100)
  .build();
textItem.setValidation(textValidation);

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`requireNumber()`	`TextValidationBuilder`	يجب أن يكون العنصر النصي رقمًا.
`requireNumberBetween(start, end)`	`TextValidationBuilder`	يجب أن يكون العنصر النصي رقمًا بين بداية ونهاية، شاملاً.
`requireNumberEqualTo(number)`	`TextValidationBuilder`	يتطلب أن يكون العنصر النصي رقمًا مساويًا للقيمة المحددة.
`requireNumberGreaterThan(number)`	`TextValidationBuilder`	يتطلب أن يكون العنصر النصي رقمًا أكبر من القيمة المحددة.
`requireNumberGreaterThanOrEqualTo(number)`	`TextValidationBuilder`	يتطلب أن يكون العنصر النصي رقمًا أكبر من أو يساوي القيمة المحددة.
`requireNumberLessThan(number)`	`TextValidationBuilder`	يجب أن يكون العنصر النصي رقمًا أقل من القيمة المحدّدة.
`requireNumberLessThanOrEqualTo(number)`	`TextValidationBuilder`	يتطلب أن يكون العنصر النصي رقمًا أقل من أو تساوي القيمة المحدّدة.
`requireNumberNotBetween(start, end)`	`TextValidationBuilder`	يتطلب أن يكون العنصر النصي رقمًا وليس بين البداية والنهاية.
`requireNumberNotEqualTo(number)`	`TextValidationBuilder`	يتطلب أن يكون العنصر النصي رقمًا لا يساوي القيمة المحددة.
`requireTextContainsPattern(pattern)`	`TextValidationBuilder`	يجب الاستجابة لاحتواء النمط.
`requireTextDoesNotContainPattern(pattern)`	`TextValidationBuilder`	يجب الاستجابة لعدم الاحتواء على نمط.
`requireTextDoesNotMatchPattern(pattern)`	`TextValidationBuilder`	يجب الاستجابة لعدم مطابقة النمط.
`requireTextIsEmail()`	`TextValidationBuilder`	يجب أن يكون العنصر النصي عنوان بريد إلكتروني.
`requireTextIsUrl()`	`TextValidationBuilder`	يجب أن يكون العنصر النصي عنوان URL.
`requireTextLengthGreaterThanOrEqualTo(number)`	`TextValidationBuilder`	يجب أن يكون طول الردّ أكبر من القيمة أو مساويًا لها.
`requireTextLengthLessThanOrEqualTo(number)`	`TextValidationBuilder`	يجب أن يكون طول الردّ أقل من القيمة.
`requireTextMatchesPattern(pattern)`	`TextValidationBuilder`	يجب إدخال ردّ لمطابقة النمط.
`requireWholeNumber()`	`TextValidationBuilder`	يجب أن يكون العنصر النصي رقمًا صحيحًا.

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

`requireNumber()`

يجب أن يكون العنصر النصي رقمًا.

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireNumberBetween(start, end)`

يجب أن يكون العنصر النصي رقمًا بين بداية ونهاية، شاملاً.

المعلمات

الاسم	النوع	الوصف
`start`	`Number`	الحدود الدنيا للنطاق الشامل
`end`	`Number`	الحدود العليا للنطاق الشامل

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireNumberEqualTo(number)`

يتطلب أن يكون العنصر النصي رقمًا مساويًا للقيمة المحددة.

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	للقيمة التي يجب أن يكون العنصر مساويًا لها.

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireNumberGreaterThan(number)`

يتطلب أن يكون العنصر النصي رقمًا أكبر من القيمة المحددة.

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	القيمة التي يجب أن يكون العنصر أكبر منها.

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireNumberGreaterThanOrEqualTo(number)`

يتطلب أن يكون العنصر النصي رقمًا أكبر من أو يساوي القيمة المحددة.

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	القيمة التي يجب أن يكون العنصر أكبر من أو تساويها.

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireNumberLessThan(number)`

يجب أن يكون العنصر النصي رقمًا أقل من القيمة المحدّدة.

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	القيمة التي يجب أن يكون العنصر أكبر منها.

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireNumberLessThanOrEqualTo(number)`

يتطلب أن يكون العنصر النصي رقمًا أقل من أو تساوي القيمة المحدّدة.

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	القيمة التي يجب أن يكون العنصر أقل منها أو مساوية لها.

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireNumberNotBetween(start, end)`

يتطلب أن يكون العنصر النصي رقمًا وليس بين البداية والنهاية.

المعلمات

الاسم	النوع	الوصف
`start`	`Number`	الحدود الدنيا للنطاق الشامل
`end`	`Number`	الحدود العليا للنطاق الشامل

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireNumberNotEqualTo(number)`

يتطلب أن يكون العنصر النصي رقمًا لا يساوي القيمة المحددة.

المعلمات

الاسم	النوع	الوصف
`number`	`Number`	القيمة التي ينبغي ألا يكون العنصر مساوية لها.

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireTextContainsPattern(pattern)`

يجب الاستجابة لاحتواء النمط.

المعلمات

الاسم	النوع	الوصف
`pattern`	`String`	يجب أن يحتوي النص على نمط

الإرجاع

TextValidationBuilder: هذا الخيار للسلسلة

`requireTextDoesNotContainPattern(pattern)`

يجب الاستجابة لعدم الاحتواء على نمط.

المعلمات

الاسم	النوع	الوصف
`pattern`	`String`	يجب ألا يحتوي النص على نمط

الإرجاع

TextValidationBuilder: هذا الخيار للسلسلة

`requireTextDoesNotMatchPattern(pattern)`

يجب الاستجابة لعدم مطابقة النمط.

المعلمات

الاسم	النوع	الوصف
`pattern`	`String`	يجب ألا يتطابق النص مع النمط

الإرجاع

TextValidationBuilder: هذا الخيار للسلسلة

`requireTextIsEmail()`

يجب أن يكون العنصر النصي عنوان بريد إلكتروني.

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireTextIsUrl()`

يجب أن يكون العنصر النصي عنوان URL.

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة

`requireTextLengthGreaterThanOrEqualTo(number)`

يجب أن يكون طول الردّ أكبر من القيمة أو مساويًا لها.

المعلمات

الاسم	النوع	الوصف
`number`	`Integer`	يجب أن يكون طول نص الفقرة أكبر من هذه القيمة

الإرجاع

TextValidationBuilder: هذا الخيار للسلسلة

`requireTextLengthLessThanOrEqualTo(number)`

يجب أن يكون طول الردّ أقل من القيمة.

المعلمات

الاسم	النوع	الوصف
`number`	`Integer`	يجب أن يكون طول نص الفقرة أقل من هذه القيمة أو مساويًا لها

الإرجاع

TextValidationBuilder: هذا الخيار للسلسلة

`requireTextMatchesPattern(pattern)`

يجب إدخال ردّ لمطابقة النمط.

المعلمات

الاسم	النوع	الوصف
`pattern`	`String`	يجب أن يتطابق النص مع النمط

الإرجاع

TextValidationBuilder: هذا الخيار للسلسلة

`requireWholeNumber()`

يجب أن يكون العنصر النصي رقمًا صحيحًا.

الإرجاع

TextValidationBuilder — TextValidation هذا، للسلسلة