روش های مرتبط با رابط کاربری گرافیکی

روش‌های مرتبط با رابط کاربری گرافیکی (GUI) برای نمایش جعبه‌های محاوره‌ای با پیام‌ها، ویرایش اشیاء فرم و محتوای رابط کاربر، دریافت ویژگی‌های زمان اجرا رابط کاربری برنامه و روش‌های در حال اجرا استفاده می‌شوند.


نام	نحو	شرح
Call a method directly	<methodName>()	یک متد را از لیست Methods با استفاده از نام آن فراخوانی کنید، به عنوان مثال، method1() , method2() .
callMethod	callMethod(String name)	روشی جایگزین برای فراخوانی یک متد از لیست Methods. در داخل و در موارد برخورد نام استفاده می شود.
useGraphics	useGraphics(ModelEntity entity, String name) useGraphics(ModelEntity entity, FormObject graphics)	موجودیت داده شده (گروه طرح، هندسه، مش، انتخاب صریح یا انیمیشن پخش) را در شی فرم گرافیکی که با نام، مسیر نام، یا شی فرم گرافیکی در آرگومان دوم داده شده است، رسم می کند.
openForm	openForm(String name)	فرم را با نام داده شده در پنجره اصلی فعلی نشان می دهد. در یک برنامه پنجره واحد، فرم جایگزین فرم فعلی می شود. در یک برنامه با زیر پنجره، فرم باید در طرح بندی پنجره اصلی وجود داشته باشد. در غیر این صورت باز نمی شود. نمایش فرمی که از قبل باز است فقط فرم را فعال می کند.
closeForm	closeForm(String name)	فرم را با نام داده شده می بندد . بستن فرم ها فقط در برنامه های کاربردی با استفاده از پنجره های فرعی امکان پذیر است. این روش برای برنامه های تک پنجره ای قابل اجرا نیست.
closeDialog	closeDialog(String name)	فرم را که به عنوان یک کادر محاوره ای نشان داده شده با نام داده شده می بندد.
dialog	dialog(String name)	فرم را با نام داده شده به عنوان یک کادر محاوره ای نشان می دهد. معادل روش گفتگوی یک شی Form . زیر را ببینید.
alert	alert(String text)	اجرا را متوقف می کند و یک پیام هشدار با متن داده شده نمایش می دهد.
alert	alert(String text, String title)	اجرا را متوقف می کند و یک پیام هشدار با متن و عنوان داده شده نمایش می دهد.
confirm	String confirm(String text)	اجرا را متوقف می کند و کادر محاوره ای تایید را با متن داده شده نمایش می دهد. همچنین دو دکمه “بله” و “خیر” را نمایش می دهد. این روش بسته به چیزی که کاربر روی آن کلیک می کند، «بله» یا «خیر» را برمی گرداند.
confirm	تایید رشته (متن رشته، عنوان رشته)	اجرا را متوقف می کند و کادر محاوره ای تایید را با متن و عنوان داده شده نمایش می دهد. همچنین دو دکمه “بله” و “خیر” را نمایش می دهد. این روش بسته به چیزی که کاربر روی آن کلیک می کند، «بله» یا «خیر» را برمی گرداند.
confirm	تایید رشته (متن رشته، عنوان رشته، رشته بله، رشته نه)	اجرا را متوقف می کند و کادر محاوره ای تایید را با متن و عنوان داده شده نمایش می دهد. همچنین دو دکمه را با رشته های داده شده به عنوان برچسب نمایش می دهد. این روش برچسب دکمه ای را که کاربر روی آن کلیک می کند برمی گرداند.
confirm	تایید رشته (متن رشته، عنوان رشته، رشته بله، رشته خیر، رشته لغو)	اجرا را متوقف می کند و کادر محاوره ای تایید را با متن و عنوان داده شده نمایش می دهد. همچنین سه دکمه را با رشته های داده شده به عنوان برچسب نمایش می دهد. این روش برچسب دکمه ای را که کاربر روی آن کلیک می کند برمی گرداند.
خطا	خطا (پیام رشته ای)	اجرا را متوقف می کند و کادر محاوره ای خطا را با پیام داده شده باز می کند.
خطا	خطا (پیام رشته، علت قابل پرتاب)	اجرا را متوقف می‌کند و یک کادر محاوره‌ای خطا را با پیام داده شده باز می‌کند که شامل علت اصلی کلاس Throwable ، کلاس استثنای عمومی جاوا یا یکی از زیر کلاس‌های آن، مانند RuntimeException است. این می تواند برای “پیچ بندی” پیام های خطای بومی COMSOL Multiphysics با پیام های خطای سفارشی استفاده شود.
درخواست	درخواست رشته (متن رشته)	اجرا را متوقف می‌کند و یک کادر محاوره‌ای با یک فیلد متنی نمایش می‌دهد که از کاربر درخواست ورودی می‌کند. متن داده شده برچسب فیلد متنی است. در صورت کلیک بر روی دکمه لغو، این روش متن وارد شده یا null را برمی گرداند.
درخواست	درخواست رشته (متن رشته، رشته پیش فرض رشته)	اجرا را متوقف می‌کند و یک کادر محاوره‌ای با یک فیلد متنی نمایش می‌دهد که از کاربر درخواست ورودی می‌کند. متن داده شده برچسب فیلد متنی است و رشته پیش فرض متنی است که ابتدا در قسمت متن نشان داده شده است. در صورت کلیک بر روی دکمه لغو، این روش متن وارد شده یا null را برمی گرداند.
درخواست	درخواست رشته (متن رشته، عنوان رشته، رشته پیش فرض رشته)	اجرا را متوقف می‌کند و یک کادر محاوره‌ای با یک فیلد متنی نمایش می‌دهد که از کاربر درخواست ورودی می‌کند. متن داده شده برچسب فیلد متنی است، رشته پیش فرض متنی است که ابتدا در قسمت متن نشان داده شده است و عنوان عنوان کادر محاوره ای است. در صورت کلیک بر روی دکمه لغو، این روش متن وارد شده یا null را برمی گرداند.
پیام	پیام (پیام رشته ای)	در صورت موجود بودن در برنامه، پیامی به گزارش پیام ارسال می کند.
پیام	پیام (arg)	یک پیام arg را به گزارش پیام ارسال می کند. برای یک برنامه، این مستلزم آن است که یک گزارش پیام به رابط کاربری برنامه اضافه شود. آرگومان ورودی arg می تواند یک آرایه اسکالر، یک بعدی یا آرایه دو بعدی از انواع رشته، double، int یا Boolean باشد.
clearLog	clearLog()	پنجره گزارش را پاک می کند.
clearMessageLog	clearMessageLog()	پنجره گزارش پیام را پاک می کند.
ارزیابی به نتایج جدول	ارزیابی ToResultsTable (موجود NumericalFeature، نام رشته، پاک کردن بولی)	موجودیت داده شده، یک مقدار مشتق شده، را در شی جدول با نام، مسیر نام، یا شی فرم گرافیکی در آرگومان دوم ارزیابی می کند، که سپس هدف پیش فرض برای ارزیابی های مقدار مشتق شده خواهد بود. اگر آرگومان سوم درست باشد، جدول قبل از افزودن داده های جدید پاک می شود، در غیر این صورت داده ها ضمیمه می شوند.
ارزیابیToDoubleArray2D	double[][] ارزیابیToDoubleArray2D(موجود ویژگی عددی)	موجودیت داده شده، یک مقدار مشتق شده را ارزیابی می کند و قسمت ستون غیر پارامتری جدول واقعی را که به صورت یک ماتریس دوگانه تولید می شود، برمی گرداند. همه تنظیمات در ویژگی عددی رعایت می شوند، اما تنظیمات موجود در جدول فعلی متصل به ویژگی عددی نادیده گرفته می شوند.
ارزیابیToIntegerArray2D	int[][] ارزیابیToIntegerArray2D(موجود ویژگی عددی)	موجودیت داده شده، یک مقدار مشتق شده را ارزیابی می کند و قسمت ستون غیر پارامتری جدول واقعی را که به عنوان یک ماتریس عدد صحیح تولید می شود، برمی گرداند. همه تنظیمات در ویژگی عددی رعایت می شوند، اما تنظیمات موجود در جدول فعلی متصل به ویژگی عددی نادیده گرفته می شوند.
ارزیابیToStringArray2D	رشته[][] ارزیابیToStringArray2D (موجود ویژگی عددی)	موجودیت داده شده، یک مقدار مشتق شده را ارزیابی می کند و بخش ستون غیر پارامتری جدول بالقوه پیچیده را که به عنوان یک ماتریس رشته ای تولید می شود، برمی گرداند. همه تنظیمات در ویژگی عددی رعایت می شوند، اما تنظیمات موجود در جدول فعلی متصل به ویژگی عددی نادیده گرفته می شوند.
useReultsTable	useResultsTable (TableFeature tableFeature، String resultsTable) useResultsTable (TableFeature tableFeature، FormObject resultsTable)	مقادیر جدول Feature را در شیء فرم resultsTable نشان می دهد.
getChoiceList	ChoiceList getChoiceList (نام رشته)	یک شی از نوع ChoiceList را برمی‌گرداند که نشان‌دهنده یک گره فهرست انتخاب در زیر شاخه اعلامیه‌ها است. نوع ChoiceList دارای روش هایی است که تغییر مقدار ماتریس را با توجه به تغییر و دسترسی به مقادیر و نام های نمایشی به صورت جداگانه آسان تر می کند.
setFormObjectEnabled	setFormObjectEnabled (نام رشته، بولی فعال است)	حالت فعال را برای شی فرم مشخص شده با نام یا مسیر نام تنظیم می کند.
setFormObjectVisible	setFormObjectVisible (نام رشته، بولی قابل مشاهده)	وضعیت قابل مشاهده را برای شی فرم مشخص شده با نام یا مسیر نام تعیین می کند.
setFormObjectText	setFormObjectText (نام رشته، متن رشته)	متن را برای شی فرم مشخص شده با نام یا مسیر نام در آرگومان دوم تنظیم می کند. اگر تنظیم متن برای شی فرم مشخص شده غیرممکن باشد، این روش خطا می دهد.
setFormObjectEditable	setFormObjectEditable (نام رشته، قابل ویرایش بولی)	وضعیت قابل ویرایش را برای شی فرم مشخص شده با نام یا مسیر نام تعیین می کند. این عملکرد فقط برای اشیاء فیلد متنی در دسترس است.
setMenuBarItemEnabled	setMenuBarItemEnabled (نام رشته، بولی فعال است)	حالت فعال را برای آیتم نوار منو که با نام یا مسیر نام (از نوار منو) در آرگومان اول مشخص شده است، تنظیم می کند.
setMainToolbarItemEnabled	setMainToolbarItemEnabled (نام رشته، بولی فعال است)	حالت فعال را برای آیتم نوار ابزار اصلی مشخص شده با نام یا مسیر نام (از نوار ابزار اصلی) در آرگومان اول تنظیم می کند.
setFileMenuItemEnabled	setFileMenuItemEnabled (نام رشته، بولی فعال است)	حالت فعال را برای آیتم منوی فایل مشخص شده با نام یا مسیر نام (از منوی فایل) در اولین آرگومان تنظیم می کند.
setRibbonItemEnabled	setRibbonItemEnabled (نام رشته، بولی فعال است)	حالت فعال را برای آیتم روبان مشخص شده با نام یا مسیر نام (از پنجره اصلی) در آرگومان اول تنظیم می کند.
setToolbarItemEnabled	setToolbarItemEnabled (نام رشته، بولی فعال است)	حالت فعال کردن را برای آیتم شی شکل نوار ابزار که با نام یا مسیر نام در آرگومان اول مشخص شده است، تنظیم می کند.
useView	useView (نمایش، نام رشته) useView (نمایش، گرافیک FormObject)	در آرگومان دوم، نمایی را برای محتویات گرافیکی که با نام، مسیر نام، یا شی فرم گرافیکی ارائه شده است، اعمال می کند.
نمایش تنظیم مجدد	resetView (نام رشته) resetView (گرافیک FormObject)	نمای را به حالت اولیه خود در محتوای گرافیکی که با نام، مسیر نام، یا شی فرم گرافیکی در آرگومان دوم داده شده است، بازنشانی می کند.
getView	ViewBase getView (نام رشته) ViewBase getView (گرافیک FormObject)	نمای استفاده شده در حال حاضر توسط محتویات گرافیکی داده شده با نام، مسیر نام، یا شی فرم گرافیکی در آرگومان دوم را برمی گرداند.
goToView	goToView (نام رشته)؛	در پنجره اصلی گرافیک به نمای استاندارد می رود. نام پارامتر یکی از رشته های جهت جهت نمایش در لیست زیر است: “xy”، “xz”، “yx”، “yz”، “zx”، “zy”.
goToView	goToView (نام رشته، نام گرافیک رشته)؛	به نمای استاندارد در شکل گرافیکی داده شده، شی graphicsname می رود .
goToView	goToView (نام رشته، گرافیک FormObject)؛	به نمای استاندارد در شکل گرافیکی داده شده، گرافیک شیء می رود .
setWebPageSource	setWebPageSource (نام رشته، منبع رشته)	منبع را برای شی فرم مشخص شده با نام یا مسیر نام در آرگومان اول تعیین می کند. اگر نام به یک شیء فرم صفحه وب ارجاع نکند، این روش خطا می دهد.
getScreenHeight	int getScreenHeight()	ارتفاع صفحه اصلی در سیستم مشتری یا پنجره مرورگر را در صورت استفاده از Web Client به پیکسل برمی‌گرداند.
getScreenWidth	int getScreenWidth()	عرض صفحه اصلی در سیستم کلاینت یا پنجره مرورگر را در صورت استفاده از Web Client به پیکسل برمی گرداند.
تغییرات فروشگاه	storeChanges (فرم رشته)	مقادیر وارد شده در یک کادر محاوره ای با فعال بودن On request را متعهد می کند. متد نام فرم را به عنوان آرگومان خود می گیرد.

