فیلد ورودی

فیلد ورودی

فیلد ورودی
فیلد ورودی ( ) یک شی فرم برای وارد کردن متن تک خطی است.
نام شی فیلد ورودی را در قسمت Name وارد کنید .
به طور پیش فرض، چک باکس Editable انتخاب شده است تا کاربران برنامه بتوانند مقدار را در قسمت ورودی تغییر دهند. برای نمایش مقدار اولیه به عنوان یک مقدار فقط خواندنی، کادر قابل ویرایش را پاک کنید.
در قسمت Tooltip ، متنی را وارد کنید که وقتی کاربر نشانگر را روی فیلد ورودی نگه می‌دارد، به‌عنوان راهنمای ابزار ظاهر می‌شود. اشیاء فیلد ورودی همچنین دارای یک راهنمای داخلی هستند که متن وارد شده را در صورتی که در فیلد ورودی قرار نگیرد یا هر خطا یا هشداری را نشان می دهد.
علاوه بر این، پنجره تنظیمات شامل بخش های زیر است.
منبع
در این قسمت منبع داده را برای فیلد ورودی تعریف می کنید. این بخش شامل یک درخت با نمای فیلتر شده درخت در پنجره Application Builder است. گره ها یا نوعی از داده ها را نشان می دهند یا فرزندانی دارند که این کار را انجام می دهند. برای یک فیلد ورودی، پارامترها و متغیرهای مدل COMSOL Multiphysics و متغیرهای اسکالر که در قسمت Declarations تعریف می‌کنید، به عنوان منبع داده در دسترس هستند. شما همچنین می توانید یک جزء مجزا از یک متغیر آرایه را انتخاب کنید. می‌توانید فهرست گره‌های داده موجود را با کلیک کردن روی دکمه Switch to Model Builder و Activate Data Access ( ) در سرصفحه بخش Source ، و سپس انتخاب یک گره در Model Builder گسترش دهید.با داده هایی که می خواهید به آنها دسترسی داشته باشید. با فعال بودن این دکمه، پنجره تنظیمات گره انتخاب شده یک کادر انتخاب منبع داده (مربع سبز رنگ) را در کنار تنظیماتی که می توانید وارد کنید نمایش می دهد. کلیک کنید تا چک باکس را انتخاب کنید تا داده ها به عنوان گره منبع موجود برای فیلدهای ورودی گنجانده شود.
اگر چک باکس Editable پاک شود تا فیلد فقط خواندنی باشد، می توانید یکی از گره های اطلاعاتی زیر را به عنوان منبع استفاده کنید. آنها در زیر گره اصلی مدل و هر گره مطالعه یافت می شوند.
Node Expected Computation Time ( ) در Model>Information ( ) : زمان محاسبه مورد انتظار مقداری است که می توانید در قسمت Expected در پنجره تنظیمات گره ریشه وارد کنید .
The Last Computation Time node ( ) در Model>Information : این گره آخرین زمان محاسبه اندازه گیری شده برای آخرین مطالعه محاسبه شده را نشان می دهد.
گره آخرین زمان محاسبه ( ) تحت هر مدل>مطالعه>اطلاعات : این گره آخرین زمان محاسبه اندازه گیری شده برای مطالعه را نشان می دهد.
هنگامی که یک برنامه را برای اولین بار راه اندازی می کنید، آخرین زمان های اندازه گیری شده بازنشانی می شوند و هنوز در دسترس نیست نمایش داده می شود.
هنگامی که گره ای را انتخاب می کنید که نشان دهنده داده باشد، دکمه Use as Source نوار ابزار ( ) را در زیر درخت فعال می کنید. می‌توانید روی آن کلیک کنید یا، Enter را فشار دهید، دوبار کلیک کنید، یا روی گره راست کلیک کنید و Use as Source را انتخاب کنید تا آن را به عنوان منبع انتخابی اضافه کنید. همچنین می توانید روی دکمه Create ( ) در سربرگ بخش Source کلیک کنید تا یک اعلان متغیر جدید ایجاد کنید و از آن به عنوان منبع استفاده کنید. یک کادر محاوره ای Create and Use Variable باز می شود، به طوری که می توانید نوع داده منبع (در صورت وجود)، نام آن و مقدار اولیه آن (در صورت وجود) را انتخاب کنید. نام نمی تواند با هیچ اعلان متغیر موجود در تضاد باشد. روی دکمه نوار ابزار ویرایش گره کلیک کنید () زیر درخت برای انتقال به گره مربوطه. در صورت لزوم، برنامه به Model Builder سوئیچ می کند.
پس از انتخاب یک گره به عنوان منبع، گره به عنوان منبع انتخاب شده در زیر منبع انتخاب شده ظاهر می شود .
 
