کلاس AppEvent حاوی اطلاعات مربوط به رویدادهای رابط کاربری برنامه است. فیلد رویداد ، که در متدهای برنامه قابل دسترسی است، با نمونه ای از این کلاس زمانی که یک رویداد FormObject راه اندازی می شود، مقداردهی اولیه می شود. متد getUserControl FormObject را بازیابی می کند که رویداد از آنجا شروع شده است.
|
|
|
|
|
|
|
مقدار جدید مربوط به یک شی فرم دارای نوع رویداد تغییر داده On.
|
|
|
|
مقدار قدیمی مربوط به یک شی فرم دارای نوع رویداد تغییر داده On است.
|
|
|
IPPropertyAccess getUserControl()
|
برای راحت‌تر کردن دسترسی به کنترل کاربر که یک رویداد را راه‌اندازی می‌کند، متد event.getUserControl فرم یا شی فرمی را که رویداد را راه‌اندازی کرده است، برمی‌گرداند. نوع برگشتی متدها IPropertyAccess است و بسته به نوع رویدادی که راه اندازی شده است، می توان شی را به نمونه ای از کلاس FormObject یا Form فرستاد.
|
متدهای getNewValue و getOldValue یک شی از نوع Value را برمی گرداند که دارای متدهایی مطابق جدول زیر است. کلاس Value مقداری را نشان می دهد که بسته به شی فرم می تواند در قالب های مختلف بازیابی شود. برای مثال، رویدادی که از یک فیلد ورودی راه‌اندازی می‌شود، یک متغیر اسکالر است ( بولی ، int ، double یا String ). این بدان معنی است که تنها زیر مجموعه ای از متدهای جدول زیر برای یک رویداد شی فرم خاص معتبر است.
|
|
|
|
|
|
|
مقدار بولی را دریافت می کند.
|
|
|
boolean[] getBooleanArray()
|
مقدار آرایه بولی را دریافت می کند.
|
|
|
boolean[][] getBooleanMatrix()
|
مقدار ماتریس بولی را دریافت می کند.
|
|
|
|
مقدار دو برابر را دریافت می کند.
|
|
|
double[] getDoubleArray()
|
مقدار آرایه دوگانه را دریافت می کند.
|
|
|
double[][] getDoubleMatrix()
|
مقدار ماتریس دوگانه را دریافت می کند.
|
|
|
|
مقدار int را دریافت می کند.
|
|
|
|
مقدار آرایه int را دریافت می کند.
|
|
|
|
مقدار ماتریس int را دریافت می کند.
|
|
|
|
مقدار رشته را دریافت می کند.
|
|
|
String [] getStringArray()
|
مقدار آرایه رشته ای را دریافت می کند.
|
|
|
String [][] getStringMatrix
|
مقدار ماتریس رشته را دریافت می کند.
|
کد زیر نمونه ای از استفاده از فیلد رویداد برای کلاس AppEvent و متدهای getNewValue و getOldValue است :
String value = event.getNewValue().getString();
String oldValue = event.getOldValue().getString();
برای مثالی از استفاده از فیلد رویداد و روش‌های مرتبط با آن، به «تأیید اعتبار داده‌ها» در صفحه 211 مراجعه کنید.