هشدارها و پیام ها

روش‌ها هشدار ، تأیید و درخواست یک کادر محاوره‌ای با یک رشته متن و ورودی اختیاری کاربر را نمایش می‌دهند. مثال زیر از تایید استفاده می‌کند تا از کاربر بپرسد که آیا یک حل‌کننده مستقیم یا تکراری باید در یک برنامه کاربردی استفاده شود. بر اساس پاسخ، تابع هشدار سپس برای نشان دادن نیاز تخمینی حافظه برای نوع حل کننده انتخاب شده در یک کادر محاوره ای پیام استفاده می شود:

پاسخ رشته = تأیید (“از کدام حل کننده می خواهید استفاده کنید؟”، “انتخاب حل کننده”، “مستقیم”، “تکرار کننده”);

if (answer.equals (“مستقیم”)) {

alert (“استفاده از حل کننده مستقیم به حدود 4 گیگابایت حافظه در هنگام حل نیاز دارد.”);

}دیگر {

alert (“استفاده از حل کننده تکراری به حدود 2 گیگابایت حافظه در هنگام حل نیاز دارد.”);

}

کد مثال

کد زیر زاویه زوم دوربین را تغییر می دهد و گرافیک را برای هر تغییر به روز می کند.

useView(model.view(“view1”)، “/form1/graphics1”);