اگر سعی کنید از یک منبع داده در چندین شیء استفاده کنید، ممکن است با عوارض جانبی عجیبی روبرو شوید. ارزش منبع ممکن است آن چیزی نباشد که شما انتظار دارید. همچنین اگر مقدار اولیه یک شی فرم برای یکی از اشیاء فرم دیگر نامعتبر باشد، ممکن است با خطاهای جدی مواجه شوید.
از لیست مقدار اولیه ، From data source را انتخاب کنید تا این فیلد ورودی را به منبع داده تعریف شده در قسمت Source پیوند داده و از مقادیر مشخص شده توسط آن منبع استفاده کنید. از منبع داده تنظیم پیش فرض برای فیلدهای ورودی جدید است. مقدار سفارشی را انتخاب کنید تا مقدار اولیه فیلد ورودی را در قسمت Value وارد کنید . این مقدار هر مقداری را که برای آن رشته تعیین کرده اید رونویسی می کند.
اعتبار سنجی داده ها
از تنظیمات این بخش برای اعتبارسنجی ورودی های کاربر با توجه به واحدها و مقادیر استفاده کنید.
از چک لیست ابعاد واحد ، یکی از گزینه های زیر را انتخاب کنید:
هیچ (پیش فرض): هیچ بررسی واحد یا مقدار انجام نمی شود.
سازگار با کمیت فیزیکی : برای اطمینان از سازگاری واحد ورودی با کمیت فیزیکی که با استفاده از فهرست کمیت فیزیکی در زیر چک لیست ابعاد واحد تعیین می‌کنید، بررسی می‌شود . روی دکمه Select Quantity ()تا کادر محاوره ای Physical Quantity باز شود تا کمیت فیزیکی مورد استفاده را جستجو کنید. همچنین می توانید یک رشته جستجو را در قسمت متن در بالای کادر محاوره ای تایپ کنید و سپس روی دکمه فیلتر () کلیک کنید تا لیست مقادیر فیزیکی فیلتر شود. به عنوان مثال، پتانسیل را تایپ کرده و روی Filter کلیک کنیدرا فشار دهید تا فقط کمیت های فیزیکی را فهرست کند که نشان دهنده نوعی پتانسیل است.
اگر مقدار یا عبارتی که کاربر وارد می‌کند ناسازگار باشد، مقدار یا عبارت با رنگ نارنجی به‌عنوان یک هشدار برجسته می‌شود و یک راهنمای ابزار برای توصیف عدم تطابق واحد نمایش داده می‌شود. اگر عدم تطابق واحد وجود داشته باشد، برنامه از مقدار عددی مقدار یا عبارت وارد شده استفاده می‌کند و واحد پیش‌فرض را همانطور که مشخص شده است اضافه می‌کند (به عنوان مثال، اگر مقدار فیزیکی مورد انتظار یک طول باشد، 9[kg] به 9[m] تبدیل می‌شود. .
سازگار با عبارت واحد : بررسی انجام می شود تا اطمینان حاصل شود که واحد ورودی با عبارت واحدی که در قسمت عبارت Unit در زیرلیست بررسی ابعاد واحد مشخص کرده اید سازگار است. در صورت وجود عدم تطابق واحد، کاربر برنامه همان نوع اطلاعات و نحوه رسیدگی را دریافت می کند.
افزودن واحد به عدد : کاربر برنامه می‌تواند با استفاده از دستور واحد با براکت مربع، عددی را بدون اضافه کردن واحد تایپ کند. برنامه عبارت واحدی را که در قسمت عبارت Unit در زیر فهرست بررسی ابعاد واحد مشخص می‌کنید، اضافه می‌کند.
ضمیمه واحد از مجموعه واحد : فیلد ورودی واحدی را ازگره مجموعه واحد اضافه شده در قسمت اعلامیه ها اضافه می کند (به گره مجموعه واحد مراجعه کنید ). شما مجموعه واحدی را برای استفاده از لیست واحد مجموعه و واحد مورد استفاده را از لیست واحد مشخص می‌کنید که تمام ویژگی‌های تعریف‌شده و واحدهای آنها را از تست‌های واحد انتخابی فهرست می‌کند. گزینه بدون واحد نیز وجود دارد.
در صورت امکان، روی دکمه Add Unit Label ( ) کلیک کنید تا یک برچسب واحد مرتبط به فیلد ورودی اضافه شود و آن را در سمت راست فیلد ورودی قرار دهید.
برای گزینه‌های هیچ ، افزودن واحد به عدد ، و افزودن واحد از مجموعه واحد ، همچنین می‌توانید از یک فیلتر برای تأیید اعتبار ورودی عددی استفاده کنید. در بخش اعتبارسنجی عددی ، فیلتری را از لیست فیلتر انتخاب کنید:
هیچ ، فقط برای گزینه None ، جایی که تنظیمات پیش فرض است.
Double (پیش‌فرض برای گزینه Append unit to number )، برای بررسی اینکه مقدار وارد شده یک عدد ممیز شناور است (دو برابر). کادرهای انتخاب کران پایین و کران بالا را انتخاب کنید تا به ترتیب حد پایین و بالایی را در فیلدهای متنی مربوطه مشخص کنید. می توانید تعیین کنید که آیا مقایسه با حد باید بزرگتر یا مساوی (پیش فرض) یا بزرگتر از (برای کران پایین) و کمتر یا مساوی (پیش فرض) یا کمتر از (برای کران بالا) در نوع مقایسه باشد . لیست ها محدودیت‌ها می‌توانند مقادیر عددی، اعلان‌ها یا عبارات، از جمله پارامترهای تعریف‌شده در حالت کلی باشند.پنجره تنظیمات گره پارامترها . با تغییر مقادیر پارامتر، محدودیت ها به صورت پویا تغییر می کنند. ممکن است پس از تغییر در مقدار حداقل یا حداکثر، مقدار یک فیلد ورودی موقتاً نامعتبر شود. اگر پارامتر یا عبارت برای حداقل یا حداکثر مقدار دارای ابعاد یکسانی با واحد وارد شده در قسمت عبارت Unit نباشد ، پارامتر یا عبارت به رنگ زرد ظاهر می‌شود و یک راهنمای ابزار عدم تطابق واحد را توصیف می‌کند. اگر پارامتر یا عبارت دارای همان بعد باشد اما واحد دیگری غیر از واحد وارد شده در قسمت عبارت Unit باشد ، تبدیل واحد به آن واحد رخ می دهد.
عدد صحیح ، برای بررسی اینکه مقدار وارد شده یک عدد صحیح است. چک باکس های کران پایین و کران بالا را انتخاب کنید تا به ترتیب حد پایین و بالایی (به عنوان مقادیر صحیح) را در فیلدهای متنی مربوطه مشخص کنید. در غیر این صورت تنظیمات مشابه تنظیمات Double هستند.
عبارت Regular (فقط برای گزینه None )، برای استفاده از یک عبارت منظم برای مطابقت با رشته ورودی و صدور یک خطای سفارشی. عبارت مورد نظر را در فیلد عبارت منظم و پیام خطا (پیش‌فرض: ورودی نامعتبر ) را در قسمت پیام خطا مشخص کنید.
عبارت منظم شامل الگویی است که با ورودی کاربر مطابقت دارد. این الگو می تواند شامل کاراکترهای معمولی و کاراکترهای خاص باشد. شخصیت های خاص معنای خاصی دارند و خودشان را نشان نمی دهند. کاراکتر ویژه \ برای نقل قول از کاراکترهای خاص استفاده می شود تا آن کاراکترها خودشان را نشان دهند. به عنوان مثال، \\ نشان دهنده یک بک اسلش است. وقتی از \ روی کاراکترهای معمولی استفاده می کنید، معنای خاصی به آنها می دهد. به عنوان مثال، \t به معنای یک کاراکتر تب و \n به معنای یک کاراکتر خط جدید است. شخصیت خاص (نقطه) مخفف هر کاراکتری است. [abc] (کاراکترهای داخل پرانتز) مخفف هر یک از کاراکترهای a است، ب یا ج . [^abc] مخفف هر کاراکتری به جز a ، b یا c است. (abc) (شخصیت های داخل پرانتز) نشان دهنده دنباله کاراکترهای abc است. * (ستاره) به معنای تکرار، شامل صفر بار است. + (به اضافه) به معنای تکرار، حداقل یک بار.
برای توضیح کامل عبارات منظم، به مستندات کلاس java.util.regex در جاوا مراجعه کنید.
چند نمونه:
ac به معنای حرف a است که هر کاراکتری به دنبال آن حرف c می آید .
[^ab]c به معنای هر کاراکتری است به جز a و b و بعد از آن حرف c .
a*b+ به معنای هر عددی از حرف a (شامل صفر رخداد) به دنبال حداقل یک b است.
در فیلد پیام خطا ، پیام خطایی را تایپ کنید که در صورت عدم موفقیت اعتبارسنجی داده ها ظاهر می شود. می توانید متغیرهایی را در پیام خطا بگنجانید که بتواند پویا باشد و شامل مقدار فعلی پارامترها و اعلان ها و همچنین کران پایین و بالایی مشخص شده باشد. به عنوان مثال، در پیغام خطای زیر کران های پایین و بالایی به ترتیب با MINVALUE و MAXVALUE نشان داده می شوند: شعاع باید بزرگتر از eval (MINVALUE) و کمتر از eval (MAXVALUE) باشد.
همچنین امکان دسترسی به مقدار قدیمی و مقدار جدید در متدهایی که از رویدادها فراخوانی می شود وجود دارد تا بتوان از آنها در هنگام نوشتن کد اعتبار سنجی استفاده کرد و هنگام نوشتن کد اعتبار سنجی داده ها در کادرهای محاوره ای که روی یک کپی از داده ها کار می کنند، به مقدار جدید دسترسی پیدا کرد. . برای اطلاعات بیشتر به مقدمه Application Builder مراجعه کنید.
اگر برنامه را با استفاده از Test Application آزمایش کنید و یک پیام خطای اعتبارسنجی داده رخ دهد، پیام خطا حاوی اطلاعات اضافی در مورد نوع شی فرم و مسیر آن است تا به شما کمک کند مبدا پیام خطا را پیدا کنید. اطلاعات اضافی هنگام اجرای برنامه از طریق Run Application یا COMSOL Server ظاهر نمی شود.
موقعیت و اندازه
این بخش شامل تمام تنظیمات طرح بندی برای یک فیلد ورودی در شبکه فرم والد است.
در حالت شبکه، می توانید تراز افقی و عمودی فیلد ورودی را با استفاده از لیست های زیر کنترل کنید:
از لیست تراز افقی ، چپ ، مرکز ، راست یا پر را انتخاب کنید ، که به طور خودکار شی فرم را گسترش می دهد تا سلول را در جهت افقی یا عمودی پر کند (در صورت لزوم).
از لیست تراز عمودی ، میانی ، بالا ، پایین یا پر را انتخاب کنید ، که به طور خودکار شی فرم را برای پر کردن سلول در جهت افقی یا عمودی (در صورت لزوم) گسترش می دهد.
نیاز به تعیین تراز هنگام کار در حالت شبکه آشکارتر است، زیرا نحوه تراز شدن شی فرم در سلول شبکه خود را کنترل می کند. تراز کردن شی فرم می تواند در حالت طرح نیز مفید باشد، و سپس می توانید از ابزارهای تراز در منوی Arrange در بخش Sketch نوار ابزار فرم استفاده کنید. هنگام اجرای برنامه در هر کلاینت دیگری غیر از کلاینت ویندوز، ممکن است اشیاء فرم دقیقاً همانطور که در Application Builder دیده می شود قرار نگیرند. این به این دلیل است که اشیاء فرم ممکن است در سایر کلاینت‌ها اندازه متفاوتی داشته باشند و موقعیت کمی متفاوت به آنها بدهد. تعیین تراز تضمین می کند که اشیاء فرم همانطور که می خواهید در همه کلاینت ها تراز شوند.
همچنین می توانید عرض فیلد ورودی را مشخص کنید. در قسمت Width یک عرض (بر حسب نقطه) وارد کنید . اگر از لیست تراز افقی Fill را انتخاب کرده اید ، می توانید در عوض حداقل عرض را تعیین کنید . برای محاسبه حداقل عرض به صورت خودکار، خودکار را انتخاب کنید (معمولاً این به معنای حداقل اندازه 0 است) یا دستی را انتخاب کنید تا حداقل عرض را در قسمت متن زیر مشخص کنید. فیلد Height در دسترس نیست زیرا ارتفاع فیلد ورودی توسط نرم افزار تعیین می شود.
علاوه بر این، در حالت طرح، می توانید موقعیت مطلق فیلد ورودی را با استفاده از فیلدهای Position x و Position y مشخص کنید. در حالت شبکه، می‌توانید شی را در شبکه قرار دهید و موقعیت شبکه را به‌عنوان مقادیر Row ، Column ، Row span و Column span ببینید.
 
پنجره های فرم این تنظیمات اندازه و موقعیت یابی را از طریق عملیات ترسیمی که در آنجا انجام می شود، مانند تغییر اندازه و جابجایی شی به روز می کنند.
حاشیه سلول
در قسمت حاشیه سلول (فقط در حالت شبکه)، می توانید حاشیه های اطراف شی فرم را کنترل کنید. به طور پیش فرض، حاشیه ها از فرم والد گرفته می شوند. از لیست حاشیه سلول ، انتخاب کنید:
هیچ ، بدون حاشیه در اطراف شی فرم
از فرم والد (پیش فرض)، برای استفاده از حاشیه های تنظیم شده برای فرم والد
سفارشی ، برای تعیین حاشیه برای شی فرم درفیلدهای متنی افقی و عمودی
ظاهر
در این بخش می توانید ظاهر پس زمینه و متن را در قسمت ورودی کنترل کنید:
از لیست رنگ متن ، Inherit (پیش‌فرض) را انتخاب کنید تا رنگ متن را از تنظیمات در گره Form به ارث ببرد ، یا یکی از رنگ‌های از پیش تعریف‌شده، مانند سیاه را انتخاب کنید. برای انتخاب رنگ متن دلخواه از پالت رنگ، Custom را انتخاب کنید.
از لیست رنگ پس‌زمینه ، رنگی را برای استفاده به‌عنوان پس‌زمینه در فیلد ورودی انتخاب کنید: سفید (پیش‌فرض)، شفاف ، هر یک از رنگ‌های اصلی از پیش تعریف‌شده، یا سفارشی ، که امکان انتخاب یک رنگ سفارشی از یک پالت رنگ را فراهم می‌کند. .
از فهرست ترازبندی متن ، یک تراز برای متن در قسمت ورودی انتخاب کنید: چپ ، مرکز ، یا راست .
فونت و اندازه فونت متن به طور پیش فرض از تنظیمات فونت گره Forms استفاده می کند. یک فونت را از لیست فونت انتخاب کنید: فونت پیش‌فرض یا هر یک از فونت‌های موجود. در صورت نیاز، اندازه قلم (به واحد) را در کادر ترکیبی اندازه قلم انتخاب یا وارد کنید. پیش فرض استفاده از اندازه پیش فرض برای فونت است.
برای استفاده از فونت پررنگ ، کادر Bold و برای استفاده از حروف کج (یک فونت ایتالیک) تیک Italic را انتخاب کنید.
در حالت ، می توانید وضعیت اولیه فیلد ورودی را هنگامی که کاربران برنامه را اجرا می کنند، کنترل کنید. به طور پیش فرض، فیلد ورودی قابل مشاهده و فعال است. اگر می‌خواهید حالت اولیه را ایجاد کنید تا فیلد ورودی پنهان یا در دسترس نباشد، کادر بررسی Visible یا Enabled را پاک کنید. سپس می توانید آن را قابل مشاهده کنید یا با استفاده از یک روش آن را فعال کنید. در ویرایشگر فرم، وضعیت شی فرم با تغییر در ظاهر آن نشان داده می شود. اشیایی که پنهان هستند با انتخاب در ویرایشگر فرم قابل مشاهده می شوند.
مناسبت ها
شما می توانید یک متد یا دنباله دستوری را برای اجرا در هنگام وقوع رویدادی مانند ورود داده مشخص کنید. فهرست تغییر داده‌های On شامل None (پیش‌فرض) و هر روش یا ترتیب دستوری موجود است. همچنین می‌توانید یک روش یا ترتیب دستوری را مشخص کنید تا زمانی که یک رویداد زمانی که فیلد ورودی توسط کاربر تمرکز می‌کند، اجرا شود. لیست On Focus به دست آمده شامل None (پیش‌فرض) و هر روش موجود یا دنباله دستور است.
می‌توانید انواع رویدادهای زیر را با انتخاب از منوی Create Global Method ( ) در سمت راست لیست On data change و On focus gained اضافه کنید :
برای ایجاد یک متد جهانی، Create Global Method ( ) را انتخاب کنید. نام متد جهانی را در قسمت نام کادر محاوره ای Create Global Method که باز می شود تایپ کنید و سپس روی OK کلیک کنید . سپس متد جهانی در زیر Methods اضافه می شود و پنجره Method Editor آن باز می شود.
برای ایجاد روش فرم، Create Form Method ( ) را انتخاب کنید. نام روش فرم را در قسمت نام کادر محاوره ای Create Form Method که باز می شود تایپ کنید و سپس روی OK کلیک کنید . سپس متد فرم در زیر گره Methods در زیر گره Form اضافه می شود و پنجره Method Editor آن باز می شود.
برای ایجاد یک متد محلی، Create Local Method ( ) را انتخاب کنید. پنجره ویرایشگر روش آن باز می شود.
برای ایجاد یک توالی دستورات با استفاده از کادر محاوره ای Create Command Sequence که باز می شود، Create Command Sequence ( ) را انتخاب کنید . در آنجا می‌توانید دستورات را از پوشه‌های Forms ، GUI Commands ، Declarations ، Form Declarations ، Methods ، Form Methods ، Libraries و Model انتخاب کنید. برای افزودن یک دستور، روی گره فرمان مورد نظر کلیک راست کرده و دستور مورد استفاده ( Run ) را انتخاب کنید، مثلا). سپس دستور در لیست دستورات زیر ظاهر می شود. شما می توانید دنباله دستورات را با استفاده از دکمه های نوار ابزار برای جابجایی و حذف دستورات زیر جدول ویرایش کنید. روی دکمه Convert to Method ( ) کلیک کنید و Convert to Method یا Convert to Form Method را انتخاب کنید تا دنباله دستور به متد تبدیل شود. روی دکمه Go to Method ( ) در زیر جدول کلیک کنید تا روش را در درخت Application Builder انتخاب کنید و روش را در پنجره Method Editor باز کنید. برای دستوراتی که دارای آرگومان هستند، روی دکمه Edit Argument ( ) کلیک کنید تا در کادر گفتگوی Edit Argument که باز می شود، آرگومان انتخاب شود.
فقط یک روش محلی و یک دنباله دستور وجود دارد، بنابراین اگر یکی یا هر دوی آنها را اضافه کنید، منو به ترتیب حاوی Remove Local Method ( ) و Remove Command Sequence ( ) خواهد بود. روی یکی از آنها کلیک کنید تا متد محلی یا دنباله دستور حذف شود.
روش انتخاب شده در لیست On data change یا On focus gained لیست سپس به روش ایجاد شده یا دنباله دستور تغییر می کند. همچنین می‌توانید روی شی فیلد ورودی Ctrl+Alt کلیک کنید یا روی آن کلیک راست کنید تا یک متد محلی ایجاد کنید یا (با انتخاب روش ویرایش یا ویرایش روش محلی ) برای باز کردن متد مرتبط با دستور. برای باز کردن متد یا دنباله دستور انتخاب شده، روی دکمه Go to Source ( ) کلیک کنید. سپس فوکوس به ترتیب به پنجره ویرایشگر روش یا کادر محاوره‌ای Command Sequence منتقل می‌شود.
برای رویدادهایی که با تغییر داده ایجاد می شوند، رویداد پس از ذخیره مقدار داده جدید در منبع داده فعال می شود.
 
اگر بیش از یک شیء فرم را انتخاب کنید و همه آنها از رویداد On data change یا On focus gained پشتیبانی می کنند، می توانید روشی را مشخص کنید تا مثلاً آنها را به اطلاع کاربران مبنی بر نامعتبر بودن نمودارها و خروجی ها برسانید.