StepChoiceSelection
النماذج، التفاعل
الوصف
يحرك الخيار المحدد لحقل اختيار مرئي وقابل للكتابة بالفارق المطلوب
يقارن قيمة الحقل الحالية بأسماء التصدير وأسماء العرض لكل الخيارات المهيأة، وعندما لا يطابق أي خيار تنطق الدلتا السالبة إلى آخر خيار بينما تختار الدلتا غير السالبة الخيار الأول
يقيد الهدف الناتج داخل قائمة الخيارات وتؤخذ القيمة الجديدة من اسم تصدير الخيار أو اسم عرضه عندما لا يوجد اسم تصدير، والقيمة غير المتغيرة تكتمل دون أي إجراء أو تحرير
/K لعنصر Widget، وتخزن القيمة المؤقتة الجديدة وتنتهي بـ CommitEdit، فيمر /V و/F وOnValueChanged عبر مسار الإتمام الاعتيادي
عندما يُنقض
/K لحقل لم يكن قيد التحرير سلفًا، يُلغى التحرير الحديث البدء من جديد
التصريح
function StepChoiceSelection(FieldIndex, Delta: Integer): Integer;
المعاملات
| FieldIndex | فهرس الحقل أو عنصر Widget المؤقت لحقل اختيار مرئي قابل للكتابة |
|---|---|
| Delta | عدد الخيارات التي ستتحرك، سالبًا للخطوات الخلفية وموجبًا للأمامية |
القيمة المُرجعة
تُرجع 1 عند اكتمال خطوة التحديد أو عندما كانت القيمة مطابقة سلفًا، و0 عندما يكون الحقل غير صالح أو ليس حقل اختيار أو للقراءة فقط أو بلا خيارات أو رفض إجراء مُرسَل أو إتمام التغيير
مثال
// Keyboard path used by DispatchInputEvent for choice fields
Steps := -1; // fikUp moves to the previous option
Handled := Session.StepChoiceSelection(FieldIndex, Steps) = 1;
انظر أيضًا
CommitEdit, SetEditValue, DispatchInputEvent, BeginEdit, OnValueChanged