برای (int i = 0; i < 25; i++) {

خواب (2000);

model.view(“view1”).camera().set(“zoomanglefull”, 12-i*5.0/25);

useGraphics(model.geom(“geom1”)، “/form1/graphics1”);

}

این خط کد گروه نمودار 5 ( pg5 ) را در شیء گرافیکی graphics1 به شکلی با نام دما نمایش می دهد :

useGraphics(model.result(“pg5”)، “/Temperature/graphics1”);

کد زیر مش را در گره درخت مدل mesh1 در شیء گرافیکی graphics1 موجود در کارت پشته کارت نمایش می دهد. خط دوم برای اطمینان از تجسم مناسب مش، دستور بزرگنمایی را اجرا می کند.

useGraphics(model.mesh(“mesh1”)، “/mesh/cardstack1/card1/graphics1”);

zoomExtents(“/mesh/cardstack1/card1/graphics1”);

برای پاک کردن محتویات یک شی گرافیکی از فراخوانی مانند

useGraphics (null، “/form1/graphics1”);

کد زیر یک کادر محاوره ای درخواست را نمایش می دهد که به کاربر اجازه می دهد نام فایل را برای گزارش HTML تایپ کند. اگر کاربر نام فایلی را تایپ کرده باشد، گزارشی ایجاد می شود.

