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

Class StringFilterBuilder

أداة إنشاء عناصر التحكّم في فلاتر النصوص

فلتر السلسلة هو حقل إدخال نصي بسيط يتيح للمستخدم فلترة البيانات من خلال مطابقة السلسلة. استنادًا إلى عمود من النوع سلسلة وخياران مطابقة، يفلتر عنصر التحكّم هذا الصفوف التي لا تتطابق مع العبارة الواردة في حقل الإدخال.

لمزيد من التفاصيل، يُرجى الاطّلاع على مستندات Gviz.

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
`setCaseSensitive(caseSensitive)`	`StringFilterBuilder`	لضبط ما إذا كانت المطابقة حسّاسة لحالة الأحرف أم لا.
`setMatchType(matchType)`	`StringFilterBuilder`	لتحديد ما إذا كان يجب أن يتطابق عنصر التحكّم مع القيم الدقيقة فقط (`MatchType.EXACT`) أو البادئات بدءًا من بداية القيمة (`MatchType.PREFIX`) أو أي سلسلة فرعية (`MatchType.ANY`).
`setRealtimeTrigger(realtimeTrigger)`	`StringFilterBuilder`	لتحديد ما إذا كان يجب أن يتطابق عنصر التحكّم في أي وقت يتم فيه الضغط على مفتاح أو فقط عندما "يتغيّر" حقل الإدخال (فقدان التركيز أو الضغط على مفتاح Enter).

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

`setCaseSensitive(caseSensitive)`

لضبط ما إذا كانت المطابقة حسّاسة لحالة الأحرف أم لا.

// Builds a case insensitive string filter to filter column "Col1".
const stringFilter = Charts.newStringFilter()
                         .setFilterColumnLabel('Col1')
                         .setCaseSensitive(false)
                         .build();

المعلمات

الاسم	النوع	الوصف
`caseSensitive`	`Boolean`	إذا كان `true`، يتم تفعيل الحساسية لحالة الأحرف في مطابقة السلسلة.

الإرجاع

‫StringFilterBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

`setMatchType(matchType)`

لتحديد ما إذا كان يجب أن يتطابق عنصر التحكّم مع القيم الدقيقة فقط (MatchType.EXACT) أو البادئات بدءًا من بداية القيمة (MatchType.PREFIX) أو أي سلسلة فرعية (MatchType.ANY).

// Builds a string filter to filter column "Col1" matching the prefix.
const stringFilter = Charts.newStringFilter()
                         .setFilterColumnLabel('Col1')
                         .setMatchType(Charts.MatchType.PREFIX)
                         .build();

المعلمات

الاسم	النوع	الوصف
`matchType`	`MatchType`	نوع مطابقة السلسلة

الإرجاع

‫StringFilterBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.

انظر أيضًا

MatchType

`setRealtimeTrigger(realtimeTrigger)`

لتحديد ما إذا كان يجب أن يتطابق عنصر التحكّم في أي وقت يتم فيه الضغط على مفتاح أو فقط عندما "يتغيّر" حقل الإدخال (فقدان التركيز أو الضغط على مفتاح Enter).

// Builds a string filter to filter column "Col1" that checks the match any time
// a key is pressed.
const stringFilter = Charts.newStringFilter()
                         .setFilterColumnLabel('Col1')
                         .setRealtimeTrigger(true)
                         .build();

المعلمات

الاسم	النوع	الوصف
`realtimeTrigger`	`Boolean`	إذا كانت القيمة `true`، يتم ضبط الأحداث لبدء تشغيلها في الوقت الفعلي (عند الضغط على مفتاح).

الإرجاع

‫StringFilterBuilder — هذا المُنشئ مفيد لإنشاء سلاسل.