String answerh = درخواست (“نام فایل را وارد کنید”، “نام فایل”، “Untitled.html”);

if (answerh != null) {

model.result().report(“rpt1”).set(“format”,”html”);

model.result().report(“rpt1”).set(“نام فایل”,”user:///”+answerh);

model.result().report(“rpt1”).run();

}

کد زیر مشابه کد بالا است، اما در این مورد گزارش در قالب Microsoft® Word® ذخیره می‌شود ( docx .).

String answerw = request(“نام فایل را وارد کنید”، “نام فایل”، “Untitled.docx”);

if (answerw != null) {

model.result().report(“rpt2”).set(“format”,”docx”);

model.result().report(“rpt2”).set(“نام فایل”,”user:///”+answerw);

model.result().report(“rpt2”).run();

}

این خط کد، نمای شیء گرافیکی form1/graphics1 را به تنظیم می کند ، همانطور که در درخت مدل تعریف شده است:

useView(model.view(“view5”)، “form1/graphics1”);

می‌توانید از در ترکیب با برای ایجاد یک نوار لغزنده یا یک فیلد ورودی استفاده کنید که سطح شفافیت (آلفا) یک گروه نمودار را تعیین می‌کند. شکل زیر پنجره یک نوار لغزنده را با سطح شفافیت به عنوان نشان می دهد.

در این حالت باید روشی برای به روز رسانی نمای ایجاد کنید که برای کنترل یک رویداد از اسلایدر یا شی فرم فراخوانی می شود. در مثال بالا، نوار لغزنده از یک می کند که در قسمت تعریف شده است. این روش حاوی یک خط کد است که نمای را به روز می کند:

useView(getView(“/form1/graphics1”)، “/form1/graphics1”);

توجه داشته باشید که سطوح مختلف شفافیت هنگام دسترسی به برنامه از مرورگر با استفاده از سرور COMSOL پشتیبانی نمی‌شوند.

توجه داشته باشید که شما همچنین می توانید یک نمای از دنباله دستور، به عنوان مثال، یک دکمه تنظیم کنید: یک زیرگره view را در زیر گره در درخت ویرایشگر انتخاب کنید و روی دکمه زیر درخت کلیک کنید.

برای رفتن به یکی از نماهای استاندارد در پنجره اصلی Graphics، به عنوان مثال در یک افزونه، می توانید از موارد زیر استفاده کنید:

goToView (“xy”);

در یک برنامه به طور مشابه می توانید از یکی از موارد زیر استفاده کنید:

goToView(“xz”، “form1/graphics1”);

goToView(“yz”، app.form(“form1”).formObject(“graphics1”));

برای رفتن به شیء گرافیکی graphics1 به شکل form1 .

این خط کد منبع URL شیء فرم webpage1 را به صفحه وب COMSOL تنظیم می کند:

setWebPageSource(“/form1/webpage1″، “https://www.comsol.com”);

این خط کد یک رشته حاوی عرض و ارتفاع صفحه را تشکیل می دهد:

screenSize = toString(getScreenWidth()) + “-by-” + toString(getScreenHeight());

می توانید رشته را با یک فیلد ورودی یا یک شی نمایش داده با استفاده از این رشته به عنوان منبع ارائه کنید (ابتدا باید اندازه صفحه نمایش رشته اعلام شود).

روش های مرتبط با رابط کاربری گرافیکی

شما چه احساسی دارید

اشتراک گذاری این مقاله :